@mastra/dynamodb 1.0.0-beta.9 → 1.0.0

package/README.md

@@ -45,9 +45,8 @@ const storage = new DynamoDBStore({
 
 // Initialize vector store (if using semantic recall)
 const vector = new PineconeVector({
+  id: 'dynamodb-pinecone',
   apiKey: process.env.PINECONE_API_KEY,
-  environment: process.env.PINECONE_ENVIRONMENT,
-  index: process.env.PINECONE_INDEX,
 });
 
 // Memory combines storage (like DynamoDBStore) with an optional vector store for recall

package/dist/docs/README.md

@@ -28,4 +28,4 @@ docs/
 ## Version
 
 Package: @mastra/dynamodb
-Version: 1.0.0-beta.9
+Version: 1.0.0

package/dist/docs/SKILL.md

@@ -5,7 +5,7 @@ description: Documentation for @mastra/dynamodb. Includes links to type definiti
 
 # @mastra/dynamodb Documentation
 
-> **Version**: 1.0.0-beta.9
+> **Version**: 1.0.0
 > **Package**: @mastra/dynamodb
 
 ## Quick Navigation

package/dist/docs/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-beta.9",
+  "version": "1.0.0",
   "package": "@mastra/dynamodb",
   "exports": {},
   "modules": {}

package/dist/docs/storage/01-reference.md

@@ -19,6 +19,7 @@ The DynamoDB storage implementation provides a scalable and performant NoSQL dat
 - Compatible with AWS DynamoDB Local for development
 - Stores Thread, Message, Trace, Eval, and Workflow data
 - Optimized for serverless environments
+- Configurable TTL (Time To Live) for automatic data expiration per entity type
 
 ## Installation
 
@@ -46,7 +47,7 @@ import { DynamoDBStore } from "@mastra/dynamodb";
 
 // Initialize the DynamoDB storage
 const storage = new DynamoDBStore({
-  name: "dynamodb", // A name for this storage instance
+  id: "dynamodb", // Unique identifier for this storage instance
   config: {
     tableName: "mastra-single-table", // Name of your DynamoDB table
     region: "us-east-1", // Optional: AWS region, defaults to 'us-east-1'
@@ -80,7 +81,7 @@ For local development, you can use [DynamoDB Local](https://docs.aws.amazon.com/
     import { DynamoDBStore } from "@mastra/dynamodb";
 
     const storage = new DynamoDBStore({
-      name: "dynamodb-local",
+      id: "dynamodb-local",
       config: {
         tableName: "mastra-single-table", // Ensure this table is created in your local DynamoDB
         region: "localhost", // Can be any string for local, 'localhost' is common
@@ -96,6 +97,96 @@ For local development, you can use [DynamoDB Local](https://docs.aws.amazon.com/
 
 ## Parameters
 
+## TTL (Time To Live) Configuration
+
+DynamoDB TTL allows you to automatically delete items after a specified time period. This is useful for:
+
+- **Cost optimization**: Automatically remove old data to reduce storage costs
+- **Data lifecycle management**: Implement retention policies for compliance
+- **Performance**: Prevent tables from growing indefinitely
+- **Privacy compliance**: Automatically purge personal data after specified periods
+
+### Enabling TTL
+
+To use TTL, you must:
+
+1. **Configure TTL in DynamoDBStore** (shown below)
+2. **Enable TTL on your DynamoDB table** via AWS Console or CLI, specifying the attribute name (default: `ttl`)
+
+```typescript
+import { DynamoDBStore } from "@mastra/dynamodb";
+
+const storage = new DynamoDBStore({
+  name: "dynamodb",
+  config: {
+    tableName: "mastra-single-table",
+    region: "us-east-1",
+    ttl: {
+      // Messages expire after 30 days
+      message: {
+        enabled: true,
+        defaultTtlSeconds: 30 * 24 * 60 * 60, // 30 days
+      },
+      // Threads expire after 90 days
+      thread: {
+        enabled: true,
+        defaultTtlSeconds: 90 * 24 * 60 * 60, // 90 days
+      },
+      // Traces expire after 7 days with custom attribute name
+      trace: {
+        enabled: true,
+        attributeName: "expiresAt", // Custom TTL attribute
+        defaultTtlSeconds: 7 * 24 * 60 * 60, // 7 days
+      },
+      // Workflow snapshots don't expire
+      workflow_snapshot: {
+        enabled: false,
+      },
+    },
+  },
+});
+```
+
+### Supported Entity Types
+
+TTL can be configured for these entity types:
+
+| Entity | Description |
+|--------|-------------|
+| `thread` | Conversation threads |
+| `message` | Messages within threads |
+| `trace` | Observability traces |
+| `eval` | Evaluation results |
+| `workflow_snapshot` | Workflow state snapshots |
+| `resource` | User/resource data |
+| `score` | Scoring results |
+
+### TTL Entity Configuration
+
+Each entity type accepts the following configuration:
+
+### Enabling TTL on Your DynamoDB Table
+
+After configuring TTL in your code, you must enable TTL on the DynamoDB table itself:
+
+**Using AWS CLI:**
+
+```bash
+aws dynamodb update-time-to-live \
+  --table-name mastra-single-table \
+  --time-to-live-specification "Enabled=true, AttributeName=ttl"
+```
+
+**Using AWS Console:**
+
+1. Go to the DynamoDB console
+2. Select your table
+3. Go to "Additional settings" tab
+4. Under "Time to Live (TTL)", click "Manage TTL"
+5. Enable TTL and specify the attribute name (default: `ttl`)
+
+> **Note**: DynamoDB deletes expired items within 48 hours after expiration. Items remain queryable until actually deleted.
+
 ## AWS IAM Permissions
 
 The IAM role or user executing the code needs appropriate permissions to interact with the specified DynamoDB table and its indexes. Below is a sample policy. Replace `${YOUR_TABLE_NAME}` with your actual table name and `${YOUR_AWS_REGION}` and `${YOUR_AWS_ACCOUNT_ID}` with appropriate values.

package/dist/entities/eval.d.ts

@@ -70,6 +70,14 @@ export declare const evalEntity: Entity<string, string, string, {
             readonly set: (value?: Record<string, unknown> | string) => string | undefined;
             readonly get: (value?: string) => any;
         };
+        ttl: {
+            readonly type: "number";
+            readonly required: false;
+        };
+        expiresAt: {
+            readonly type: "number";
+            readonly required: false;
+        };
         entity: {
             type: "string";
             required: true;

package/dist/entities/eval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/entities/eval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;0BAwBH,GAAG;0BAOH,MAAM;;;;;;;;;;;;;;;;;0BAuBN,GAAG;0BAOH,MAAM;;;;;;;;;;;;;;0BAkBN,IAAI,GAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB/B,CAAC"}
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/entities/eval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;0BAwBH,GAAG;0BAOH,MAAM;;;;;;;;;;;;;;;;;0BAuBN,GAAG;0BAOH,MAAM;;;;;;;;;;;;;;0BAkBN,IAAI,GAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB/B,CAAC"}

package/dist/entities/index.d.ts

@@ -39,6 +39,14 @@ export declare function getElectroDbService(client: DynamoDBDocumentClient, tabl
                 readonly set: (value?: Date | string) => string;
                 readonly default: () => string;
             };
+            ttl: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            expiresAt: {
+                readonly type: "number";
+                readonly required: false;
+            };
             entity: {
                 type: "string";
                 required: true;
@@ -137,6 +145,14 @@ export declare function getElectroDbService(client: DynamoDBDocumentClient, tabl
                 readonly set: (value?: Record<string, unknown> | string) => string | undefined;
                 readonly get: (value?: string) => any;
             };
+            ttl: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            expiresAt: {
+                readonly type: "number";
+                readonly required: false;
+            };
             entity: {
                 type: "string";
                 required: true;
@@ -237,6 +253,14 @@ export declare function getElectroDbService(client: DynamoDBDocumentClient, tabl
                 readonly set: (value?: Record<string, unknown> | string) => string | undefined;
                 readonly get: (value?: string) => any;
             };
+            ttl: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            expiresAt: {
+                readonly type: "number";
+                readonly required: false;
+            };
             entity: {
                 type: "string";
                 required: true;
@@ -351,6 +375,14 @@ export declare function getElectroDbService(client: DynamoDBDocumentClient, tabl
                 readonly set: (value?: Record<string, unknown> | string) => string | undefined;
                 readonly get: (value?: string) => any;
             };
+            ttl: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            expiresAt: {
+                readonly type: "number";
+                readonly required: false;
+            };
             entity: {
                 type: "string";
                 required: true;
@@ -434,6 +466,14 @@ export declare function getElectroDbService(client: DynamoDBDocumentClient, tabl
                 readonly set: (value?: Record<string, unknown> | string) => string | undefined;
                 readonly get: (value?: string) => any;
             };
+            ttl: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            expiresAt: {
+                readonly type: "number";
+                readonly required: false;
+            };
             entity: {
                 type: "string";
                 required: true;
@@ -497,6 +537,14 @@ export declare function getElectroDbService(client: DynamoDBDocumentClient, tabl
                 readonly set: (value?: Date | string) => string;
                 readonly default: () => string;
             };
+            ttl: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            expiresAt: {
+                readonly type: "number";
+                readonly required: false;
+            };
             entity: {
                 type: "string";
                 required: true;
@@ -616,6 +664,12 @@ export declare function getElectroDbService(client: DynamoDBDocumentClient, tabl
                 set: (value?: Record<string, unknown> | string) => string | undefined;
                 get: (value?: string) => any;
             };
+            metadata: {
+                type: "string";
+                required: false;
+                set: (value?: Record<string, unknown> | string) => string | undefined;
+                get: (value?: string) => any;
+            };
             requestContext: {
                 type: "string";
                 required: false;
@@ -661,10 +715,13 @@ export declare function getElectroDbService(client: DynamoDBDocumentClient, tabl
                 readonly set: (value?: Date | string) => string;
                 readonly default: () => string;
             };
-            metadata: {
-                readonly type: "string";
-                readonly set: (value?: Record<string, unknown> | string) => string | undefined;
-                readonly get: (value?: string) => any;
+            ttl: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            expiresAt: {
+                readonly type: "number";
+                readonly required: false;
             };
             entity: {
                 type: "string";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgBpF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgBpF"}

package/dist/entities/message.d.ts

@@ -68,6 +68,14 @@ export declare const messageEntity: Entity<string, string, string, {
             readonly set: (value?: Record<string, unknown> | string) => string | undefined;
             readonly get: (value?: string) => any;
         };
+        ttl: {
+            readonly type: "number";
+            readonly required: false;
+        };
+        expiresAt: {
+            readonly type: "number";
+            readonly required: false;
+        };
         entity: {
             type: "string";
             required: true;

package/dist/entities/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/entities/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;0BA+BN,MAAM;;;;;;;;;;;;;;;;;0BA8BN,MAAM,EAAE,GAAG,MAAM;0BAOjB,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM;0BAOlC,MAAM;;;;;0BAgBN,MAAM,EAAE,GAAG,MAAM;0BAOjB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBxB,CAAC"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/entities/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;0BA+BN,MAAM;;;;;;;;;;;;;;;;;0BA8BN,MAAM,EAAE,GAAG,MAAM;0BAOjB,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM;0BAOlC,MAAM;;;;;0BAgBN,MAAM,EAAE,GAAG,MAAM;0BAOjB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBxB,CAAC"}

package/dist/entities/resource.d.ts

@@ -33,6 +33,14 @@ export declare const resourceEntity: Entity<string, string, string, {
             readonly set: (value?: Date | string) => string;
             readonly default: () => string;
         };
+        ttl: {
+            readonly type: "number";
+            readonly required: false;
+        };
+        expiresAt: {
+            readonly type: "number";
+            readonly required: false;
+        };
         entity: {
             type: "string";
             required: true;

package/dist/entities/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/entities/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;0BA+BP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBxB,CAAC"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/entities/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;0BA+BP,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBxB,CAAC"}

package/dist/entities/score.d.ts

@@ -100,6 +100,12 @@ export declare const scoreEntity: Entity<string, string, string, {
             set: (value?: Record<string, unknown> | string) => string | undefined;
             get: (value?: string) => any;
         };
+        metadata: {
+            type: "string";
+            required: false;
+            set: (value?: Record<string, unknown> | string) => string | undefined;
+            get: (value?: string) => any;
+        };
         requestContext: {
             type: "string";
             required: false;
@@ -145,10 +151,13 @@ export declare const scoreEntity: Entity<string, string, string, {
             readonly set: (value?: Date | string) => string;
             readonly default: () => string;
         };
-        metadata: {
-            readonly type: "string";
-            readonly set: (value?: Record<string, unknown> | string) => string | undefined;
-            readonly get: (value?: string) => any;
+        ttl: {
+            readonly type: "number";
+            readonly required: false;
+        };
+        expiresAt: {
+            readonly type: "number";
+            readonly required: false;
         };
         entity: {
             type: "string";

package/dist/entities/score.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/entities/score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmCJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;;;;;0BAoBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA8CN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;;;;;0BAoBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuExB,CAAC"}
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/entities/score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmCJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;;;;;0BAoBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA8CN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;0BAgBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;;;;;0BAoBN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAMhC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuExB,CAAC"}

package/dist/entities/thread.d.ts

@@ -37,6 +37,14 @@ export declare const threadEntity: Entity<string, string, string, {
             readonly set: (value?: Date | string) => string;
             readonly default: () => string;
         };
+        ttl: {
+            readonly type: "number";
+            readonly required: false;
+        };
+        expiresAt: {
+            readonly type: "number";
+            readonly required: false;
+        };
         entity: {
             type: "string";
             required: true;

package/dist/entities/thread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/entities/thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;0BA4BL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAOhC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BxB,CAAC"}
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/entities/thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;0BA4BL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;0BAOhC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BxB,CAAC"}

package/dist/entities/trace.d.ts

@@ -84,6 +84,14 @@ export declare const traceEntity: Entity<string, string, string, {
             readonly set: (value?: Record<string, unknown> | string) => string | undefined;
             readonly get: (value?: string) => any;
         };
+        ttl: {
+            readonly type: "number";
+            readonly required: false;
+        };
+        expiresAt: {
+            readonly type: "number";
+            readonly required: false;
+        };
         entity: {
             type: "string";
             required: true;

package/dist/entities/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/entities/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAwCJ,GAAG;0BAOH,MAAM;;;;;0BAQN,GAAG;0BAOH,MAAM;;;;;0BAQN,GAAG;0BAOH,MAAM;;;;;0BAQN,GAAG;0BAOH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCxB,CAAC"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/entities/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAwCJ,GAAG;0BAOH,MAAM;;;;;0BAQN,GAAG;0BAOH,MAAM;;;;;0BAQN,GAAG;0BAOH,MAAM;;;;;0BAQN,GAAG;0BAOH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCxB,CAAC"}

package/dist/entities/utils.d.ts

@@ -1,3 +1,74 @@
+/**
+ * Base fields shared by all entities
+ */
+export interface BaseEntityData {
+    entity: string;
+    createdAt: string;
+    updatedAt: string;
+    metadata?: string;
+    ttl?: number;
+    expiresAt?: number;
+}
+export interface ThreadEntityData extends BaseEntityData {
+    entity: 'thread';
+    id: string;
+    resourceId: string;
+    title: string;
+}
+export interface MessageEntityData extends BaseEntityData {
+    entity: 'message';
+    id: string;
+    threadId?: string;
+    role: string;
+    type?: string;
+    content: string;
+    resourceId?: string;
+    toolCallIds?: string;
+    toolCallArgs?: string;
+    toolNames?: string;
+}
+export interface ResourceEntityData extends BaseEntityData {
+    entity: 'resource';
+    id: string;
+    workingMemory?: string;
+}
+export interface WorkflowSnapshotEntityData extends BaseEntityData {
+    entity: 'workflow_snapshot';
+    workflow_name: string;
+    run_id: string;
+    snapshot: string;
+    resourceId?: string;
+}
+export interface ScoreEntityData extends BaseEntityData {
+    entity: 'score';
+    id: string;
+    scorerId: string;
+    runId: string;
+    scorer: string;
+    score: number;
+    input: string;
+    output: string;
+    source: string;
+    traceId?: string;
+    spanId?: string;
+    reason?: string;
+    extractPrompt?: string;
+    analyzePrompt?: string;
+    reasonPrompt?: string;
+    generateScorePrompt?: string;
+    generateReasonPrompt?: string;
+    preprocessPrompt?: string;
+    extractStepResult?: string;
+    preprocessStepResult?: string;
+    analyzeStepResult?: string;
+    additionalContext?: string;
+    requestContext?: string;
+    entityType?: string;
+    entityData?: string;
+    entityId?: string;
+    resourceId?: string;
+    threadId?: string;
+}
 export declare const baseAttributes: {
     readonly createdAt: {
         readonly type: "string";
@@ -17,5 +88,24 @@ export declare const baseAttributes: {
         readonly set: (value?: Record<string, unknown> | string) => string | undefined;
         readonly get: (value?: string) => any;
     };
+    /**
+     * TTL attribute for DynamoDB automatic item expiration.
+     * This is a Unix timestamp (epoch seconds) that indicates when the item should be deleted.
+     *
+     * Note: For TTL to work, you must enable TTL on your DynamoDB table
+     * specifying this attribute name (default: 'ttl').
+     */
+    readonly ttl: {
+        readonly type: "number";
+        readonly required: false;
+    };
+    /**
+     * Alternative TTL attribute with configurable name.
+     * Use this if you've configured TTL on your DynamoDB table with 'expiresAt' as the attribute name.
+     */
+    readonly expiresAt: {
+        readonly type: "number";
+        readonly required: false;
+    };
 };
 //# sourceMappingURL=utils.d.ts.map

package/dist/entities/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/entities/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;+BAMT,IAAI,GAAG,MAAM;;;;;;+BAab,IAAI,GAAG,MAAM;;;;;+BAYb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;+BAOhC,MAAM;;CAYd,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/entities/utils.ts"],"names":[],"mappings":"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"}

package/dist/entities/workflow-snapshot.d.ts

@@ -42,6 +42,14 @@ export declare const workflowSnapshotEntity: Entity<string, string, string, {
             readonly set: (value?: Record<string, unknown> | string) => string | undefined;
             readonly get: (value?: string) => any;
         };
+        ttl: {
+            readonly type: "number";
+            readonly required: false;
+        };
+        expiresAt: {
+            readonly type: "number";
+            readonly required: false;
+        };
         entity: {
             type: "string";
             required: true;

package/dist/entities/workflow-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-snapshot.d.ts","sourceRoot":"","sources":["../../src/entities/workflow-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;0BAwBf,GAAG;0BAOH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBxB,CAAC"}
+{"version":3,"file":"workflow-snapshot.d.ts","sourceRoot":"","sources":["../../src/entities/workflow-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;0BAwBf,GAAG;0BAOH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBxB,CAAC"}