@framers/agentos 0.1.104 → 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.
Files changed (65) hide show
  1. package/dist/api/AgentOS.d.ts +80 -0
  2. package/dist/api/AgentOS.d.ts.map +1 -1
  3. package/dist/api/AgentOS.js +128 -9
  4. package/dist/api/AgentOS.js.map +1 -1
  5. package/dist/api/AgentOSOrchestrator.d.ts.map +1 -1
  6. package/dist/api/AgentOSOrchestrator.js +32 -4
  7. package/dist/api/AgentOSOrchestrator.js.map +1 -1
  8. package/dist/memory/AgentMemory.d.ts +62 -16
  9. package/dist/memory/AgentMemory.d.ts.map +1 -1
  10. package/dist/memory/AgentMemory.js +236 -28
  11. package/dist/memory/AgentMemory.js.map +1 -1
  12. package/dist/memory/consolidation/ConsolidationLoop.d.ts.map +1 -1
  13. package/dist/memory/consolidation/ConsolidationLoop.js +32 -9
  14. package/dist/memory/consolidation/ConsolidationLoop.js.map +1 -1
  15. package/dist/memory/extension/MemoryToolsExtension.d.ts +53 -0
  16. package/dist/memory/extension/MemoryToolsExtension.d.ts.map +1 -0
  17. package/dist/memory/extension/MemoryToolsExtension.js +54 -0
  18. package/dist/memory/extension/MemoryToolsExtension.js.map +1 -0
  19. package/dist/memory/extension/StandaloneMemoryExtension.d.ts +27 -0
  20. package/dist/memory/extension/StandaloneMemoryExtension.d.ts.map +1 -0
  21. package/dist/memory/extension/StandaloneMemoryExtension.js +122 -0
  22. package/dist/memory/extension/StandaloneMemoryExtension.js.map +1 -0
  23. package/dist/memory/facade/Memory.d.ts +45 -0
  24. package/dist/memory/facade/Memory.d.ts.map +1 -1
  25. package/dist/memory/facade/Memory.js +296 -137
  26. package/dist/memory/facade/Memory.js.map +1 -1
  27. package/dist/memory/facade/types.d.ts +12 -8
  28. package/dist/memory/facade/types.d.ts.map +1 -1
  29. package/dist/memory/feedback/RetrievalFeedbackSignal.d.ts +14 -5
  30. package/dist/memory/feedback/RetrievalFeedbackSignal.d.ts.map +1 -1
  31. package/dist/memory/feedback/RetrievalFeedbackSignal.js +131 -20
  32. package/dist/memory/feedback/RetrievalFeedbackSignal.js.map +1 -1
  33. package/dist/memory/index.d.ts +7 -1
  34. package/dist/memory/index.d.ts.map +1 -1
  35. package/dist/memory/index.js +5 -1
  36. package/dist/memory/index.js.map +1 -1
  37. package/dist/memory/integration/StandaloneMemoryBridge.d.ts +55 -0
  38. package/dist/memory/integration/StandaloneMemoryBridge.d.ts.map +1 -0
  39. package/dist/memory/integration/StandaloneMemoryBridge.js +398 -0
  40. package/dist/memory/integration/StandaloneMemoryBridge.js.map +1 -0
  41. package/dist/memory/io/CsvImporter.d.ts +51 -0
  42. package/dist/memory/io/CsvImporter.d.ts.map +1 -0
  43. package/dist/memory/io/CsvImporter.js +229 -0
  44. package/dist/memory/io/CsvImporter.js.map +1 -0
  45. package/dist/memory/io/index.d.ts +2 -0
  46. package/dist/memory/io/index.d.ts.map +1 -1
  47. package/dist/memory/io/index.js +2 -0
  48. package/dist/memory/io/index.js.map +1 -1
  49. package/dist/memory/store/tracePersistence.d.ts +68 -0
  50. package/dist/memory/store/tracePersistence.d.ts.map +1 -0
  51. package/dist/memory/store/tracePersistence.js +159 -0
  52. package/dist/memory/store/tracePersistence.js.map +1 -0
  53. package/dist/memory/tools/MemoryAddTool.d.ts.map +1 -1
  54. package/dist/memory/tools/MemoryAddTool.js +18 -6
  55. package/dist/memory/tools/MemoryAddTool.js.map +1 -1
  56. package/dist/memory/tools/MemoryMergeTool.d.ts.map +1 -1
  57. package/dist/memory/tools/MemoryMergeTool.js +41 -13
  58. package/dist/memory/tools/MemoryMergeTool.js.map +1 -1
  59. package/dist/memory/tools/MemorySearchTool.d.ts.map +1 -1
  60. package/dist/memory/tools/MemorySearchTool.js +24 -4
  61. package/dist/memory/tools/MemorySearchTool.js.map +1 -1
  62. package/dist/memory/tools/MemoryUpdateTool.d.ts.map +1 -1
  63. package/dist/memory/tools/MemoryUpdateTool.js +38 -16
  64. package/dist/memory/tools/MemoryUpdateTool.js.map +1 -1
  65. 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":"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"}
1
+ {"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../src/memory/facade/Memory.ts"],"names":[],"mappings":"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"}