@mastra/mysql 0.13.0 → 0.13.1-alpha.0
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.
- package/dist/_types/@internal_core/dist/memory/index.d.ts +102 -0
- package/dist/_types/@internal_core/package.json +1 -0
- package/dist/docs/SKILL.md +1 -1
- package/dist/docs/assets/SOURCE_MAP.json +1 -1
- package/dist/index.cjs +544 -346
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +544 -346
- package/dist/index.js.map +1 -1
- package/dist/storage/domains/memory/index.d.ts +36 -0
- package/dist/storage/domains/memory/index.d.ts.map +1 -1
- package/package.json +4 -3
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type UpdateActiveObservationsResult, type UpdateBufferedObservationsResult } from '../../../_types/@internal_core/dist/memory/index.js';
|
|
1
2
|
import type { MastraDBMessage, MastraMessageContentV2 } from '@mastra/core/agent';
|
|
2
3
|
import type { StorageThreadType } from '@mastra/core/memory';
|
|
3
4
|
import { MemoryStorage } from '@mastra/core/storage';
|
|
@@ -128,6 +129,7 @@ export declare class MemoryMySQL extends MemoryStorage {
|
|
|
128
129
|
getObservationalMemoryHistory(threadId: string | null, resourceId: string, limit?: number, options?: ObservationalMemoryHistoryOptions): Promise<ObservationalMemoryRecord[]>;
|
|
129
130
|
initializeObservationalMemory(input: CreateObservationalMemoryInput): Promise<ObservationalMemoryRecord>;
|
|
130
131
|
updateActiveObservations(input: UpdateActiveObservationsInput): Promise<void>;
|
|
132
|
+
commitActiveObservations(input: UpdateActiveObservationsInput): Promise<UpdateActiveObservationsResult>;
|
|
131
133
|
createReflectionGeneration(input: CreateReflectionGenerationInput): Promise<ObservationalMemoryRecord>;
|
|
132
134
|
setReflectingFlag(id: string, isReflecting: boolean): Promise<void>;
|
|
133
135
|
setObservingFlag(id: string, isObserving: boolean): Promise<void>;
|
|
@@ -136,9 +138,43 @@ export declare class MemoryMySQL extends MemoryStorage {
|
|
|
136
138
|
clearObservationalMemory(threadId: string | null, resourceId: string): Promise<void>;
|
|
137
139
|
setPendingMessageTokens(id: string, tokenCount: number): Promise<void>;
|
|
138
140
|
updateBufferedObservations(input: UpdateBufferedObservationsInput): Promise<void>;
|
|
141
|
+
appendBufferedObservations(input: UpdateBufferedObservationsInput): Promise<UpdateBufferedObservationsResult>;
|
|
139
142
|
swapBufferedToActive(input: SwapBufferedToActiveInput): Promise<SwapBufferedToActiveResult>;
|
|
140
143
|
updateBufferedReflection(input: UpdateBufferedReflectionInput): Promise<void>;
|
|
141
144
|
swapBufferedReflectionToActive(input: SwapBufferedReflectionToActiveInput): Promise<ObservationalMemoryRecord>;
|
|
145
|
+
/**
|
|
146
|
+
* Runs `fn` in one transaction on a dedicated connection. Every OM lifecycle write locks its
|
|
147
|
+
* target row by primary key (`SELECT … FOR UPDATE`, a record lock — never a range), so the
|
|
148
|
+
* only expected lock conflict is a wait; a deadlock or lock-wait timeout (e.g. against the
|
|
149
|
+
* startup backfill's scan) is retried a bounded number of times.
|
|
150
|
+
*/
|
|
151
|
+
private withOMTransaction;
|
|
152
|
+
/** Row-locks one OM record by primary key for the rest of the transaction. */
|
|
153
|
+
private lockOMRow;
|
|
154
|
+
/**
|
|
155
|
+
* The live, row-locked record a lifecycle write aimed at `row` lands on: `row` itself while
|
|
156
|
+
* live, otherwise the head. The head is found with a plain (non-locking, so no range locks)
|
|
157
|
+
* canonical head read, then locked by primary key. Under REPEATABLE READ that read can predate
|
|
158
|
+
* a rollover committed after this transaction started; the locking read sees the latest
|
|
159
|
+
* committed row, so a head retired since is followed through `supersededBy` (bounded).
|
|
160
|
+
*/
|
|
161
|
+
private resolveLiveOMRow;
|
|
162
|
+
/**
|
|
163
|
+
* Create the next generation from the stored (live, row-locked) record and retire the stored
|
|
164
|
+
* record in the same transaction. Carried columns are copied in SQL from the stored row, so
|
|
165
|
+
* nothing round-trips through a client-side date conversion. Buffered chunks move to the new
|
|
166
|
+
* generation; the cursor, buffering markers, flags, and counters carry over; buffered
|
|
167
|
+
* reflection state does not (and is cleared on the retired row after a buffered swap).
|
|
168
|
+
*/
|
|
169
|
+
private rollOverOMRow;
|
|
170
|
+
/**
|
|
171
|
+
* Retire every live row that sorts after its key's canonical head, marking it superseded by
|
|
172
|
+
* the head. Rows retired by older adapter versions (which never set `supersededBy`) become
|
|
173
|
+
* frozen. Only keys with more than one live row are touched; each update embeds the head's
|
|
174
|
+
* ordering key, so a row created by a concurrent rollover (a newer generation) never matches.
|
|
175
|
+
* Runs at READ COMMITTED so the scan takes no gap locks.
|
|
176
|
+
*/
|
|
177
|
+
private backfillSupersededBy;
|
|
142
178
|
private updateOMFlag;
|
|
143
179
|
private getOMKey;
|
|
144
180
|
private parseOMRow;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,aAAa,EAUd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAEV,kBAAkB,EAClB,8BAA8B,EAC9B,+BAA+B,EAC/B,iCAAiC,EACjC,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,oCAAoC,EACpC,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EAExB,mBAAmB,EACnB,mCAAmC,EACnC,yBAAyB,EACzB,0BAA0B,EAE1B,iBAAiB,EACjB,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,IAAI,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EAEtC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,aAAa,EAUd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAEV,kBAAkB,EAClB,8BAA8B,EAC9B,+BAA+B,EAC/B,iCAAiC,EACjC,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,oCAAoC,EACpC,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EAExB,mBAAmB,EACnB,mCAAmC,EACnC,yBAAyB,EACzB,0BAA0B,EAE1B,iBAAiB,EACjB,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,IAAI,EAAkD,MAAM,gBAAgB,CAAC;AAE3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AA6I1D,qBAAa,WAAY,SAAQ,aAAa;;IAC5C,SAAkB,2BAA2B,QAAQ;IACrD,QAAQ,CAAC,2BAA2B,QAAQ;IAC5C,QAAQ,CAAC,wCAAwC,QAAQ;IAEzD,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,UAAU,CAAuB;IAIzC,MAAM,CAAC,QAAQ,CAAC,cAAc,qEAA6D;IAE3F,YAAY,EACV,IAAI,EACJ,UAAU,EACV,kBAAkB,EAClB,OAAO,GACR,EAAE;QACD,IAAI,EAAE,IAAI,CAAC;QACX,UAAU,EAAE,oBAAoB,CAAC;QACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAChC,EAMA;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA6E1B;IAED,MAAM,CAAC,mBAAmB,CAAC,MAAM,GAAE,MAAW,GAAG,kBAAkB,EAAE,CAapE;IAED,MAAM,CAAC,YAAY,IAAI,MAAM,EAAE,CAiB9B;IAED,0BAA0B,IAAI,kBAAkB,EAAE,CAEjD;IAEK,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1C;IAEK,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKzC;IAEK,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAYzC;IAED,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,UAAU;IAiClB;;;;;;OAMG;YACW,sBAAsB;IAYpC;;;;;;;OAOG;YACW,oBAAoB;IA8ElC;;;;;;;;;OASG;YACW,sBAAsB;YA0FtB,YAAY;IAcpB,aAAa,CAAC,EAClB,QAAQ,EACR,UAAU,GACX,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAwBpC;IAED;;;;;;;;OAQG;IACG,sBAAsB,CAAC,EAC3B,QAAQ,EACR,UAAU,GACX,EAAE;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0D7B;IAEY,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAiEzF;IAEY,sBAAsB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CASlH;IAEY,+BAA+B,CAC1C,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,cAAc,GAChB,iBAAiB,GAClB,OAAO,CAAC,cAAc,GAAG;QAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC,CAO5D;IAEK,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAetF;IAEK,YAAY,CAAC,EACjB,EAAE,EACF,KAAK,EACL,QAAQ,GACT,EAAE;QACD,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiD7B;IAEK,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBpE;IAEK,gBAAgB,CAAC,EAAE,UAAU,EAAE,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC,CAoBzG;IAEK,YAAY,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC,CAwHlG;IAEK,cAAc,CAAC,IAAI,EAAE;QACzB,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,GAAG;YACvD,EAAE,EAAE,MAAM,CAAC;YACX,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;SAC3C,CAAC,EAAE,CAAC;KACN,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAgG7B;IAEK,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCxD;IAEK,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA+KlF;IAEK,YAAY,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAmNrF;IAEY,wBAAwB,CACnC,IAAI,EAAE,oCAAoC,GACzC,OAAO,CAAC,yBAAyB,CAAC,CA6JpC;IAEK,eAAe,CAAC,EAAE,UAAU,EAAE,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA+BjG;IAEK,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA0BhG;IAEK,cAAc,CAAC,EACnB,UAAU,EACV,aAAa,EACb,QAAQ,GACT,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuD/B;IAMK,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAYnH;IAEK,6BAA6B,CACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAW,EAClB,OAAO,CAAC,EAAE,iCAAiC,GAC1C,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAoDtC;IAEK,6BAA6B,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAyG7G;IAEK,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;IAEK,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CA0C5G;IAEK,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA0B3G;IAEK,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAExE;IAEK,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;IAEK,2BAA2B,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhH;IAEK,0BAA0B,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF;IAEK,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzF;IAEK,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3E;IAEK,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;IAEK,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAwDlH;IAEK,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA0JhG;IAEK,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkClF;IAEK,8BAA8B,CAAC,KAAK,EAAE,mCAAmC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA+CnH;IAED;;;;;OAKG;YACW,iBAAiB;IAkB/B,8EAA8E;YAChE,SAAS;IAQvB;;;;;;OAMG;YACW,gBAAgB;IAwB9B;;;;;;OAMG;YACW,aAAa;IA+D3B;;;;;;OAMG;YACW,oBAAoB;YAwCpB,YAAY;IAe1B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;CA2CnB"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mysql",
|
|
3
|
-
"version": "0.13.0",
|
|
3
|
+
"version": "0.13.1-alpha.0",
|
|
4
4
|
"description": "MySQL provider for Mastra - db storage capabilities",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -31,10 +31,11 @@
|
|
|
31
31
|
"tsx": "^4.23.1",
|
|
32
32
|
"typescript": "^7.0.2",
|
|
33
33
|
"vitest": "4.1.11",
|
|
34
|
+
"@internal/core": "0.1.2",
|
|
34
35
|
"@internal/lint": "0.0.142",
|
|
35
36
|
"@internal/storage-test-utils": "0.0.138",
|
|
36
|
-
"@
|
|
37
|
-
"@
|
|
37
|
+
"@internal/types-builder": "0.0.117",
|
|
38
|
+
"@mastra/core": "1.77.0-alpha.0"
|
|
38
39
|
},
|
|
39
40
|
"peerDependencies": {
|
|
40
41
|
"@mastra/core": ">=1.68.0-0 <2.0.0-0"
|