@mastra/oracledb 0.5.1 → 0.5.2-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/docs/references/docs-memory-observational-memory.md +17 -15
- package/dist/index.cjs +346 -113
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +346 -113
- package/dist/index.js.map +1 -1
- package/dist/storage/domains/memory/index.d.ts +10 -0
- package/dist/storage/domains/memory/index.d.ts.map +1 -1
- package/dist/storage/domains/memory/observational-buffering.d.ts +2 -1
- package/dist/storage/domains/memory/observational-buffering.d.ts.map +1 -1
- package/dist/storage/domains/memory/observational.d.ts +23 -1
- package/dist/storage/domains/memory/observational.d.ts.map +1 -1
- package/dist/storage/domains/memory/schema.d.ts +11 -0
- package/dist/storage/domains/memory/schema.d.ts.map +1 -1
- package/dist/storage/domains/memory/utils.d.ts +8 -1
- package/dist/storage/domains/memory/utils.d.ts.map +1 -1
- package/dist/storage/index.d.ts.map +1 -1
- package/package.json +3 -2
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type UpdateActiveObservationsResult, type UpdateBufferedObservationsResult } from '../../../_types/@internal_core/dist/memory/index.js';
|
|
1
2
|
import type { MastraMessageContentV2 } from '@mastra/core/agent';
|
|
2
3
|
import type { MastraDBMessage, StorageThreadType } from '@mastra/core/memory';
|
|
3
4
|
import { MemoryStorage } from '@mastra/core/storage';
|
|
@@ -17,6 +18,13 @@ export declare class MemoryOracle extends MemoryStorage {
|
|
|
17
18
|
constructor(config: OracleDomainConfig);
|
|
18
19
|
private get ctx();
|
|
19
20
|
init(): Promise<void>;
|
|
21
|
+
/**
|
|
22
|
+
* Mark observational memory rows that are not their key's canonical head as superseded.
|
|
23
|
+
* Runs as part of `init()`; `OracleStore` also runs it on every start when the memory schema
|
|
24
|
+
* migration is unchanged and skipped.
|
|
25
|
+
* @internal
|
|
26
|
+
*/
|
|
27
|
+
backfillObservationalMemorySupersededBy(): Promise<void>;
|
|
20
28
|
dangerouslyClearAll(): Promise<void>;
|
|
21
29
|
getThreadById(args: {
|
|
22
30
|
threadId: string;
|
|
@@ -78,6 +86,7 @@ export declare class MemoryOracle extends MemoryStorage {
|
|
|
78
86
|
initializeObservationalMemory(input: CreateObservationalMemoryInput): Promise<ObservationalMemoryRecord>;
|
|
79
87
|
insertObservationalMemoryRecord(record: ObservationalMemoryRecord): Promise<void>;
|
|
80
88
|
updateActiveObservations(input: UpdateActiveObservationsInput): Promise<void>;
|
|
89
|
+
commitActiveObservations(input: UpdateActiveObservationsInput): Promise<UpdateActiveObservationsResult>;
|
|
81
90
|
createReflectionGeneration(input: CreateReflectionGenerationInput): Promise<ObservationalMemoryRecord>;
|
|
82
91
|
setReflectingFlag(id: string, isReflecting: boolean): Promise<void>;
|
|
83
92
|
setObservingFlag(id: string, isObserving: boolean): Promise<void>;
|
|
@@ -87,6 +96,7 @@ export declare class MemoryOracle extends MemoryStorage {
|
|
|
87
96
|
setPendingMessageTokens(id: string, tokenCount: number): Promise<void>;
|
|
88
97
|
updateObservationalMemoryConfig(input: UpdateObservationalMemoryConfigInput): Promise<void>;
|
|
89
98
|
updateBufferedObservations(input: UpdateBufferedObservationsInput): Promise<void>;
|
|
99
|
+
appendBufferedObservations(input: UpdateBufferedObservationsInput): Promise<UpdateBufferedObservationsResult>;
|
|
90
100
|
swapBufferedToActive(input: SwapBufferedToActiveInput): Promise<SwapBufferedToActiveResult>;
|
|
91
101
|
updateBufferedReflection(input: UpdateBufferedReflectionInput): Promise<void>;
|
|
92
102
|
swapBufferedReflectionToActive(input: SwapBufferedReflectionToActiveInput): Promise<ObservationalMemoryRecord>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,aAAa,EAKd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,iCAAiC,EACjC,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,oCAAoC,EACpC,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mCAAmC,EACnC,yBAAyB,EACzB,0BAA0B,EAE1B,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,oCAAoC,EACrC,MAAM,sBAAsB,CAAC;AAM9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAqDtD,qBAAa,YAAa,SAAQ,aAAa;IAC7C,SAAkB,2BAA2B,QAAQ;IACrD,QAAQ,CAAC,2BAA2B,QAAQ;IAC5C,QAAQ,CAAC,wCAAwC,QAAQ;IAEzD,MAAM,CAAC,QAAQ,CAAC,cAAc,oGAKnB;IAEX,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IAEjD,YAAY,MAAM,EAAE,kBAAkB,EAcrC;IAID,OAAO,KAAK,GAAG,GAkBd;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAEK,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzC;IAEK,aAAa,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAEtG;IAEK,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEhF;IAEK,YAAY,CAAC,IAAI,EAAE;QACvB,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,CAE7B;IAEK,YAAY,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;IAEK,sBAAsB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEvG;IAEK,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAElF;IAEK,gBAAgB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC,CAE/F;IAEK,YAAY,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAErF;IAEK,wBAAwB,CAAC,IAAI,EAAE,oCAAoC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAE7G;IAEK,YAAY,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC,CAElG;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;gBAAE,QAAQ,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;gBAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAA;aAAE,CAAC;SAC1G,CAAC,EAAE,CAAC;KACN,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAE7B;IAEK,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;IAEK,eAAe,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAEvF;IAEK,YAAY,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAExF;IAEK,cAAc,CAAC,IAAI,EAAE;QACzB,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,CAE/B;IAEK,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAqFlF;YAEa,gBAAgB;IA+BxB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAEnH;IAEK,6BAA6B,CACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,SAAK,EACV,OAAO,CAAC,EAAE,iCAAiC,GAC1C,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAEtC;IAEK,6BAA6B,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAE7G;IAEK,+BAA+B,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;IAEK,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;IAEK,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAE3G;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,CAEhH;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,CAEzF;IAEK,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;IAEK,+BAA+B,CAAC,KAAK,EAAE,oCAAoC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;IAEK,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;IAEK,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAEhG;IAEK,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;IAEK,8BAA8B,CAAC,KAAK,EAAE,mCAAmC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAEnH;CACF"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
|
+
import { type UpdateBufferedObservationsResult } from '../../../_types/@internal_core/dist/memory/index.js';
|
|
1
2
|
import type { ObservationalMemoryRecord, SwapBufferedReflectionToActiveInput, SwapBufferedToActiveInput, SwapBufferedToActiveResult, UpdateBufferedObservationsInput, UpdateBufferedReflectionInput } from '@mastra/core/storage';
|
|
2
3
|
import type { MemoryContext } from './utils.js';
|
|
3
|
-
export declare function updateBufferedObservations(ctx: MemoryContext, input: UpdateBufferedObservationsInput): Promise<
|
|
4
|
+
export declare function updateBufferedObservations(ctx: MemoryContext, input: UpdateBufferedObservationsInput): Promise<UpdateBufferedObservationsResult>;
|
|
4
5
|
export declare function swapBufferedToActive(ctx: MemoryContext, input: SwapBufferedToActiveInput): Promise<SwapBufferedToActiveResult>;
|
|
5
6
|
export declare function updateBufferedReflection(ctx: MemoryContext, input: UpdateBufferedReflectionInput): Promise<void>;
|
|
6
7
|
export declare function swapBufferedReflectionToActive(ctx: MemoryContext, input: SwapBufferedReflectionToActiveInput): Promise<ObservationalMemoryRecord>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"observational-buffering.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/observational-buffering.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"observational-buffering.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/observational-buffering.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gCAAgC,EACtC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAEV,yBAAyB,EACzB,mCAAmC,EACnC,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AA2B9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,CAAC,CAwD3C;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAgErC;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,yBAAyB,CAAC,CAyDpC"}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type UpdateActiveObservationsResult } from '../../../_types/@internal_core/dist/memory/index.js';
|
|
1
2
|
import type { CreateObservationalMemoryInput, CreateReflectionGenerationInput, ObservationalMemoryHistoryOptions, ObservationalMemoryRecord, UpdateActiveObservationsInput, UpdateObservationalMemoryConfigInput } from '@mastra/core/storage';
|
|
2
3
|
import type { Connection } from 'oracledb';
|
|
3
4
|
import type { MemoryContext } from './utils.js';
|
|
@@ -34,6 +35,7 @@ export type ObservationalMemoryRow = {
|
|
|
34
35
|
lastBufferedAtTokens?: number | string | null;
|
|
35
36
|
lastBufferedAtTime?: Date | string | null;
|
|
36
37
|
metadata?: unknown;
|
|
38
|
+
supersededBy?: string | null;
|
|
37
39
|
createdAt: Date | string;
|
|
38
40
|
updatedAt: Date | string;
|
|
39
41
|
};
|
|
@@ -41,8 +43,14 @@ export declare function getObservationalMemory(ctx: MemoryContext, threadId: str
|
|
|
41
43
|
export declare function getObservationalMemoryHistory(ctx: MemoryContext, threadId: string | null, resourceId: string, limit?: number, options?: ObservationalMemoryHistoryOptions): Promise<ObservationalMemoryRecord[]>;
|
|
42
44
|
export declare function initializeObservationalMemory(ctx: MemoryContext, input: CreateObservationalMemoryInput): Promise<ObservationalMemoryRecord>;
|
|
43
45
|
export declare function insertObservationalMemoryRecord(ctx: MemoryContext, record: ObservationalMemoryRecord): Promise<void>;
|
|
44
|
-
export declare function updateActiveObservations(ctx: MemoryContext, input: UpdateActiveObservationsInput): Promise<
|
|
46
|
+
export declare function updateActiveObservations(ctx: MemoryContext, input: UpdateActiveObservationsInput): Promise<UpdateActiveObservationsResult>;
|
|
45
47
|
export declare function createReflectionGeneration(ctx: MemoryContext, input: CreateReflectionGenerationInput): Promise<ObservationalMemoryRecord>;
|
|
48
|
+
/**
|
|
49
|
+
* Create the next generation from the stored (live, row-locked) record and retire it in the
|
|
50
|
+
* same transaction. Buffered chunks move to the new generation; the cursor, buffering markers,
|
|
51
|
+
* flags, and counters carry over; buffered reflection state does not.
|
|
52
|
+
*/
|
|
53
|
+
export declare function rollOverOMRow(ctx: MemoryContext, connection: Connection, stored: ObservationalMemoryRecord, observations: string, tokenCount: number, newRecordId: string | undefined): Promise<ObservationalMemoryRecord>;
|
|
46
54
|
export declare function setReflectingFlag(ctx: MemoryContext, id: string, isReflecting: boolean): Promise<void>;
|
|
47
55
|
export declare function setObservingFlag(ctx: MemoryContext, id: string, isObserving: boolean): Promise<void>;
|
|
48
56
|
export declare function setBufferingObservationFlag(ctx: MemoryContext, id: string, isBuffering: boolean, lastBufferedAtTokens?: number): Promise<void>;
|
|
@@ -53,4 +61,18 @@ export declare function updateObservationalMemoryConfig(ctx: MemoryContext, inpu
|
|
|
53
61
|
export declare function insertOMRecord(ctx: MemoryContext, connection: Connection, record: ObservationalMemoryRecord, timestamp?: Date): Promise<void>;
|
|
54
62
|
export declare function omSelect(): string;
|
|
55
63
|
export declare function parseOMRow(row: ObservationalMemoryRow): ObservationalMemoryRecord;
|
|
64
|
+
/** Row-locks one record by primary key for the rest of the transaction; `undefined` when missing. */
|
|
65
|
+
export declare function findOMRowForUpdate(ctx: MemoryContext, connection: Connection, id: string): Promise<ObservationalMemoryRow | undefined>;
|
|
66
|
+
/**
|
|
67
|
+
* Row-locks one record by primary key. Observational memory updates are incremental and
|
|
68
|
+
* order-sensitive, so mutating paths derive their next state from a locked row.
|
|
69
|
+
* Throws "record not found" when it is missing.
|
|
70
|
+
*/
|
|
71
|
+
export declare function lockOMRow(ctx: MemoryContext, connection: Connection, id: string, operation: string): Promise<ObservationalMemoryRow>;
|
|
72
|
+
/**
|
|
73
|
+
* The live, row-locked record a lifecycle write aimed at `row` lands on: `row` itself while
|
|
74
|
+
* live, otherwise the head of its lookup key (locked, then re-checked — a rollover may retire
|
|
75
|
+
* it between the head read and the lock).
|
|
76
|
+
*/
|
|
77
|
+
export declare function resolveLiveOMRow(ctx: MemoryContext, connection: Connection, row: ObservationalMemoryRow): Promise<ObservationalMemoryRow>;
|
|
56
78
|
//# sourceMappingURL=observational.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"observational.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/observational.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"observational.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/observational.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { Connection } from 'oracledb';
|
|
1
2
|
import type { MemoryContext } from './utils.js';
|
|
2
3
|
export declare const THREAD_RESOURCE_ID = "\"resourceId\"";
|
|
3
4
|
export declare const THREAD_CREATED_AT = "\"createdAt\"";
|
|
@@ -38,6 +39,16 @@ export declare const OM_LAST_BUFFERED_AT_TOKENS = "\"lastBufferedAtTokens\"";
|
|
|
38
39
|
export declare const OM_LAST_BUFFERED_AT_TIME = "\"lastBufferedAtTime\"";
|
|
39
40
|
export declare const OM_CREATED_AT = "\"createdAt\"";
|
|
40
41
|
export declare const OM_UPDATED_AT = "\"updatedAt\"";
|
|
42
|
+
export declare const OM_SUPERSEDED_BY = "\"supersededBy\"";
|
|
41
43
|
export declare function initMemorySchema(ctx: MemoryContext): Promise<void>;
|
|
44
|
+
/**
|
|
45
|
+
* Retire every live observational memory row that sorts after its key's canonical head
|
|
46
|
+
* (`generationCount DESC, createdAt ASC, id ASC`), marking it superseded by the head. Rows
|
|
47
|
+
* retired by older adapter versions (which never set `supersededBy`) become frozen. Idempotent.
|
|
48
|
+
* One statement: the head's ordering key is part of the condition, so a row created by a
|
|
49
|
+
* concurrent rollover (higher generation) never matches, and a row locked by one is
|
|
50
|
+
* re-evaluated after it commits.
|
|
51
|
+
*/
|
|
52
|
+
export declare function backfillObservationalMemorySupersededBy(ctx: MemoryContext, connection: Connection): Promise<void>;
|
|
42
53
|
export declare function clearAllMemoryTables(ctx: MemoryContext): Promise<void>;
|
|
43
54
|
//# sourceMappingURL=schema.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/schema.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAQ3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,eAAO,MAAM,kBAAkB,mBAAiB,CAAC;AACjD,eAAO,MAAM,iBAAiB,kBAAgB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,kBAAgB,CAAC;AAC/C,eAAO,MAAM,mBAAmB,mBAAiB,CAAC;AAClD,eAAO,MAAM,kBAAkB,kBAAgB,CAAC;AAChD,eAAO,MAAM,uBAAuB,sBAAoB,CAAC;AACzD,eAAO,MAAM,mBAAmB,kBAAgB,CAAC;AACjD,eAAO,MAAM,mBAAmB,kBAAgB,CAAC;AACjD,eAAO,MAAM,aAAa,kBAAgB,CAAC;AAC3C,eAAO,MAAM,QAAQ,cAAY,CAAC;AAClC,eAAO,MAAM,cAAc,mBAAiB,CAAC;AAC7C,eAAO,MAAM,YAAY,iBAAe,CAAC;AACzC,eAAO,MAAM,sBAAsB,2BAAyB,CAAC;AAC7D,eAAO,MAAM,qCAAqC,wCAAsC,CAAC;AACzF,eAAO,MAAM,cAAc,mBAAiB,CAAC;AAC7C,eAAO,MAAM,mBAAmB,wBAAsB,CAAC;AACvD,eAAO,MAAM,mBAAmB,uBAAqB,CAAC;AACtD,eAAO,MAAM,qBAAqB,yBAAuB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,6BAA2B,CAAC;AAClE,eAAO,MAAM,wBAAwB,4BAA0B,CAAC;AAChE,eAAO,MAAM,0BAA0B,8BAA4B,CAAC;AACpE,eAAO,MAAM,eAAe,oBAAkB,CAAC;AAC/C,eAAO,MAAM,gBAAgB,qBAAmB,CAAC;AACjD,eAAO,MAAM,uBAAuB,2BAAyB,CAAC;AAC9D,eAAO,MAAM,oBAAoB,yBAAuB,CAAC;AACzD,eAAO,MAAM,wBAAwB,6BAA2B,CAAC;AACjE,eAAO,MAAM,8BAA8B,kCAAgC,CAAC;AAC5E,eAAO,MAAM,uBAAuB,2BAAyB,CAAC;AAC9D,eAAO,MAAM,sBAAsB,2BAAyB,CAAC;AAC7D,eAAO,MAAM,6BAA6B,iCAA+B,CAAC;AAC1E,eAAO,MAAM,mCAAmC,sCAAoC,CAAC;AACrF,eAAO,MAAM,mCAAmC,sCAAoC,CAAC;AACrF,eAAO,MAAM,8BAA8B,kCAAgC,CAAC;AAC5E,eAAO,MAAM,2BAA2B,+BAA6B,CAAC;AACtE,eAAO,MAAM,0BAA0B,8BAA4B,CAAC;AACpE,eAAO,MAAM,0BAA0B,6BAA2B,CAAC;AACnE,eAAO,MAAM,wBAAwB,2BAAyB,CAAC;AAC/D,eAAO,MAAM,aAAa,kBAAgB,CAAC;AAC3C,eAAO,MAAM,aAAa,kBAAgB,CAAC;AAC3C,eAAO,MAAM,gBAAgB,qBAAmB,CAAC;AAEjD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE;AAED;;;;;;;GAOG;AACH,wBAAsB,uCAAuC,CAC3D,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5E"}
|
|
@@ -3,6 +3,7 @@ import { ErrorCategory } from '@mastra/core/error';
|
|
|
3
3
|
import type { IMastraLogger } from '@mastra/core/logger';
|
|
4
4
|
import type { MastraDBMessage, StorageThreadType } from '@mastra/core/memory';
|
|
5
5
|
import type { BufferedObservationChunk, StorageResourceType, ThreadOrderBy, ThreadSortDirection, StorageOrderBy } from '@mastra/core/storage';
|
|
6
|
+
import oracledb from 'oracledb';
|
|
6
7
|
import type { OracleDB, OracleCreateIndexOptions, OracleTxClient } from '../../db/index.js';
|
|
7
8
|
export declare const ORACLE_IN_LIMIT = 900;
|
|
8
9
|
export declare const EMPTY_STRING_SENTINEL = "__MASTRA_ORACLE_EMPTY_STRING__";
|
|
@@ -51,6 +52,12 @@ export declare function inClause(prefix: string, values: readonly string[]): {
|
|
|
51
52
|
binds: Record<string, unknown>;
|
|
52
53
|
};
|
|
53
54
|
export declare function chunkValues<T>(values: T[], size?: number): T[][];
|
|
55
|
+
/**
|
|
56
|
+
* Bind an instant as TIMESTAMP WITH TIME ZONE. A bare `Date` binds as TIMESTAMP WITH LOCAL
|
|
57
|
+
* TIME ZONE, which the server converts with the session's fixed offset (captured at connect
|
|
58
|
+
* time); an instant on the other side of a DST change is then stored shifted by an hour.
|
|
59
|
+
*/
|
|
60
|
+
export declare function timestampBind(value: Date | string | null | undefined): oracledb.BindParameter | null;
|
|
54
61
|
export declare function boolToNumber(value: boolean | undefined): number;
|
|
55
62
|
export declare function toBoolean(value: unknown): boolean;
|
|
56
63
|
export declare function numberOrZero(value: unknown): number;
|
|
@@ -58,7 +65,7 @@ export declare function optionalNumber(value: unknown): number | undefined;
|
|
|
58
65
|
export declare function stringOrEmpty(value: unknown): string;
|
|
59
66
|
export declare function emptyToUndefined(value: unknown): string | undefined;
|
|
60
67
|
export declare function optionalStringBind(value: string | null | undefined): string | null;
|
|
61
|
-
export declare function optionalClobStringBind(value: string | null | undefined):
|
|
68
|
+
export declare function optionalClobStringBind(value: string | null | undefined): oracledb.BindParameter | null;
|
|
62
69
|
export declare function parseOptionalString(value: unknown): string | undefined;
|
|
63
70
|
export declare function parseJson(value: unknown): Record<string, unknown>;
|
|
64
71
|
export declare function paginationClause(perPageInput: number | false | undefined, perPage: number, offset: number): string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACf,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/memory/utils.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAA0B,MAAM,MAAM,CAAC;AAUxD,OAAO,KAAK,EAAmB,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAA0B,MAAM,MAAM,CAAC;AAUxD,OAAO,KAAK,EAAmB,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAcjD,qBAAa,WAAY,SAAQ,oBAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;IAC5D,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,gBAAgB,CAAC,CAAmC;IAE5D,MAAM,EAAE,cAAc,CAAC;IAEvB,YAAY,MAAM,EAAE,iBAAiB,EA6CpC;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1B;IAEK,OAAO,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAUhD;YAEa,iBAAiB;IAOzB,cAAc,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAEvD;YAEa,aAAa;IA2B3B,OAAO,CAAC,iBAAiB;IAmFzB,OAAO,CAAC,uBAAuB;IA2BzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7B;IAED,cAAc,IAAI,iBAAiB,CAElC;IAED,IAAI,EAAE,IAAI,QAAQ,CAEjB;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAIhC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACjH,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/oracledb",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.2-alpha.0",
|
|
4
4
|
"description": "Oracle Database provider for Mastra storage and vector retrieval",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -33,8 +33,9 @@
|
|
|
33
33
|
"typescript": "^7.0.2",
|
|
34
34
|
"vitest": "4.1.11",
|
|
35
35
|
"@internal/lint": "0.0.142",
|
|
36
|
+
"@internal/core": "0.1.2",
|
|
36
37
|
"@internal/types-builder": "0.0.117",
|
|
37
|
-
"@mastra/core": "1.
|
|
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"
|