@framers/agentos 0.1.105 → 0.1.106
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/api/AgentOS.d.ts +80 -0
- package/dist/api/AgentOS.d.ts.map +1 -1
- package/dist/api/AgentOS.js +128 -9
- package/dist/api/AgentOS.js.map +1 -1
- package/dist/api/AgentOSOrchestrator.d.ts.map +1 -1
- package/dist/api/AgentOSOrchestrator.js +32 -4
- package/dist/api/AgentOSOrchestrator.js.map +1 -1
- package/dist/memory/AgentMemory.d.ts +62 -16
- package/dist/memory/AgentMemory.d.ts.map +1 -1
- package/dist/memory/AgentMemory.js +236 -28
- package/dist/memory/AgentMemory.js.map +1 -1
- package/dist/memory/consolidation/ConsolidationLoop.d.ts.map +1 -1
- package/dist/memory/consolidation/ConsolidationLoop.js +32 -9
- package/dist/memory/consolidation/ConsolidationLoop.js.map +1 -1
- package/dist/memory/extension/MemoryToolsExtension.d.ts +53 -0
- package/dist/memory/extension/MemoryToolsExtension.d.ts.map +1 -0
- package/dist/memory/extension/MemoryToolsExtension.js +54 -0
- package/dist/memory/extension/MemoryToolsExtension.js.map +1 -0
- package/dist/memory/extension/StandaloneMemoryExtension.d.ts +27 -0
- package/dist/memory/extension/StandaloneMemoryExtension.d.ts.map +1 -0
- package/dist/memory/extension/StandaloneMemoryExtension.js +122 -0
- package/dist/memory/extension/StandaloneMemoryExtension.js.map +1 -0
- package/dist/memory/facade/Memory.d.ts +45 -0
- package/dist/memory/facade/Memory.d.ts.map +1 -1
- package/dist/memory/facade/Memory.js +296 -137
- package/dist/memory/facade/Memory.js.map +1 -1
- package/dist/memory/facade/types.d.ts +12 -8
- package/dist/memory/facade/types.d.ts.map +1 -1
- package/dist/memory/feedback/RetrievalFeedbackSignal.d.ts +14 -5
- package/dist/memory/feedback/RetrievalFeedbackSignal.d.ts.map +1 -1
- package/dist/memory/feedback/RetrievalFeedbackSignal.js +131 -20
- package/dist/memory/feedback/RetrievalFeedbackSignal.js.map +1 -1
- package/dist/memory/index.d.ts +7 -1
- package/dist/memory/index.d.ts.map +1 -1
- package/dist/memory/index.js +5 -1
- package/dist/memory/index.js.map +1 -1
- package/dist/memory/integration/StandaloneMemoryBridge.d.ts +55 -0
- package/dist/memory/integration/StandaloneMemoryBridge.d.ts.map +1 -0
- package/dist/memory/integration/StandaloneMemoryBridge.js +398 -0
- package/dist/memory/integration/StandaloneMemoryBridge.js.map +1 -0
- package/dist/memory/io/CsvImporter.d.ts +51 -0
- package/dist/memory/io/CsvImporter.d.ts.map +1 -0
- package/dist/memory/io/CsvImporter.js +229 -0
- package/dist/memory/io/CsvImporter.js.map +1 -0
- package/dist/memory/io/index.d.ts +2 -0
- package/dist/memory/io/index.d.ts.map +1 -1
- package/dist/memory/io/index.js +2 -0
- package/dist/memory/io/index.js.map +1 -1
- package/dist/memory/store/tracePersistence.d.ts +68 -0
- package/dist/memory/store/tracePersistence.d.ts.map +1 -0
- package/dist/memory/store/tracePersistence.js +159 -0
- package/dist/memory/store/tracePersistence.js.map +1 -0
- package/dist/memory/tools/MemoryAddTool.d.ts.map +1 -1
- package/dist/memory/tools/MemoryAddTool.js +18 -6
- package/dist/memory/tools/MemoryAddTool.js.map +1 -1
- package/dist/memory/tools/MemoryMergeTool.d.ts.map +1 -1
- package/dist/memory/tools/MemoryMergeTool.js +41 -13
- package/dist/memory/tools/MemoryMergeTool.js.map +1 -1
- package/dist/memory/tools/MemorySearchTool.d.ts.map +1 -1
- package/dist/memory/tools/MemorySearchTool.js +24 -4
- package/dist/memory/tools/MemorySearchTool.js.map +1 -1
- package/dist/memory/tools/MemoryUpdateTool.d.ts.map +1 -1
- package/dist/memory/tools/MemoryUpdateTool.js +38 -16
- package/dist/memory/tools/MemoryUpdateTool.js.map +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Extension-pack helpers for exposing the standalone SQLite
|
|
3
|
+
* memory editor tools through the AgentOS extension system.
|
|
4
|
+
*
|
|
5
|
+
* The underlying tools already exist as `ITool` implementations; this module
|
|
6
|
+
* adapts them into `tool` descriptors and extension packs so they can be
|
|
7
|
+
* loaded through `ExtensionManager`, which is the same registry path consumed
|
|
8
|
+
* by `ToolExecutor` and `ToolOrchestrator`.
|
|
9
|
+
*
|
|
10
|
+
* @module agentos/memory/extension/MemoryToolsExtension
|
|
11
|
+
*/
|
|
12
|
+
import { EXTENSION_KIND_TOOL, } from '../../extensions/types.js';
|
|
13
|
+
function toToolDescriptor(tool, priority) {
|
|
14
|
+
return {
|
|
15
|
+
id: tool.name,
|
|
16
|
+
kind: EXTENSION_KIND_TOOL,
|
|
17
|
+
...(priority !== undefined ? { priority } : {}),
|
|
18
|
+
payload: tool,
|
|
19
|
+
metadata: {
|
|
20
|
+
toolId: tool.id,
|
|
21
|
+
origin: 'memory-tools-pack',
|
|
22
|
+
category: tool.category ?? 'memory',
|
|
23
|
+
},
|
|
24
|
+
onDeactivate: async () => {
|
|
25
|
+
if (typeof tool.shutdown === 'function') {
|
|
26
|
+
await tool.shutdown();
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Convert a standalone `Memory` facade's built-in tool set into extension
|
|
33
|
+
* descriptors that can be registered directly with `ExtensionManager`.
|
|
34
|
+
*/
|
|
35
|
+
export function createMemoryToolDescriptors(memory, options) {
|
|
36
|
+
return memory
|
|
37
|
+
.createTools({ includeReflect: options?.includeReflect })
|
|
38
|
+
.map((tool) => toToolDescriptor(tool, options?.priority));
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Create an `ExtensionPack` exposing the standalone memory editor tools.
|
|
42
|
+
*
|
|
43
|
+
* Loading the returned pack through `ExtensionManager` makes the tools
|
|
44
|
+
* immediately visible to `ToolExecutor`/`ToolOrchestrator` because they all
|
|
45
|
+
* share the same `tool` registry.
|
|
46
|
+
*/
|
|
47
|
+
export function createMemoryToolsPack(memory, options) {
|
|
48
|
+
return {
|
|
49
|
+
name: options?.name ?? 'agentos-memory-tools',
|
|
50
|
+
version: options?.version ?? '1.0.0',
|
|
51
|
+
descriptors: createMemoryToolDescriptors(memory, options),
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=MemoryToolsExtension.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MemoryToolsExtension.js","sourceRoot":"","sources":["../../../src/memory/extension/MemoryToolsExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,mBAAmB,GAEpB,MAAM,2BAA2B,CAAC;AAgCnC,SAAS,gBAAgB,CAAC,IAAW,EAAE,QAAiB;IACtD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,IAAI;QACb,IAAI,EAAE,mBAAmB;QACzB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,MAAM,EAAE,mBAAmB;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;SACpC;QACD,YAAY,EAAE,KAAK,IAAI,EAAE;YACvB,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAmC,EACnC,OAA0E;IAE1E,OAAO,MAAM;SACV,WAAW,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmC,EACnC,OAAqC;IAErC,OAAO;QACL,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,sBAAsB;QAC7C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO;QACpC,WAAW,EAAE,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC;KAC1D,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Extension registration for the standalone SQLite-first
|
|
3
|
+
* `Memory` facade.
|
|
4
|
+
*
|
|
5
|
+
* This exposes the facade through the generic `memory-provider` extension kind
|
|
6
|
+
* so hosts can treat it like any other pluggable memory backend.
|
|
7
|
+
*
|
|
8
|
+
* @module agentos/memory/extension/StandaloneMemoryExtension
|
|
9
|
+
*/
|
|
10
|
+
import { type MemoryProviderPayload, type MemoryProviderDescriptor } from '../../extensions/types.js';
|
|
11
|
+
export interface StandaloneMemoryDescriptorOptions {
|
|
12
|
+
/**
|
|
13
|
+
* When true, the descriptor's `shutdown()` will close the configured
|
|
14
|
+
* `Memory` instance.
|
|
15
|
+
* @default false
|
|
16
|
+
*/
|
|
17
|
+
manageLifecycle?: boolean;
|
|
18
|
+
/**
|
|
19
|
+
* Optional payload overrides.
|
|
20
|
+
*/
|
|
21
|
+
overrides?: Partial<MemoryProviderPayload>;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* Create a `memory-provider` descriptor for the standalone `Memory` facade.
|
|
25
|
+
*/
|
|
26
|
+
export declare function createStandaloneMemoryDescriptor(options?: StandaloneMemoryDescriptorOptions): MemoryProviderDescriptor;
|
|
27
|
+
//# sourceMappingURL=StandaloneMemoryExtension.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"StandaloneMemoryExtension.d.ts","sourceRoot":"","sources":["../../../src/memory/extension/StandaloneMemoryExtension.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAqBnC,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5C;AAwDD;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,CAAC,EAAE,iCAAiC,GAC1C,wBAAwB,CAsE1B"}
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Extension registration for the standalone SQLite-first
|
|
3
|
+
* `Memory` facade.
|
|
4
|
+
*
|
|
5
|
+
* This exposes the facade through the generic `memory-provider` extension kind
|
|
6
|
+
* so hosts can treat it like any other pluggable memory backend.
|
|
7
|
+
*
|
|
8
|
+
* @module agentos/memory/extension/StandaloneMemoryExtension
|
|
9
|
+
*/
|
|
10
|
+
import { EXTENSION_KIND_MEMORY_PROVIDER, } from '../../extensions/types.js';
|
|
11
|
+
function isRuntimeMemory(value) {
|
|
12
|
+
return (typeof value === 'object' &&
|
|
13
|
+
value !== null &&
|
|
14
|
+
typeof value.remember === 'function' &&
|
|
15
|
+
typeof value.recall === 'function' &&
|
|
16
|
+
typeof value.forget === 'function' &&
|
|
17
|
+
typeof value.health === 'function');
|
|
18
|
+
}
|
|
19
|
+
function parseStoreInput(data) {
|
|
20
|
+
if (typeof data === 'string') {
|
|
21
|
+
return { content: data };
|
|
22
|
+
}
|
|
23
|
+
if (typeof data !== 'object' || data === null) {
|
|
24
|
+
throw new Error('Standalone memory store() expects a string or { content, options? }.');
|
|
25
|
+
}
|
|
26
|
+
const parsed = data;
|
|
27
|
+
if (typeof parsed.content !== 'string' || !parsed.content.trim()) {
|
|
28
|
+
throw new Error('Standalone memory store() requires a non-empty content string.');
|
|
29
|
+
}
|
|
30
|
+
return {
|
|
31
|
+
content: parsed.content,
|
|
32
|
+
options: parsed.options,
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
function parseQueryInput(query) {
|
|
36
|
+
if (typeof query === 'string') {
|
|
37
|
+
return { text: query };
|
|
38
|
+
}
|
|
39
|
+
if (typeof query !== 'object' || query === null) {
|
|
40
|
+
throw new Error('Standalone memory query() expects a string or { text|query, options? }.');
|
|
41
|
+
}
|
|
42
|
+
const parsed = query;
|
|
43
|
+
const text = parsed.text ?? parsed.query;
|
|
44
|
+
if (typeof text !== 'string' || !text.trim()) {
|
|
45
|
+
throw new Error('Standalone memory query() requires a non-empty query string.');
|
|
46
|
+
}
|
|
47
|
+
return {
|
|
48
|
+
text,
|
|
49
|
+
options: parsed.options,
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Create a `memory-provider` descriptor for the standalone `Memory` facade.
|
|
54
|
+
*/
|
|
55
|
+
export function createStandaloneMemoryDescriptor(options) {
|
|
56
|
+
let memory = null;
|
|
57
|
+
const payload = {
|
|
58
|
+
name: 'standalone-memory',
|
|
59
|
+
description: 'SQLite-first standalone memory facade with remember/recall, document ingestion, and self-improving consolidation support.',
|
|
60
|
+
supportedTypes: ['episodic', 'semantic', 'procedural', 'prospective'],
|
|
61
|
+
initialize: async (config) => {
|
|
62
|
+
const candidate = config.memory;
|
|
63
|
+
if (!isRuntimeMemory(candidate)) {
|
|
64
|
+
throw new Error('Standalone memory provider requires initialize({ memory }) with remember()/recall()/forget()/health() methods.');
|
|
65
|
+
}
|
|
66
|
+
memory = candidate;
|
|
67
|
+
},
|
|
68
|
+
store: async (_collectionId, data) => {
|
|
69
|
+
if (!memory) {
|
|
70
|
+
throw new Error('Standalone memory provider not initialized.');
|
|
71
|
+
}
|
|
72
|
+
const input = parseStoreInput(data);
|
|
73
|
+
const trace = await memory.remember(input.content, input.options);
|
|
74
|
+
return trace.id;
|
|
75
|
+
},
|
|
76
|
+
query: async (_collectionId, query) => {
|
|
77
|
+
if (!memory) {
|
|
78
|
+
throw new Error('Standalone memory provider not initialized.');
|
|
79
|
+
}
|
|
80
|
+
const input = parseQueryInput(query);
|
|
81
|
+
return (await memory.recall(input.text, input.options));
|
|
82
|
+
},
|
|
83
|
+
delete: async (_collectionId, ids) => {
|
|
84
|
+
if (!memory) {
|
|
85
|
+
throw new Error('Standalone memory provider not initialized.');
|
|
86
|
+
}
|
|
87
|
+
await Promise.all(ids.map((id) => memory.forget(id)));
|
|
88
|
+
},
|
|
89
|
+
getStats: async () => {
|
|
90
|
+
if (!memory) {
|
|
91
|
+
throw new Error('Standalone memory provider not initialized.');
|
|
92
|
+
}
|
|
93
|
+
const health = await memory.health();
|
|
94
|
+
return {
|
|
95
|
+
collections: Object.keys(health.tracesPerScope ?? {}).length,
|
|
96
|
+
documents: health.activeTraces,
|
|
97
|
+
size: health.totalTraces,
|
|
98
|
+
};
|
|
99
|
+
},
|
|
100
|
+
shutdown: async () => {
|
|
101
|
+
if (!memory)
|
|
102
|
+
return;
|
|
103
|
+
if (options?.manageLifecycle) {
|
|
104
|
+
await memory.close?.();
|
|
105
|
+
}
|
|
106
|
+
memory = null;
|
|
107
|
+
},
|
|
108
|
+
...options?.overrides,
|
|
109
|
+
};
|
|
110
|
+
return {
|
|
111
|
+
id: 'agentos-standalone-memory',
|
|
112
|
+
kind: EXTENSION_KIND_MEMORY_PROVIDER,
|
|
113
|
+
priority: 100,
|
|
114
|
+
enableByDefault: true,
|
|
115
|
+
payload,
|
|
116
|
+
metadata: {
|
|
117
|
+
version: '1.0.0',
|
|
118
|
+
runtime: 'sqlite-first-memory-facade',
|
|
119
|
+
},
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
//# sourceMappingURL=StandaloneMemoryExtension.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"StandaloneMemoryExtension.js","sourceRoot":"","sources":["../../../src/memory/extension/StandaloneMemoryExtension.ts"],"names":[],"mappings":"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"}
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
* @module memory/facade/Memory
|
|
19
19
|
*/
|
|
20
20
|
import type { MemoryTrace } from '../types.js';
|
|
21
|
+
import type { ITool } from '../../core/tools/ITool.js';
|
|
21
22
|
import type { MemoryConfig, RememberOptions, RecallOptions, IngestOptions, IngestResult, ExportOptions, ImportOptions, ImportResult, ConsolidationResult, MemoryHealth } from './types.js';
|
|
22
23
|
import type { IKnowledgeGraph, KnowledgeEntity, KnowledgeRelation } from '../../core/knowledge/IKnowledgeGraph.js';
|
|
23
24
|
/**
|
|
@@ -198,6 +199,26 @@ export declare class Memory {
|
|
|
198
199
|
* @returns Summary of the import operation.
|
|
199
200
|
*/
|
|
200
201
|
importFrom(source: string, options?: ImportOptions): Promise<ImportResult>;
|
|
202
|
+
/**
|
|
203
|
+
* Create runtime `ITool` instances backed by this memory facade's SQLite brain.
|
|
204
|
+
*
|
|
205
|
+
* This is the supported bridge from the standalone memory engine into
|
|
206
|
+
* AgentOS tool registration. The returned tools share this `Memory`
|
|
207
|
+
* instance's underlying SQLite database and consolidation loop.
|
|
208
|
+
*
|
|
209
|
+
* Typical usage:
|
|
210
|
+
* ```ts
|
|
211
|
+
* for (const tool of memory.createTools()) {
|
|
212
|
+
* await agentos.getToolOrchestrator().registerTool(tool);
|
|
213
|
+
* }
|
|
214
|
+
* ```
|
|
215
|
+
*
|
|
216
|
+
* When self-improvement is disabled, `memory_reflect` is omitted because
|
|
217
|
+
* there is no backing {@link ConsolidationLoop} instance.
|
|
218
|
+
*/
|
|
219
|
+
createTools(options?: {
|
|
220
|
+
includeReflect?: boolean;
|
|
221
|
+
}): ITool[];
|
|
201
222
|
/**
|
|
202
223
|
* Return a health snapshot of the memory store.
|
|
203
224
|
*
|
|
@@ -216,6 +237,30 @@ export declare class Memory {
|
|
|
216
237
|
* Convert a raw `memory_traces` row into a `MemoryTrace` object.
|
|
217
238
|
*/
|
|
218
239
|
private _buildTrace;
|
|
240
|
+
/**
|
|
241
|
+
* Find an active trace previously stored with the same content hash.
|
|
242
|
+
*
|
|
243
|
+
* Checks both the facade-native `content_hash` metadata key and the
|
|
244
|
+
* importer-used `import_hash` key so dedup works across facade and import
|
|
245
|
+
* workflows.
|
|
246
|
+
*/
|
|
247
|
+
private _findExistingTraceByHash;
|
|
248
|
+
/**
|
|
249
|
+
* Apply spaced-repetition access updates to recalled rows and persist the
|
|
250
|
+
* updated retrieval metadata back to SQLite.
|
|
251
|
+
*/
|
|
252
|
+
private _applyRecallAccessUpdates;
|
|
253
|
+
/**
|
|
254
|
+
* Persist one loaded document into the documents/chunks/traces tables.
|
|
255
|
+
*
|
|
256
|
+
* Document-level dedup is keyed by `documents.content_hash`, so re-ingesting
|
|
257
|
+
* the same source content is idempotent.
|
|
258
|
+
*/
|
|
259
|
+
private _ingestLoadedDocument;
|
|
260
|
+
/**
|
|
261
|
+
* Rebuild the external-content FTS index after bulk import operations.
|
|
262
|
+
*/
|
|
263
|
+
private _rebuildFtsIndex;
|
|
219
264
|
/**
|
|
220
265
|
* Detect the export format from options or file extension.
|
|
221
266
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../src/memory/facade/Memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,
|
|
1
|
+
{"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../src/memory/facade/Memory.ts"],"names":[],"mappings":"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"}
|