@farukada/aws-langgraph-dynamodb-ts 0.2.2 → 0.3.1

package/dist/factory/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/factory/factory.ts"],"names":[],"mappings":";;;AAAA,8DAAqF;AACrF,wDAAyD;AAEzD,iDAAsD;AAEtD,0EAA6E;AAG7E,0CAA+C;AAyB/C;;;;GAIG;AACH,MAAa,eAAe;IACG;IAA7B,YAA6B,OAA2B,EAAE;QAA7B,SAAI,GAAJ,IAAI,CAAyB;IAAG,CAAC;IAE9D,WAAW,CAAC,OAA6B;QACvC,OAAO,IAAI,qBAAa,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,WAAW,CAAC,OAA6B;QACvC,OAAO,IAAI,qBAAa,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,wBAAwB,CAAC,OAA0C;QACjE,OAAO,IAAI,iDAA0B,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,SAAS,CAAC,OAAyB;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,gCAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,+BAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,qBAAa,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,IAAI,qBAAa,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,IAAI,iDAA0B,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7F,OAAO;YACL,KAAK;YACL,KAAK;YACL,OAAO;YACP,OAAO,EAAE,GAAG,EAAE;gBACZ,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChB,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChB,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAlCD,0CAkCC"}

package/dist/history/actions/add-messages.d.ts

@@ -1,11 +1,16 @@
+import { type BaseMessage } from '@langchain/core/messages';
+import type { HistoryContext } from '../internal/setup';
 /**
- * Add multiple messages to a session using optimistic concurrency control.
+ * Append messages as one item per message. Each chunk writes its message Puts
+ * and the session-metadata count `ADD` in a single `TransactWriteItems`, so
+ * `messageCount` can never disagree with the stored messages. A creation-anchored
+ * TTL (resolved by read, set in the transaction via `if_not_exists`) gives every
+ * item one shared expiry. Batches larger than the 100-item / 4 MB transaction
+ * limits are split into chunks and applied with caller-observed atomicity: if a
+ * later chunk fails, the committed chunks are rolled back (see {@link appendChunks}).
  *
- * Reads the current messageCount, writes N message items and the updated counter
- * in a single TransactWrite (N ≤ 99, leaving room for the metadata item in the
- * 100-item transaction limit). The metadata update has a conditional check on the
- * observed count; on concurrent modification we re-read and retry.
+ * Per item the 400 KB DynamoDB limit still applies; enable S3 offloading so
+ * large payloads become small descriptors and stay well under the limits.
  */
-import type { AddMessagesActionParams } from '../types';
-export declare const addMessagesAction: (params: AddMessagesActionParams) => Promise<void>;
+export declare function addMessages(context: HistoryContext, sessionId: string, messages: BaseMessage[]): Promise<void>;
 //# sourceMappingURL=add-messages.d.ts.map

package/dist/history/actions/add-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-messages.d.ts","sourceRoot":"","sources":["../../../src/history/actions/add-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAexD,eAAO,MAAM,iBAAiB,GAAU,QAAQ,uBAAuB,KAAG,OAAO,CAAC,IAAI,CAiDrF,CAAC"}
+{"version":3,"file":"add-messages.d.ts","sourceRoot":"","sources":["../../../src/history/actions/add-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,0BAA0B,CAAC;AAQlC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA4BxD;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/history/actions/add-messages.js

@@ -1,54 +1,56 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addMessages = addMessages;
+const messages_1 = require("@langchain/core/messages");
+const clock_1 = require("../../shared/clock");
+const primitives_1 = require("../../shared/validation/primitives");
+const ttl_1 = require("../../shared/validation/ttl");
+const append_saga_1 = require("../internal/append-saga");
+const item_mapper_1 = require("../internal/item-mapper");
+const message_chunker_1 = require("../internal/message-chunker");
+const title_generator_1 = require("../internal/title-generator");
+const ttl_anchor_1 = require("../internal/ttl-anchor");
+/** Message Puts per append transaction: the 100-item limit, less the metadata Update. */
+const MAX_MESSAGES_PER_TRANSACTION = 99;
+/**
+ * Aggregate byte budget per transaction. Held ~500 KB below DynamoDB's 4 MB
+ * `TransactWriteItems` ceiling so the conservative per-item estimate (see
+ * `ITEM_OVERHEAD_BYTES`) cannot push a chunk over the real limit at commit time.
+ */
+const MAX_TRANSACTION_BYTES = 3_500_000;
+async function buildItems(context, sessionId, stored, ttlTimestamp) {
+    const items = [];
+    for (const message of stored) {
+        items.push(await (0, item_mapper_1.buildMessageItem)(context, sessionId, context.ulid(), message, ttlTimestamp));
+    }
+    return items;
+}
 /**
- * Add multiple messages to a session using optimistic concurrency control.
+ * Append messages as one item per message. Each chunk writes its message Puts
+ * and the session-metadata count `ADD` in a single `TransactWriteItems`, so
+ * `messageCount` can never disagree with the stored messages. A creation-anchored
+ * TTL (resolved by read, set in the transaction via `if_not_exists`) gives every
+ * item one shared expiry. Batches larger than the 100-item / 4 MB transaction
+ * limits are split into chunks and applied with caller-observed atomicity: if a
+ * later chunk fails, the committed chunks are rolled back (see {@link appendChunks}).
  *
- * Reads the current messageCount, writes N message items and the updated counter
- * in a single TransactWrite (N ≤ 99, leaving room for the metadata item in the
- * 100-item transaction limit). The metadata update has a conditional check on the
- * observed count; on concurrent modification we re-read and retry.
+ * Per item the 400 KB DynamoDB limit still applies; enable S3 offloading so
+ * large payloads become small descriptors and stay well under the limits.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addMessagesAction = void 0;
-const utils_1 = require("../utils");
-const addMessagesAction = async (params) => {
-    const { client, tableName, userId, sessionId, messages, title, ttlDays, signal } = params;
-    (0, utils_1.validateUserId)(userId);
-    (0, utils_1.validateSessionId)(sessionId);
-    (0, utils_1.validateMessages)(messages);
-    (0, utils_1.validateMessagesSize)(messages);
-    (0, utils_1.validateTitle)(title);
-    (0, utils_1.validateTTLDays)(ttlDays);
-    const sessionTitle = title ?? (0, utils_1.generateTitle)(messages[0]);
-    await (0, utils_1.withOptimisticRetry)(`addMessages:${sessionId}`, async () => {
-        signal?.throwIfAborted();
-        const existing = await (0, utils_1.withDynamoDBRetry)(async () => {
-            return await client.get({
-                TableName: tableName,
-                Key: { userId, sessionId },
-                ConsistentRead: true,
-                ProjectionExpression: 'messageCount',
-            });
-        }, { signal });
-        const expectedCount = existing.Item?.messageCount;
-        const currentCount = expectedCount ?? 0;
-        const newCount = currentCount + messages.length;
-        const messageItems = (0, utils_1.buildMessageItems)(userId, sessionId, messages, currentCount, ttlDays);
-        const { updateExpression, conditionExpression, expressionAttributeValues } = (0, utils_1.buildOptimisticMetadataUpdate)(sessionTitle, newCount, expectedCount, ttlDays);
-        await client.transactWrite({
-            TransactItems: [
-                ...messageItems.map((item) => ({ Put: { TableName: tableName, Item: item } })),
-                {
-                    Update: {
-                        TableName: tableName,
-                        Key: { userId, sessionId },
-                        UpdateExpression: updateExpression,
-                        ConditionExpression: conditionExpression,
-                        ExpressionAttributeValues: expressionAttributeValues,
-                    },
-                },
-            ],
-        });
+async function addMessages(context, sessionId, messages) {
+    (0, primitives_1.validateNonEmptyString)(sessionId, 'sessionId');
+    if (messages.length === 0)
+        return;
+    const stored = (0, messages_1.mapChatMessagesToStoredMessages)(messages);
+    const ttlTimestamp = context.ttl
+        ? await (0, ttl_anchor_1.resolveTtlAnchor)(context, sessionId, (0, ttl_1.calculateTtlTimestamp)(context.ttl))
+        : undefined;
+    const items = await buildItems(context, sessionId, stored, ttlTimestamp);
+    const chunks = (0, message_chunker_1.chunkBySize)(items, MAX_MESSAGES_PER_TRANSACTION, MAX_TRANSACTION_BYTES);
+    await (0, append_saga_1.appendChunks)(context, sessionId, chunks, {
+        now: (0, clock_1.nowIso)(),
+        title: (0, title_generator_1.deriveTitle)(stored),
+        ttlTimestamp,
     });
-};
-exports.addMessagesAction = addMessagesAction;
+}
 //# sourceMappingURL=add-messages.js.map

package/dist/history/actions/add-messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-messages.js","sourceRoot":"","sources":["../../../src/history/actions/add-messages.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAGH,oCAYkB;AAEX,MAAM,iBAAiB,GAAG,KAAK,EAAE,MAA+B,EAAiB,EAAE;IACxF,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE1F,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IAC7B,IAAA,wBAAgB,EAAC,QAAQ,CAAC,CAAC;IAC3B,IAAA,4BAAoB,EAAC,QAAQ,CAAC,CAAC;IAC/B,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC;IACrB,IAAA,uBAAe,EAAC,OAAO,CAAC,CAAC;IAEzB,MAAM,YAAY,GAAG,KAAK,IAAI,IAAA,qBAAa,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzD,MAAM,IAAA,2BAAmB,EAAC,eAAe,SAAS,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAA,yBAAiB,EACtC,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC;gBACtB,SAAS,EAAE,SAAS;gBACpB,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;gBAC1B,cAAc,EAAE,IAAI;gBACpB,oBAAoB,EAAE,cAAc;aACrC,CAAC,CAAC;QACL,CAAC,EACD,EAAE,MAAM,EAAE,CACX,CAAC;QAEF,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,EAAE,YAAkC,CAAC;QACxE,MAAM,YAAY,GAAG,aAAa,IAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;QAEhD,MAAM,YAAY,GAAG,IAAA,yBAAiB,EAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAC3F,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,GACxE,IAAA,qCAA6B,EAAC,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QAEhF,MAAM,MAAM,CAAC,aAAa,CAAC;YACzB,aAAa,EAAE;gBACb,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9E;oBACE,MAAM,EAAE;wBACN,SAAS,EAAE,SAAS;wBACpB,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;wBAC1B,gBAAgB,EAAE,gBAAgB;wBAClC,mBAAmB,EAAE,mBAAmB;wBACxC,yBAAyB,EAAE,yBAAyB;qBACrD;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAjDW,QAAA,iBAAiB,qBAiD5B"}
+{"version":3,"file":"add-messages.js","sourceRoot":"","sources":["../../../src/history/actions/add-messages.ts"],"names":[],"mappings":";;AAoDA,kCAkBC;AAtED,uDAIkC;AAElC,8CAA4C;AAC5C,mEAA4E;AAC5E,qDAAoE;AACpE,yDAAuD;AACvD,yDAA2D;AAC3D,iEAA0D;AAE1D,iEAA0D;AAC1D,uDAA0D;AAG1D,yFAAyF;AACzF,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAExC;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,SAAS,CAAC;AAExC,KAAK,UAAU,UAAU,CACvB,OAAuB,EACvB,SAAiB,EACjB,MAAuB,EACvB,YAAqB;IAErB,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,MAAM,IAAA,8BAAgB,EAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,WAAW,CAC/B,OAAuB,EACvB,SAAiB,EACjB,QAAuB;IAEvB,IAAA,mCAAsB,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAClC,MAAM,MAAM,GAAG,IAAA,0CAA+B,EAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG;QAC9B,CAAC,CAAC,MAAM,IAAA,6BAAgB,EAAC,OAAO,EAAE,SAAS,EAAE,IAAA,2BAAqB,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChF,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,IAAA,6BAAW,EAAC,KAAK,EAAE,4BAA4B,EAAE,qBAAqB,CAAC,CAAC;IACvF,MAAM,IAAA,0BAAY,EAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE;QAC7C,GAAG,EAAE,IAAA,cAAM,GAAE;QACb,KAAK,EAAE,IAAA,6BAAW,EAAC,MAAM,CAAC;QAC1B,YAAY;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/history/actions/clear.d.ts

@@ -1,14 +1,8 @@
+import type { HistoryContext } from '../internal/setup';
 /**
- * Clear all messages and metadata for a session
- * Deletes both the metadata item and all individual message items
+ * Delete a whole session: every message item plus the metadata item, removed in
+ * one batched write. Any offloaded S3 objects for those messages are then
+ * best-effort cleaned up.
  */
-import type { ClearActionParams } from '../types';
-/**
- * Clear all messages in a session by deleting all items (metadata + messages)
- * Queries all items with the session prefix, then batch-deletes them
- *
- * @param params - Parameters for the clear operation
- * @throws Error if the operation fails or validation fails
- */
-export declare const clearAction: (params: ClearActionParams) => Promise<void>;
+export declare function clearSession(context: HistoryContext, sessionId: string): Promise<void>;
 //# sourceMappingURL=clear.d.ts.map

package/dist/history/actions/clear.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../../src/history/actions/clear.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGlD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAU,QAAQ,iBAAiB,KAAG,OAAO,CAAC,IAAI,CA+DzE,CAAC"}
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../../src/history/actions/clear.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5F"}

package/dist/history/actions/clear.js

@@ -1,67 +1,33 @@
 "use strict";
-/**
- * Clear all messages and metadata for a session
- * Deletes both the metadata item and all individual message items
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.clearAction = void 0;
-const shared_1 = require("../../shared");
-const utils_1 = require("../utils");
+exports.clearSession = clearSession;
+const descriptor_keys_1 = require("../../shared/codec/descriptor-keys");
+const orphans_1 = require("../../shared/codec/s3/orphans");
+const batch_write_1 = require("../../shared/dynamodb/batch-write");
+const paginate_1 = require("../../shared/dynamodb/paginate");
+const query_1 = require("../internal/query");
 /**
- * Clear all messages in a session by deleting all items (metadata + messages)
- * Queries all items with the session prefix, then batch-deletes them
- *
- * @param params - Parameters for the clear operation
- * @throws Error if the operation fails or validation fails
+ * Delete a whole session: every message item plus the metadata item, removed in
+ * one batched write. Any offloaded S3 objects for those messages are then
+ * best-effort cleaned up.
  */
-const clearAction = async (params) => {
-    const { client, tableName, userId, sessionId, signal } = params;
-    // Validate inputs
-    (0, utils_1.validateUserId)(userId);
-    (0, utils_1.validateSessionId)(sessionId);
-    // Collect all item keys to delete: metadata item + all message items
-    const keysToDelete = [];
-    // Add the metadata item key
-    keysToDelete.push({ userId, sessionId });
-    // Query all message items by SK prefix
-    const messagePrefix = `${sessionId}#msg#`;
-    let lastEvaluatedKey;
-    let iterationCount = 0;
-    do {
-        // Prevent infinite loops
-        iterationCount++;
-        if (iterationCount > shared_1.MAX_LOOP_ITERATIONS) {
-            throw new Error('Clear operation exceeded maximum iteration limit');
-        }
-        const result = await (0, utils_1.withDynamoDBRetry)(async () => {
-            return await client.query({
-                TableName: tableName,
-                KeyConditionExpression: 'userId = :userId AND begins_with(sessionId, :prefix)',
-                ExpressionAttributeValues: {
-                    ':userId': userId,
-                    ':prefix': messagePrefix,
-                },
-                ProjectionExpression: 'userId, sessionId',
-                ExclusiveStartKey: lastEvaluatedKey,
-            });
-        }, { signal });
-        if (result.Items && result.Items.length > 0) {
-            // Prevent memory exhaustion
-            if (keysToDelete.length + result.Items.length > shared_1.MAX_TOTAL_ITEMS_IN_MEMORY) {
-                throw new Error('Clear operation exceeded maximum items in memory limit');
-            }
-            keysToDelete.push(...result.Items.map((item) => ({
-                userId: item.userId,
-                sessionId: item.sessionId,
-            })));
-        }
-        lastEvaluatedKey = result.LastEvaluatedKey;
-    } while (lastEvaluatedKey);
-    // Batch delete all items (metadata + messages) using shared utility
-    const deleteRequests = keysToDelete.map((key) => ({
-        DeleteRequest: { Key: key },
-    }));
-    await (0, shared_1.batchWriteAllWithRetry)(client, tableName, deleteRequests, { signal });
-};
-exports.clearAction = clearAction;
+async function clearSession(context, sessionId) {
+    const deletes = [];
+    const descriptors = [];
+    for await (const raw of (0, paginate_1.paginateQuery)({
+        client: context.client,
+        params: (0, query_1.sessionItemsQuery)(context.tableName, sessionId),
+    })) {
+        const item = raw;
+        deletes.push({ DeleteRequest: { Key: { PK: item.PK, SK: item.SK } } });
+        if (item.message)
+            descriptors.push(item.message);
+    }
+    if (deletes.length === 0)
+        return;
+    await (0, batch_write_1.batchWriteAll)(context.client, context.tableName, deletes);
+    if (context.offloader) {
+        await (0, orphans_1.cleanUpS3Orphans)(context.offloader, (0, descriptor_keys_1.collectS3Keys)(descriptors), 'history.clear', context.logger);
+    }
+}
 //# sourceMappingURL=clear.js.map

package/dist/history/actions/clear.js.map

@@ -1 +1 @@
-{"version":3,"file":"clear.js","sourceRoot":"","sources":["../../../src/history/actions/clear.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAIsB;AAEtB,oCAAgF;AAEhF;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,KAAK,EAAE,MAAyB,EAAiB,EAAE;IAC5E,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEhE,kBAAkB;IAClB,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IAE7B,qEAAqE;IACrE,MAAM,YAAY,GAAiD,EAAE,CAAC;IAEtE,4BAA4B;IAC5B,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAEzC,uCAAuC;IACvC,MAAM,aAAa,GAAG,GAAG,SAAS,OAAO,CAAC;IAC1C,IAAI,gBAAiD,CAAC;IACtD,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,GAAG,CAAC;QACF,yBAAyB;QACzB,cAAc,EAAE,CAAC;QACjB,IAAI,cAAc,GAAG,4BAAmB,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EACpC,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC;gBACxB,SAAS,EAAE,SAAS;gBACpB,sBAAsB,EAAE,sDAAsD;gBAC9E,yBAAyB,EAAE;oBACzB,SAAS,EAAE,MAAM;oBACjB,SAAS,EAAE,aAAa;iBACzB;gBACD,oBAAoB,EAAE,mBAAmB;gBACzC,iBAAiB,EAAE,gBAAgB;aACpC,CAAC,CAAC;QACL,CAAC,EACD,EAAE,MAAM,EAAE,CACX,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,4BAA4B;YAC5B,IAAI,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,kCAAyB,EAAE,CAAC;gBAC1E,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAC5E,CAAC;YACD,YAAY,CAAC,IAAI,CACf,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC7B,MAAM,EAAE,IAAI,CAAC,MAAgB;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAmB;aACpC,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC;QAED,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAC7C,CAAC,QAAQ,gBAAgB,EAAE;IAE3B,oEAAoE;IACpE,MAAM,cAAc,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChD,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;KAC5B,CAAC,CAAC,CAAC;IAEJ,MAAM,IAAA,+BAAsB,EAAC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAC9E,CAAC,CAAC;AA/DW,QAAA,WAAW,eA+DtB"}
+{"version":3,"file":"clear.js","sourceRoot":"","sources":["../../../src/history/actions/clear.ts"],"names":[],"mappings":";;AAeA,oCAqBC;AAnCD,wEAAmE;AACnE,2DAAiE;AACjE,mEAAkE;AAClE,6DAA+D;AAE/D,6CAAsD;AAItD;;;;GAIG;AACI,KAAK,UAAU,YAAY,CAAC,OAAuB,EAAE,SAAiB;IAC3E,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,MAAM,WAAW,GAAwB,EAAE,CAAC;IAC5C,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAA,wBAAa,EAAC;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,IAAA,yBAAiB,EAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;KACxD,CAAC,EAAE,CAAC;QACH,MAAM,IAAI,GAAG,GAAsB,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,OAAO;YAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACjC,MAAM,IAAA,2BAAa,EAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAA,0BAAgB,EACpB,OAAO,CAAC,SAAS,EACjB,IAAA,+BAAa,EAAC,WAAW,CAAC,EAC1B,eAAe,EACf,OAAO,CAAC,MAAM,CACf,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/history/actions/get-messages.d.ts

@@ -1,16 +1,9 @@
+import { type BaseMessage } from '@langchain/core/messages';
+import type { HistoryContext } from '../internal/setup';
 /**
- * Get all messages for a session
- * Queries individual message items and deserializes to BaseMessage instances
+ * Return a session's messages in chronological order. Items past their TTL are
+ * filtered out on read (DynamoDB's background TTL sweep can lag by up to 48h),
+ * so the returned history is never stale.
  */
-import { BaseMessage } from '@langchain/core/messages';
-import type { GetMessagesActionParams } from '../types';
-/**
- * Get all messages for a session from DynamoDB
- * Queries message items by SK prefix and deserializes to proper BaseMessage instances
- *
- * @param params - Parameters for the get messages operation
- * @returns Array of BaseMessage objects in chronological order
- * @throws Error if the operation fails or validation fails
- */
-export declare const getMessagesAction: (params: GetMessagesActionParams) => Promise<BaseMessage[]>;
+export declare function getMessages(context: HistoryContext, sessionId: string): Promise<BaseMessage[]>;
 //# sourceMappingURL=get-messages.d.ts.map

package/dist/history/actions/get-messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-messages.d.ts","sourceRoot":"","sources":["../../../src/history/actions/get-messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAmC,MAAM,0BAA0B,CAAC;AAGxF,OAAO,KAAK,EAAE,uBAAuB,EAAuB,MAAM,UAAU,CAAC;AAG7E;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,WAAW,EAAE,CAyDvB,CAAC"}
+{"version":3,"file":"get-messages.d.ts","sourceRoot":"","sources":["../../../src/history/actions/get-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAYxB"}

package/dist/history/actions/get-messages.js

@@ -1,66 +1,30 @@
 "use strict";
-/**
- * Get all messages for a session
- * Queries individual message items and deserializes to BaseMessage instances
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMessagesAction = void 0;
+exports.getMessages = getMessages;
 const messages_1 = require("@langchain/core/messages");
-const shared_1 = require("../../shared");
-const utils_1 = require("../utils");
+const paginate_1 = require("../../shared/dynamodb/paginate");
+const item_mapper_1 = require("../internal/item-mapper");
+const query_1 = require("../internal/query");
+function isExpired(item, nowSeconds) {
+    return item.ttl !== undefined && item.ttl <= nowSeconds;
+}
 /**
- * Get all messages for a session from DynamoDB
- * Queries message items by SK prefix and deserializes to proper BaseMessage instances
- *
- * @param params - Parameters for the get messages operation
- * @returns Array of BaseMessage objects in chronological order
- * @throws Error if the operation fails or validation fails
+ * Return a session's messages in chronological order. Items past their TTL are
+ * filtered out on read (DynamoDB's background TTL sweep can lag by up to 48h),
+ * so the returned history is never stale.
  */
-const getMessagesAction = async (params) => {
-    const { client, tableName, userId, sessionId, signal } = params;
-    // Validate inputs
-    (0, utils_1.validateUserId)(userId);
-    (0, utils_1.validateSessionId)(sessionId);
-    // Query all message items for the session using SK prefix
-    const messagePrefix = `${sessionId}#msg#`;
-    const messages = [];
-    let lastEvaluatedKey;
-    let iterationCount = 0;
-    do {
-        // Prevent infinite loops
-        iterationCount++;
-        if (iterationCount > shared_1.MAX_LOOP_ITERATIONS) {
-            throw new Error('getMessages operation exceeded maximum iteration limit');
-        }
-        const result = await (0, utils_1.withDynamoDBRetry)(async () => {
-            return await client.query({
-                TableName: tableName,
-                KeyConditionExpression: 'userId = :userId AND begins_with(sessionId, :prefix)',
-                ExpressionAttributeValues: {
-                    ':userId': userId,
-                    ':prefix': messagePrefix,
-                },
-                ExclusiveStartKey: lastEvaluatedKey,
-            });
-        }, { signal });
-        if (result.Items && result.Items.length > 0) {
-            // Prevent memory exhaustion
-            if (messages.length + result.Items.length > shared_1.MAX_TOTAL_ITEMS_IN_MEMORY) {
-                throw new Error('getMessages operation exceeded maximum items in memory limit');
-            }
-            messages.push(...result.Items);
-        }
-        lastEvaluatedKey = result.LastEvaluatedKey;
-    } while (lastEvaluatedKey);
-    // Return empty array if no messages found
-    if (messages.length === 0) {
-        return [];
+async function getMessages(context, sessionId) {
+    const nowSeconds = Math.floor(Date.now() / 1000);
+    const stored = [];
+    for await (const raw of (0, paginate_1.paginateQuery)({
+        client: context.client,
+        params: (0, query_1.messageQuery)(context.tableName, sessionId),
+    })) {
+        const item = raw;
+        if (isExpired(item, nowSeconds))
+            continue;
+        stored.push(await (0, item_mapper_1.decodeMessageItem)(context, item));
     }
-    // Sort by messageIndex to ensure chronological order
-    messages.sort((a, b) => a.messageIndex - b.messageIndex);
-    // Deserialize StoredMessage objects to proper BaseMessage instances
-    const storedMessages = messages.map((item) => item.message);
-    return (0, messages_1.mapStoredMessagesToChatMessages)(storedMessages);
-};
-exports.getMessagesAction = getMessagesAction;
+    return (0, messages_1.mapStoredMessagesToChatMessages)(stored);
+}
 //# sourceMappingURL=get-messages.js.map

package/dist/history/actions/get-messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-messages.js","sourceRoot":"","sources":["../../../src/history/actions/get-messages.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,uDAAwF;AAExF,yCAA8E;AAE9E,oCAAgF;AAEhF;;;;;;;GAOG;AACI,MAAM,iBAAiB,GAAG,KAAK,EACpC,MAA+B,EACP,EAAE;IAC1B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEhE,kBAAkB;IAClB,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IAE7B,0DAA0D;IAC1D,MAAM,aAAa,GAAG,GAAG,SAAS,OAAO,CAAC;IAC1C,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,IAAI,gBAAiD,CAAC;IACtD,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,GAAG,CAAC;QACF,yBAAyB;QACzB,cAAc,EAAE,CAAC;QACjB,IAAI,cAAc,GAAG,4BAAmB,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EACpC,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC;gBACxB,SAAS,EAAE,SAAS;gBACpB,sBAAsB,EAAE,sDAAsD;gBAC9E,yBAAyB,EAAE;oBACzB,SAAS,EAAE,MAAM;oBACjB,SAAS,EAAE,aAAa;iBACzB;gBACD,iBAAiB,EAAE,gBAAgB;aACpC,CAAC,CAAC;QACL,CAAC,EACD,EAAE,MAAM,EAAE,CACX,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,4BAA4B;YAC5B,IAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,kCAAyB,EAAE,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAClF,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,GAAI,MAAM,CAAC,KAA+B,CAAC,CAAC;QAC5D,CAAC;QAED,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAC7C,CAAC,QAAQ,gBAAgB,EAAE;IAE3B,0CAA0C;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAEzD,oEAAoE;IACpE,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,OAAO,IAAA,0CAA+B,EAAC,cAAc,CAAC,CAAC;AACzD,CAAC,CAAC;AA3DW,QAAA,iBAAiB,qBA2D5B"}
+{"version":3,"file":"get-messages.js","sourceRoot":"","sources":["../../../src/history/actions/get-messages.ts"],"names":[],"mappings":";;AAqBA,kCAeC;AApCD,uDAIkC;AAElC,6DAA+D;AAC/D,yDAA4D;AAC5D,6CAAiD;AAIjD,SAAS,SAAS,CAAC,IAAqB,EAAE,UAAkB;IAC1D,OAAO,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,WAAW,CAC/B,OAAuB,EACvB,SAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAA,wBAAa,EAAC;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,IAAA,oBAAY,EAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;KACnD,CAAC,EAAE,CAAC;QACH,MAAM,IAAI,GAAG,GAAsB,CAAC;QACpC,IAAI,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC;YAAE,SAAS;QAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,IAAA,+BAAiB,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAA,0CAA+B,EAAC,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/history/actions/list-sessions.d.ts

@@ -1,25 +1,9 @@
+import type { HistoryContext } from '../internal/setup';
+import type { SessionMetadata } from '../types';
 /**
- * List all sessions for a user
+ * List all sessions as metadata summaries, newest-updated first. The scan is
+ * filtered to session items so the adapter works on a table shared with the
+ * checkpointer/store; foreign rows are also skipped defensively.
  */
-import type { ListSessionsActionParams, SessionMetadata } from '../types';
-/**
- * List all sessions for a user, sorted by most recent
- * Uses projection expression to exclude messages for performance
- *
- * @remarks
- * **Performance note:** This action loads all metadata items for a user into memory
- * and sorts client-side by `updatedAt`. DynamoDB sorts by SK (sessionId), so server-side
- * sorted pagination is not possible with the current schema.
- *
- * For users with thousands of sessions, consider adding a GSI on `userId + updatedAt`
- * to enable server-side sorting with DynamoDB `Limit` and `ScanIndexForward`.
- *
- * A safety limit of {@link MAX_TOTAL_ITEMS_IN_MEMORY} is applied to prevent
- * unbounded memory growth.
- *
- * @param params - Parameters for the list sessions operation
- * @returns Array of session metadata, sorted by most recent first
- * @throws Error if the operation fails or validation fails
- */
-export declare const listSessionsAction: (params: ListSessionsActionParams) => Promise<SessionMetadata[]>;
+export declare function listSessions(context: HistoryContext): Promise<SessionMetadata[]>;
 //# sourceMappingURL=list-sessions.d.ts.map

package/dist/history/actions/list-sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-sessions.d.ts","sourceRoot":"","sources":["../../../src/history/actions/list-sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,wBAAwB,KAC/B,OAAO,CAAC,eAAe,EAAE,CAgE3B,CAAC"}
+{"version":3,"file":"list-sessions.d.ts","sourceRoot":"","sources":["../../../src/history/actions/list-sessions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,UAAU,CAAC;AAEjE;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAuBtF"}

package/dist/history/actions/list-sessions.js

@@ -1,79 +1,36 @@
 "use strict";
-/**
- * List all sessions for a user
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listSessionsAction = void 0;
-const shared_1 = require("../../shared");
-const utils_1 = require("../utils");
+exports.listSessions = listSessions;
+const scan_1 = require("../../shared/dynamodb/scan");
+const keys_1 = require("../internal/keys");
 /**
- * List all sessions for a user, sorted by most recent
- * Uses projection expression to exclude messages for performance
- *
- * @remarks
- * **Performance note:** This action loads all metadata items for a user into memory
- * and sorts client-side by `updatedAt`. DynamoDB sorts by SK (sessionId), so server-side
- * sorted pagination is not possible with the current schema.
- *
- * For users with thousands of sessions, consider adding a GSI on `userId + updatedAt`
- * to enable server-side sorting with DynamoDB `Limit` and `ScanIndexForward`.
- *
- * A safety limit of {@link MAX_TOTAL_ITEMS_IN_MEMORY} is applied to prevent
- * unbounded memory growth.
- *
- * @param params - Parameters for the list sessions operation
- * @returns Array of session metadata, sorted by most recent first
- * @throws Error if the operation fails or validation fails
+ * List all sessions as metadata summaries, newest-updated first. The scan is
+ * filtered to session items so the adapter works on a table shared with the
+ * checkpointer/store; foreign rows are also skipped defensively.
  */
-const listSessionsAction = async (params) => {
-    const { client, tableName, userId, limit, signal } = params;
-    // Validate inputs
-    (0, utils_1.validateUserId)(userId);
-    (0, utils_1.validateLimit)(limit);
+async function listSessions(context) {
     const sessions = [];
-    let lastEvaluatedKey;
-    // Paginate through all results - must fetch ALL sessions before sorting
-    // DynamoDB sorts by SK (sessionId), not updatedAt, so we cannot rely on
-    // DynamoDB's Limit to return the most recent sessions
-    do {
-        const result = await (0, utils_1.withDynamoDBRetry)(async () => {
-            return await client.query({
-                TableName: tableName,
-                KeyConditionExpression: 'userId = :userId',
-                FilterExpression: 'itemType = :metadata',
-                ExpressionAttributeValues: {
-                    ':userId': userId,
-                    ':metadata': 'metadata',
-                },
-                ProjectionExpression: 'sessionId, title, createdAt, updatedAt, messageCount',
-                ExclusiveStartKey: lastEvaluatedKey,
-            });
-        }, { signal });
-        if (!result.Items || result.Items.length === 0) {
-            break;
-        }
-        // Map items to SessionMetadata
-        const mappedSessions = result.Items.map((item) => ({
+    for await (const raw of (0, scan_1.paginateScan)({
+        client: context.client,
+        params: {
+            TableName: context.tableName,
+            FilterExpression: '#sk = :session',
+            ExpressionAttributeNames: { '#sk': 'SK' },
+            ExpressionAttributeValues: { ':session': keys_1.SESSION_SORT_KEY },
+        },
+    })) {
+        const item = raw;
+        if (item.SK !== keys_1.SESSION_SORT_KEY || typeof item.sessionId !== 'string')
+            continue;
+        sessions.push({
             sessionId: item.sessionId,
             title: item.title,
+            messageCount: item.messageCount,
             createdAt: item.createdAt,
             updatedAt: item.updatedAt,
-            messageCount: item.messageCount,
-        }));
-        sessions.push(...mappedSessions);
-        // Safety limit: prevent unbounded memory growth. Users near this bound should
-        // add a (userId, updatedAt) GSI — see method JSDoc.
-        if (sessions.length >= shared_1.MAX_TOTAL_ITEMS_IN_MEMORY) {
-            (0, shared_1.getLogger)().warn(`listSessions truncated at ${shared_1.MAX_TOTAL_ITEMS_IN_MEMORY} items for userId="${userId}"; ` +
-                `older sessions are not returned. Add a GSI on (userId, updatedAt) for full coverage.`);
-            break;
-        }
-        lastEvaluatedKey = result.LastEvaluatedKey;
-    } while (lastEvaluatedKey);
-    // Sort by most recent first (updatedAt DESC)
-    sessions.sort((a, b) => b.updatedAt - a.updatedAt);
-    // Enforce limit on final result
-    return limit ? sessions.slice(0, limit) : sessions;
-};
-exports.listSessionsAction = listSessionsAction;
+        });
+    }
+    sessions.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    return sessions;
+}
 //# sourceMappingURL=list-sessions.js.map

package/dist/history/actions/list-sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-sessions.js","sourceRoot":"","sources":["../../../src/history/actions/list-sessions.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAAoE;AAEpE,oCAA4E;AAE5E;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,kBAAkB,GAAG,KAAK,EACrC,MAAgC,EACJ,EAAE;IAC9B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE5D,kBAAkB;IAClB,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACvB,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC;IAErB,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,gBAAiD,CAAC;IAEtD,wEAAwE;IACxE,wEAAwE;IACxE,sDAAsD;IACtD,GAAG,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAiB,EACpC,KAAK,IAAI,EAAE;YACT,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC;gBACxB,SAAS,EAAE,SAAS;gBACpB,sBAAsB,EAAE,kBAAkB;gBAC1C,gBAAgB,EAAE,sBAAsB;gBACxC,yBAAyB,EAAE;oBACzB,SAAS,EAAE,MAAM;oBACjB,WAAW,EAAE,UAAU;iBACxB;gBACD,oBAAoB,EAAE,sDAAsD;gBAC5E,iBAAiB,EAAE,gBAAgB;aACpC,CAAC,CAAC;QACL,CAAC,EACD,EAAE,MAAM,EAAE,CACX,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM;QACR,CAAC;QAED,+BAA+B;QAC/B,MAAM,cAAc,GAAsB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpE,SAAS,EAAE,IAAI,CAAC,SAAmB;YACnC,KAAK,EAAE,IAAI,CAAC,KAAe;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAmB;YACnC,SAAS,EAAE,IAAI,CAAC,SAAmB;YACnC,YAAY,EAAE,IAAI,CAAC,YAAsB;SAC1C,CAAC,CAAC,CAAC;QAEJ,QAAQ,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;QAEjC,8EAA8E;QAC9E,oDAAoD;QACpD,IAAI,QAAQ,CAAC,MAAM,IAAI,kCAAyB,EAAE,CAAC;YACjD,IAAA,kBAAS,GAAE,CAAC,IAAI,CACd,6BAA6B,kCAAyB,sBAAsB,MAAM,KAAK;gBACrF,sFAAsF,CACzF,CAAC;YACF,MAAM;QACR,CAAC;QAED,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAC7C,CAAC,QAAQ,gBAAgB,EAAE;IAE3B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAEnD,gCAAgC;IAChC,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC,CAAC;AAlEW,QAAA,kBAAkB,sBAkE7B"}
+{"version":3,"file":"list-sessions.js","sourceRoot":"","sources":["../../../src/history/actions/list-sessions.ts"],"names":[],"mappings":";;AAUA,oCAuBC;AAjCD,qDAA0D;AAC1D,2CAAoD;AAIpD;;;;GAIG;AACI,KAAK,UAAU,YAAY,CAAC,OAAuB;IACxD,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,IAAA,mBAAY,EAAC;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE;YACN,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,gBAAgB,EAAE,gBAAgB;YAClC,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;YACzC,yBAAyB,EAAE,EAAE,UAAU,EAAE,uBAAgB,EAAE;SAC5D;KACF,CAAC,EAAE,CAAC;QACH,MAAM,IAAI,GAAG,GAAsB,CAAC;QACpC,IAAI,IAAI,CAAC,EAAE,KAAK,uBAAgB,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;YAAE,SAAS;QACjF,QAAQ,CAAC,IAAI,CAAC;YACZ,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/history/actions/reconcile-count.d.ts

@@ -0,0 +1,10 @@
+import type { HistoryContext } from '../internal/setup';
+/**
+ * Recompute `messageCount` from the authoritative number of stored message items
+ * and write it back, repairing any drift. A repair tool: the append path keeps
+ * the count consistent transactionally, so this is only needed after external
+ * corruption. Run it when the session is quiescent — it `SET`s the count, so a
+ * concurrent append's increment could be clobbered. Returns the reconciled count.
+ */
+export declare function reconcileMessageCount(context: HistoryContext, sessionId: string): Promise<number>;
+//# sourceMappingURL=reconcile-count.d.ts.map

package/dist/history/actions/reconcile-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-count.d.ts","sourceRoot":"","sources":["../../../src/history/actions/reconcile-count.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiBxD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAajB"}