@mastra/redis 1.4.9 → 1.4.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,13 +1,17 @@
1
1
  import type { MastraMessageContentV2 } from '@mastra/core/agent';
2
2
  import type { MastraDBMessage, StorageThreadType } from '@mastra/core/memory';
3
3
  import { MemoryStorage } from '@mastra/core/storage';
4
- import type { StorageResourceType, StorageListMessagesInput, StorageListMessagesOutput, StorageListThreadsInput, StorageListThreadsOutput, StorageCloneThreadInput, StorageCloneThreadOutput } from '@mastra/core/storage';
4
+ import type { RunFence, StorageResourceType, StorageListMessagesInput, StorageListMessagesOutput, StorageListThreadsInput, StorageListThreadsOutput, StorageCloneThreadInput, StorageCloneThreadOutput } from '@mastra/core/storage';
5
5
  import type { RedisDomainConfig } from '../../db/index.js';
6
6
  export declare class StoreMemoryRedis extends MemoryStorage {
7
+ #private;
7
8
  readonly supportsPartialThreadUpdate = true;
8
9
  private client;
9
10
  private db;
10
11
  constructor(config: RedisDomainConfig);
12
+ supportsRunFencing(): boolean;
13
+ raiseRunFence(fence: RunFence): Promise<boolean>;
14
+ retireRunFence(fence: RunFence): Promise<boolean>;
11
15
  dangerouslyClearAll(): Promise<void>;
12
16
  getThreadById({ threadId, resourceId, }: {
13
17
  threadId: string;
@@ -15,19 +19,22 @@ export declare class StoreMemoryRedis extends MemoryStorage {
15
19
  }): Promise<StorageThreadType | null>;
16
20
  listThreadsByResourceId(args: StorageListThreadsInput): Promise<StorageListThreadsOutput>;
17
21
  listThreads(args: StorageListThreadsInput): Promise<StorageListThreadsOutput>;
18
- saveThread({ thread }: {
22
+ saveThread({ thread, fence, }: {
19
23
  thread: StorageThreadType;
24
+ fence?: RunFence;
20
25
  }): Promise<StorageThreadType>;
21
- updateThread({ id, title, metadata, }: {
26
+ updateThread({ id, title, metadata, fence, }: {
22
27
  id: string;
23
28
  title?: string;
24
29
  metadata?: Record<string, unknown>;
30
+ fence?: RunFence;
25
31
  }): Promise<StorageThreadType>;
26
32
  deleteThread({ threadId }: {
27
33
  threadId: string;
28
34
  }): Promise<void>;
29
35
  saveMessages(args: {
30
36
  messages: MastraDBMessage[];
37
+ fence?: RunFence;
31
38
  }): Promise<{
32
39
  messages: MastraDBMessage[];
33
40
  }>;
@@ -53,10 +60,11 @@ export declare class StoreMemoryRedis extends MemoryStorage {
53
60
  saveResource({ resource }: {
54
61
  resource: StorageResourceType;
55
62
  }): Promise<StorageResourceType>;
56
- updateResource({ resourceId, workingMemory, metadata, }: {
63
+ updateResource({ resourceId, workingMemory, metadata, fence, }: {
57
64
  resourceId: string;
58
65
  workingMemory?: string;
59
66
  metadata?: Record<string, unknown>;
67
+ fence?: RunFence;
60
68
  }): Promise<StorageResourceType>;
61
69
  updateMessages(args: {
62
70
  messages: (Partial<Omit<MastraDBMessage, 'createdAt'>> & {
@@ -66,8 +74,11 @@ export declare class StoreMemoryRedis extends MemoryStorage {
66
74
  content?: MastraMessageContentV2['content'];
67
75
  };
68
76
  })[];
77
+ fence?: RunFence;
69
78
  }): Promise<MastraDBMessage[]>;
70
- deleteMessages(messageIds: string[]): Promise<void>;
79
+ deleteMessages(messageIds: string[], options?: {
80
+ fence?: RunFence;
81
+ }): Promise<void>;
71
82
  private sortThreads;
72
83
  cloneThread(args: StorageCloneThreadInput): Promise<StorageCloneThreadOutput>;
73
84
  }
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import { TABLE_MEMORY_RUN_FENCES, TABLE_WORKFLOW_RUN_OWNERS } from '@mastra/core/storage';
2
+ import type { ClaimRunOwnershipInput, ClaimRunOwnershipResult, RenewRunOwnershipInput, RenewRunOwnershipResult, RunFence, RunOwnershipRecord } from '@mastra/core/storage';
3
+ import type { RedisClient } from '../types.js';
4
+ /** Table holding a run's current claim: its ownership hash (workflows) or raised fence (memory). */
5
+ export type RunClaimTable = typeof TABLE_WORKFLOW_RUN_OWNERS | typeof TABLE_MEMORY_RUN_FENCES;
6
+ /** A write's fence, and the table holding the run's current claim to check it against. */
7
+ export interface RunFenceCheck {
8
+ claims: RunClaimTable;
9
+ fence: RunFence;
10
+ operation: string;
11
+ }
12
+ /** The subset of a MULTI transaction the domains write through. */
13
+ export interface WriteBatch {
14
+ set(key: string, value: string): unknown;
15
+ del(key: string): unknown;
16
+ zAdd(key: string, member: {
17
+ score: number;
18
+ value: string;
19
+ }): unknown;
20
+ zRem(key: string, member: string): unknown;
21
+ exec(): Promise<unknown>;
22
+ }
23
+ /**
24
+ * A claim expires after this long without a claim, renewal or release, and a
25
+ * fence this long after it was retired. A running execution renews every few
26
+ * seconds, and a raised fence never expires. Expiring is safe: a later claim's
27
+ * generation comes from the clock, so it still outranks every fence the expired
28
+ * record issued, and a write checked against a missing record is rejected.
29
+ */
30
+ export declare const RUN_CLAIM_RETENTION_MS: number;
31
+ export declare function runClaimKey(claims: RunClaimTable, runId: string): string;
32
+ export declare function claimRunOwnership(client: RedisClient, { runId, ownerId, leaseMs, force, expectedGeneration }: ClaimRunOwnershipInput): Promise<ClaimRunOwnershipResult>;
33
+ export declare function renewRunOwnership(client: RedisClient, { leaseMs, ...fence }: RenewRunOwnershipInput): Promise<RenewRunOwnershipResult>;
34
+ export declare function releaseRunOwnership(client: RedisClient, fence: RunFence): Promise<boolean>;
35
+ export declare function getRunOwnership(client: RedisClient, runId: string): Promise<RunOwnershipRecord | null>;
36
+ export declare function raiseRunFence(client: RedisClient, fence: RunFence): Promise<boolean>;
37
+ export declare function retireRunFence(client: RedisClient, fence: RunFence): Promise<boolean>;
38
+ /** A MULTI transaction, or a fenced batch when `check` is set. */
39
+ export declare function writeBatch(client: RedisClient, check: RunFenceCheck | undefined): WriteBatch;
40
+ /**
41
+ * Rejects a fenced write that turns out to have nothing to write when its
42
+ * fence is no longer current, as the write itself would have been rejected.
43
+ */
44
+ export declare function assertRunFence(client: RedisClient, check: RunFenceCheck | undefined): Promise<void>;
45
+ //# sourceMappingURL=run-fencing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-fencing.d.ts","sourceRoot":"","sources":["../../../src/storage/domains/run-fencing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjH,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,QAAQ,EACR,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,oGAAoG;AACpG,MAAM,MAAM,aAAa,GAAG,OAAO,yBAAyB,GAAG,OAAO,uBAAuB,CAAC;AAE9F,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IACrE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,QAA0B,CAAC;AAE9D,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAExE;AAsID,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,EAAE,sBAAsB,GAC7E,OAAO,CAAC,uBAAuB,CAAC,CASlC;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,GAC5C,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQhG;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAE5G;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1F;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ3F;AAoDD,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,UAAU,CAE5F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzG"}
@@ -1,8 +1,9 @@
1
1
  import { WorkflowsStorage } from '@mastra/core/storage';
2
- import type { StorageListWorkflowRunsInput, WorkflowRun, WorkflowRuns, UpdateWorkflowStateOptions } from '@mastra/core/storage';
2
+ import type { ClaimRunOwnershipInput, ClaimRunOwnershipResult, RenewRunOwnershipInput, RenewRunOwnershipResult, RunFence, RunOwnershipRecord, StorageListWorkflowRunsInput, WorkflowRun, WorkflowRuns, UpdateWorkflowStateOptions } from '@mastra/core/storage';
3
3
  import type { StepResult, WorkflowRunState } from '@mastra/core/workflows';
4
4
  import type { RedisDomainConfig } from '../../db/index.js';
5
5
  export declare class WorkflowsRedis extends WorkflowsStorage {
6
+ #private;
6
7
  private client;
7
8
  private db;
8
9
  constructor(config: RedisDomainConfig);
@@ -12,19 +13,28 @@ export declare class WorkflowsRedis extends WorkflowsStorage {
12
13
  */
13
14
  private getSnapshotRecord;
14
15
  supportsConcurrentUpdates(): boolean;
16
+ supportsRunFencing(): boolean;
15
17
  dangerouslyClearAll(): Promise<void>;
16
- updateWorkflowResults({ workflowName, runId, stepId, result, requestContext, state, }: {
18
+ claimRunOwnership(args: ClaimRunOwnershipInput): Promise<ClaimRunOwnershipResult>;
19
+ renewRunOwnership(args: RenewRunOwnershipInput): Promise<RenewRunOwnershipResult>;
20
+ releaseRunOwnership(fence: RunFence): Promise<boolean>;
21
+ getRunOwnership({ runId }: {
22
+ runId: string;
23
+ }): Promise<RunOwnershipRecord | null>;
24
+ updateWorkflowResults({ workflowName, runId, stepId, result, requestContext, state, fence, }: {
17
25
  workflowName: string;
18
26
  runId: string;
19
27
  stepId: string;
20
28
  result: StepResult<unknown, unknown, unknown, unknown>;
21
29
  requestContext: Record<string, unknown>;
22
30
  state?: Record<string, unknown>;
31
+ fence?: RunFence;
23
32
  }): Promise<Record<string, StepResult<unknown, unknown, unknown, unknown>>>;
24
- updateWorkflowState({ workflowName, runId, opts, }: {
33
+ updateWorkflowState({ workflowName, runId, opts, fence, }: {
25
34
  workflowName: string;
26
35
  runId: string;
27
36
  opts: UpdateWorkflowStateOptions;
37
+ fence?: RunFence;
28
38
  }): Promise<WorkflowRunState | undefined>;
29
39
  persistWorkflowSnapshot(params: {
30
40
  namespace?: string;
@@ -34,6 +44,7 @@ export declare class WorkflowsRedis extends WorkflowsStorage {
34
44
  snapshot: WorkflowRunState;
35
45
  createdAt?: Date;
36
46
  updatedAt?: Date;
47
+ fence?: RunFence;
37
48
  }): Promise<void>;
38
49
  loadWorkflowSnapshot(params: {
39
50
  namespace: string;
@@ -44,9 +55,10 @@ export declare class WorkflowsRedis extends WorkflowsStorage {
44
55
  runId: string;
45
56
  workflowName?: string;
46
57
  }): Promise<WorkflowRun | null>;
47
- deleteWorkflowRunById({ runId, workflowName }: {
58
+ deleteWorkflowRunById({ runId, workflowName, fence, }: {
48
59
  runId: string;
49
60
  workflowName: string;
61
+ fence?: RunFence;
50
62
  }): Promise<void>;
51
63
  listWorkflowRuns({ workflowName, fromDate, toDate, perPage, page, resourceId, status, }?: StorageListWorkflowRunsInput): Promise<WorkflowRuns>;
52
64
  }
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/workflows/index.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,gBAAgB,EAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,4BAA4B,EAC5B,WAAW,EACX,YAAY,EACZ,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAiDlD,qBAAa,cAAe,SAAQ,gBAAgB;IAClD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,EAAE,CAAU;IAEpB,YAAY,MAAM,EAAE,iBAAiB,EAIpC;IAED;;;OAGG;YACW,iBAAiB;IAkBxB,yBAAyB,IAAI,OAAO,CAE1C;IAEY,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhD;IAEY,qBAAqB,CAAC,EACjC,YAAY,EACZ,KAAK,EACL,MAAM,EACN,MAAM,EACN,cAAc,EACd,KAAK,GACN,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACvD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAsD1E;IAEY,mBAAmB,CAAC,EAC/B,YAAY,EACZ,KAAK,EACL,IAAI,GACL,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,0BAA0B,CAAC;KAClC,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA2CxC;IAEY,uBAAuB,CAAC,MAAM,EAAE;QAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ChB;IAEY,oBAAoB,CAAC,MAAM,EAAE;QACxC,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoBnC;IAEY,kBAAkB,CAAC,EAC9B,KAAK,EACL,YAAY,GACb,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8D9B;IAEY,qBAAqB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBlH;IAEY,gBAAgB,CAAC,EAC5B,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,OAAO,EACP,IAAI,EACJ,UAAU,EACV,MAAM,GACP,GAAE,4BAAiC,GAAG,OAAO,CAAC,YAAY,CAAC,CAuG3D;CACF"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/workflows/index.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/redis",
3
- "version": "1.4.9",
3
+ "version": "1.4.10",
4
4
  "description": "Redis storage provider for Mastra - provides storage capabilities for direct Redis connections",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -34,13 +34,13 @@
34
34
  "tsx": "^4.23.1",
35
35
  "typescript": "^7.0.2",
36
36
  "vitest": "4.1.11",
37
- "@internal/lint": "0.0.142",
38
- "@internal/types-builder": "0.0.117",
39
- "@mastra/core": "1.76.0",
40
- "@internal/storage-test-utils": "0.0.138"
37
+ "@internal/lint": "0.0.143",
38
+ "@internal/storage-test-utils": "0.0.139",
39
+ "@internal/types-builder": "0.0.118",
40
+ "@mastra/core": "1.77.0"
41
41
  },
42
42
  "peerDependencies": {
43
- "@mastra/core": ">=1.61.0-0 <2.0.0-0"
43
+ "@mastra/core": ">=1.76.0-0 <2.0.0-0"
44
44
  },
45
45
  "files": [
46
46
  "dist"