@backendkit-labs/agent-core 0.36.1 → 0.36.2
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/agent-memory/MemorySystem.js +2 -2
- package/dist/agent-memory/MemorySystem.js.map +1 -1
- package/dist/agent-memory/ProceduralMemory.d.ts +7 -2
- package/dist/agent-memory/ProceduralMemory.d.ts.map +1 -1
- package/dist/agent-memory/ProceduralMemory.js +19 -2
- package/dist/agent-memory/ProceduralMemory.js.map +1 -1
- package/dist/agent-memory/SemanticMemory.d.ts +5 -2
- package/dist/agent-memory/SemanticMemory.d.ts.map +1 -1
- package/dist/agent-memory/SemanticMemory.js +8 -2
- package/dist/agent-memory/SemanticMemory.js.map +1 -1
- package/dist/agent-memory/types.d.ts +4 -0
- package/dist/agent-memory/types.d.ts.map +1 -1
- package/package.json +1 -1
|
@@ -32,8 +32,8 @@ class MemorySystem {
|
|
|
32
32
|
constructor(config = {}) {
|
|
33
33
|
this.config = config;
|
|
34
34
|
this.episodic = new EpisodicMemory_1.EpisodicMemory(config.episodic, config.retention);
|
|
35
|
-
this.semantic = new SemanticMemory_1.SemanticMemory(config.semantic);
|
|
36
|
-
this.procedural = new ProceduralMemory_1.ProceduralMemory(config.procedural);
|
|
35
|
+
this.semantic = new SemanticMemory_1.SemanticMemory(config.semantic, config.retention);
|
|
36
|
+
this.procedural = new ProceduralMemory_1.ProceduralMemory(config.procedural, config.retention);
|
|
37
37
|
}
|
|
38
38
|
/**
|
|
39
39
|
* Build a markdown context block combining relevant memories from all three tiers.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"MemorySystem.js","sourceRoot":"","sources":["../../src/agent-memory/MemorySystem.ts"],"names":[],"mappings":";;;AA0EA,gDAEC;AA3ED,qDAAkD;AAClD,qDAAkD;AAClD,yDAAsD;AACtD,mCAA2C;AAG3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,YAAY;IAKQ;IAJpB,QAAQ,CAAiB;IACzB,QAAQ,CAAiB;IACzB,UAAU,CAAmB;IAEtC,YAA6B,SAA6B,EAAE;QAA/B,WAAM,GAAN,MAAM,CAAyB;QACxD,IAAI,CAAC,QAAQ,GAAK,IAAI,+BAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAK,IAAI,+BAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"MemorySystem.js","sourceRoot":"","sources":["../../src/agent-memory/MemorySystem.ts"],"names":[],"mappings":";;;AA0EA,gDAEC;AA3ED,qDAAkD;AAClD,qDAAkD;AAClD,yDAAsD;AACtD,mCAA2C;AAG3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,YAAY;IAKQ;IAJpB,QAAQ,CAAiB;IACzB,QAAQ,CAAiB;IACzB,UAAU,CAAmB;IAEtC,YAA6B,SAA6B,EAAE;QAA/B,WAAM,GAAN,MAAM,CAAyB;QACxD,IAAI,CAAC,QAAQ,GAAK,IAAI,+BAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,GAAK,IAAI,+BAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,UAAU,GAAG,IAAI,mCAAgB,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAChF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAa;QACjC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpD,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACnD,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACpC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEvC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,2EAA2E;IAC3E,QAAQ;QACJ,OAAO,IAAA,wBAAgB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3E,CAAC;CACJ;AA9CD,oCA8CC;AAED,0CAA0C;AAC1C,SAAgB,kBAAkB,CAAC,MAA2B;IAC1D,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import type { Pattern, ProceduralConfig } from './types';
|
|
1
|
+
import type { Pattern, ProceduralConfig, RetentionConfig } from './types';
|
|
2
|
+
/** Patterns kept when `retention.maxPatterns` is not set. */
|
|
3
|
+
export declare const DEFAULT_MAX_PATTERNS = 1000;
|
|
2
4
|
/**
|
|
3
5
|
* Procedural memory — learned patterns from agent outcomes.
|
|
4
6
|
*
|
|
@@ -8,12 +10,15 @@ import type { Pattern, ProceduralConfig } from './types';
|
|
|
8
10
|
*/
|
|
9
11
|
export declare class ProceduralMemory {
|
|
10
12
|
private readonly backend;
|
|
11
|
-
|
|
13
|
+
private readonly maxPatterns;
|
|
14
|
+
constructor(cfg?: ProceduralConfig, retention?: RetentionConfig);
|
|
12
15
|
/**
|
|
13
16
|
* Record that a particular (trigger → action) pair produced the given outcome.
|
|
14
17
|
* Repeated calls for the same trigger+action increment the occurrence counter.
|
|
15
18
|
*/
|
|
16
19
|
learnPattern(trigger: string, action: string, outcome: 'success' | 'failure'): void;
|
|
20
|
+
/** Over the cap, drops the patterns that earned the least: fewest confirmations, then longest unseen. */
|
|
21
|
+
private prune;
|
|
17
22
|
/** Return patterns whose trigger keywords overlap with the given context. */
|
|
18
23
|
getRelevantPatterns(context: string, limit?: number): Pattern[];
|
|
19
24
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ProceduralMemory.d.ts","sourceRoot":"","sources":["../../src/agent-memory/ProceduralMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,OAAO,EAAE,gBAAgB,EAAgB,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"ProceduralMemory.d.ts","sourceRoot":"","sources":["../../src/agent-memory/ProceduralMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAsB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAK5G,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAU1C;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,GAAG,GAAE,gBAAqB,EAAE,SAAS,GAAE,eAAoB;IAOvE;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI;IA4BnF,yGAAyG;IACzG,OAAO,CAAC,KAAK;IAUb,6EAA6E;IAC7E,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,EAAE;IAc1D;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAuB1C,KAAK,IAAI,MAAM;CAClB"}
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.ProceduralMemory = void 0;
|
|
3
|
+
exports.ProceduralMemory = exports.DEFAULT_MAX_PATTERNS = void 0;
|
|
4
4
|
const crypto_1 = require("crypto");
|
|
5
5
|
const InMemoryStore_1 = require("./stores/InMemoryStore");
|
|
6
6
|
const JsonFileStore_1 = require("./stores/JsonFileStore");
|
|
7
7
|
const scoring_1 = require("./scoring");
|
|
8
|
+
/** Patterns kept when `retention.maxPatterns` is not set. */
|
|
9
|
+
exports.DEFAULT_MAX_PATTERNS = 1_000;
|
|
8
10
|
/**
|
|
9
11
|
* Procedural memory — learned patterns from agent outcomes.
|
|
10
12
|
*
|
|
@@ -14,7 +16,9 @@ const scoring_1 = require("./scoring");
|
|
|
14
16
|
*/
|
|
15
17
|
class ProceduralMemory {
|
|
16
18
|
backend;
|
|
17
|
-
|
|
19
|
+
maxPatterns;
|
|
20
|
+
constructor(cfg = {}, retention = {}) {
|
|
21
|
+
this.maxPatterns = retention.maxPatterns ?? exports.DEFAULT_MAX_PATTERNS;
|
|
18
22
|
this.backend = cfg.provider === 'json' && cfg.path
|
|
19
23
|
? new JsonFileStore_1.JsonFileStore(cfg.path)
|
|
20
24
|
: new InMemoryStore_1.InMemoryStore();
|
|
@@ -45,8 +49,21 @@ class ProceduralMemory {
|
|
|
45
49
|
lastSeen: new Date().toISOString(),
|
|
46
50
|
createdAt: new Date().toISOString(),
|
|
47
51
|
});
|
|
52
|
+
this.prune();
|
|
48
53
|
}
|
|
49
54
|
}
|
|
55
|
+
/** Over the cap, drops the patterns that earned the least: fewest confirmations, then longest unseen. */
|
|
56
|
+
prune() {
|
|
57
|
+
if (this.maxPatterns === Infinity || this.backend.count() <= this.maxPatterns)
|
|
58
|
+
return;
|
|
59
|
+
const all = this.backend.getAll();
|
|
60
|
+
const doomed = [...all]
|
|
61
|
+
.sort((a, b) => a.occurrences - b.occurrences || a.lastSeen.localeCompare(b.lastSeen))
|
|
62
|
+
.slice(0, all.length - this.maxPatterns)
|
|
63
|
+
.map(r => r.id);
|
|
64
|
+
if (doomed.length > 0)
|
|
65
|
+
this.backend.deleteByIds(doomed);
|
|
66
|
+
}
|
|
50
67
|
/** Return patterns whose trigger keywords overlap with the given context. */
|
|
51
68
|
getRelevantPatterns(context, limit = 5) {
|
|
52
69
|
return this.backend.getAll()
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ProceduralMemory.js","sourceRoot":"","sources":["../../src/agent-memory/ProceduralMemory.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAEpC,0DAAuD;AACvD,0DAAuD;AACvD,uCAAyC;
|
|
1
|
+
{"version":3,"file":"ProceduralMemory.js","sourceRoot":"","sources":["../../src/agent-memory/ProceduralMemory.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import type { Knowledge, SemanticConfig } from './types';
|
|
1
|
+
import type { Knowledge, RetentionConfig, SemanticConfig } from './types';
|
|
2
|
+
/** Entries kept when `retention.maxKnowledge` is not set. Each can carry an embedding of hundreds of floats. */
|
|
3
|
+
export declare const DEFAULT_MAX_KNOWLEDGE = 5000;
|
|
2
4
|
/**
|
|
3
5
|
* Semantic memory — a searchable knowledge base.
|
|
4
6
|
*
|
|
@@ -8,7 +10,8 @@ import type { Knowledge, SemanticConfig } from './types';
|
|
|
8
10
|
export declare class SemanticMemory {
|
|
9
11
|
private readonly backend;
|
|
10
12
|
private readonly embedFn;
|
|
11
|
-
|
|
13
|
+
private readonly maxKnowledge;
|
|
14
|
+
constructor(cfg?: SemanticConfig, retention?: RetentionConfig);
|
|
12
15
|
/** Store a piece of knowledge. Returns the new entry ID. */
|
|
13
16
|
index(content: string, metadata?: Record<string, string>): Promise<string>;
|
|
14
17
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SemanticMemory.d.ts","sourceRoot":"","sources":["../../src/agent-memory/SemanticMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAsB,cAAc,EAAgB,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"SemanticMemory.d.ts","sourceRoot":"","sources":["../../src/agent-memory/SemanticMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAsB,eAAe,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAC;AAK5G,gHAAgH;AAChH,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAQ3C;;;;;GAKG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,GAAG,GAAE,cAAmB,EAAE,SAAS,GAAE,eAAoB;IAQrE,4DAA4D;IACtD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcpF;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoB5D,KAAK,IAAI,MAAM;CAClB"}
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.SemanticMemory = void 0;
|
|
3
|
+
exports.SemanticMemory = exports.DEFAULT_MAX_KNOWLEDGE = void 0;
|
|
4
4
|
const crypto_1 = require("crypto");
|
|
5
5
|
const InMemoryStore_1 = require("./stores/InMemoryStore");
|
|
6
6
|
const JsonFileStore_1 = require("./stores/JsonFileStore");
|
|
7
7
|
const scoring_1 = require("./scoring");
|
|
8
|
+
/** Entries kept when `retention.maxKnowledge` is not set. Each can carry an embedding of hundreds of floats. */
|
|
9
|
+
exports.DEFAULT_MAX_KNOWLEDGE = 5_000;
|
|
8
10
|
/**
|
|
9
11
|
* Semantic memory — a searchable knowledge base.
|
|
10
12
|
*
|
|
@@ -14,7 +16,9 @@ const scoring_1 = require("./scoring");
|
|
|
14
16
|
class SemanticMemory {
|
|
15
17
|
backend;
|
|
16
18
|
embedFn;
|
|
17
|
-
|
|
19
|
+
maxKnowledge;
|
|
20
|
+
constructor(cfg = {}, retention = {}) {
|
|
21
|
+
this.maxKnowledge = retention.maxKnowledge ?? exports.DEFAULT_MAX_KNOWLEDGE;
|
|
18
22
|
this.backend = cfg.provider === 'json' && cfg.path
|
|
19
23
|
? new JsonFileStore_1.JsonFileStore(cfg.path)
|
|
20
24
|
: new InMemoryStore_1.InMemoryStore();
|
|
@@ -31,6 +35,8 @@ class SemanticMemory {
|
|
|
31
35
|
...(embedding ? { embedding } : {}),
|
|
32
36
|
createdAt: new Date().toISOString(),
|
|
33
37
|
});
|
|
38
|
+
if (this.maxKnowledge < Infinity)
|
|
39
|
+
this.backend.deleteOldest(this.maxKnowledge);
|
|
34
40
|
return id;
|
|
35
41
|
}
|
|
36
42
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SemanticMemory.js","sourceRoot":"","sources":["../../src/agent-memory/SemanticMemory.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AAEpC,0DAAuD;AACvD,0DAAuD;AACvD,uCAAiD;
|
|
1
|
+
{"version":3,"file":"SemanticMemory.js","sourceRoot":"","sources":["../../src/agent-memory/SemanticMemory.ts"],"names":[],"mappings":"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"}
|
|
@@ -62,6 +62,10 @@ export interface ProceduralConfig {
|
|
|
62
62
|
export interface RetentionConfig {
|
|
63
63
|
/** Maximum number of episodes to keep. Oldest are pruned when exceeded. */
|
|
64
64
|
maxEpisodes?: number;
|
|
65
|
+
/** Maximum number of semantic-memory entries (oldest are pruned). Default 5000; `Infinity` removes the cap. */
|
|
66
|
+
maxKnowledge?: number;
|
|
67
|
+
/** Maximum number of learned patterns (least confirmed, then least recently seen, are pruned). Default 1000; `Infinity` removes the cap. */
|
|
68
|
+
maxPatterns?: number;
|
|
65
69
|
/**
|
|
66
70
|
* After this many new episodes, trigger summarization (requires summarizeFn).
|
|
67
71
|
* The resulting summary is stored as a new episode tagged 'summary'.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-memory/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,IAAI,CAAC;CAClB;AAID,iDAAiD;AACjD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,6FAA6F;IAC7F,UAAU,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC3C,MAAM,IAAI,YAAY,EAAE,CAAC;IACzB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,MAAM,CAAC;CACnB;AAID,2FAA2F;AAC3F,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAInE,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B"}
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-memory/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,IAAI,CAAC;CAClB;AAID,iDAAiD;AACjD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,6FAA6F;IAC7F,UAAU,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC3C,MAAM,IAAI,YAAY,EAAE,CAAC;IACzB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,MAAM,CAAC;CACnB;AAID,2FAA2F;AAC3F,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAInE,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+GAA+G;IAC/G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4IAA4I;IAC5I,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B"}
|