@framers/agentos 0.1.101 → 0.1.103

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 (184) hide show
  1. package/README.md +16 -0
  2. package/dist/api/agency.js +1 -1
  3. package/dist/api/agency.js.map +1 -1
  4. package/dist/api/strategies/graph.d.ts.map +1 -1
  5. package/dist/api/strategies/graph.js +1 -0
  6. package/dist/api/strategies/graph.js.map +1 -1
  7. package/dist/api/strategies/sequential.d.ts.map +1 -1
  8. package/dist/api/strategies/sequential.js +1 -0
  9. package/dist/api/strategies/sequential.js.map +1 -1
  10. package/dist/memory/config.d.ts +39 -0
  11. package/dist/memory/config.d.ts.map +1 -1
  12. package/dist/memory/config.js.map +1 -1
  13. package/dist/memory/consolidation/ConsolidationLoop.d.ts +177 -0
  14. package/dist/memory/consolidation/ConsolidationLoop.d.ts.map +1 -0
  15. package/dist/memory/consolidation/ConsolidationLoop.js +517 -0
  16. package/dist/memory/consolidation/ConsolidationLoop.js.map +1 -0
  17. package/dist/memory/consolidation/ConsolidationPipeline.d.ts.map +1 -1
  18. package/dist/memory/consolidation/ConsolidationPipeline.js +7 -0
  19. package/dist/memory/consolidation/ConsolidationPipeline.js.map +1 -1
  20. package/dist/memory/consolidation/index.d.ts +8 -0
  21. package/dist/memory/consolidation/index.d.ts.map +1 -0
  22. package/dist/memory/consolidation/index.js +7 -0
  23. package/dist/memory/consolidation/index.js.map +1 -0
  24. package/dist/memory/decay/DecayModel.d.ts +33 -0
  25. package/dist/memory/decay/DecayModel.d.ts.map +1 -1
  26. package/dist/memory/decay/DecayModel.js +31 -0
  27. package/dist/memory/decay/DecayModel.js.map +1 -1
  28. package/dist/memory/facade/Memory.d.ts +228 -0
  29. package/dist/memory/facade/Memory.d.ts.map +1 -0
  30. package/dist/memory/facade/Memory.js +823 -0
  31. package/dist/memory/facade/Memory.js.map +1 -0
  32. package/dist/memory/facade/index.d.ts +13 -0
  33. package/dist/memory/facade/index.d.ts.map +1 -0
  34. package/dist/memory/facade/index.js +11 -0
  35. package/dist/memory/facade/index.js.map +1 -0
  36. package/dist/memory/facade/types.d.ts +606 -0
  37. package/dist/memory/facade/types.d.ts.map +1 -0
  38. package/dist/memory/facade/types.js +11 -0
  39. package/dist/memory/facade/types.js.map +1 -0
  40. package/dist/memory/feedback/RetrievalFeedbackSignal.d.ts +132 -0
  41. package/dist/memory/feedback/RetrievalFeedbackSignal.d.ts.map +1 -0
  42. package/dist/memory/feedback/RetrievalFeedbackSignal.js +178 -0
  43. package/dist/memory/feedback/RetrievalFeedbackSignal.js.map +1 -0
  44. package/dist/memory/feedback/index.d.ts +13 -0
  45. package/dist/memory/feedback/index.d.ts.map +1 -0
  46. package/dist/memory/feedback/index.js +12 -0
  47. package/dist/memory/feedback/index.js.map +1 -0
  48. package/dist/memory/index.d.ts +22 -0
  49. package/dist/memory/index.d.ts.map +1 -1
  50. package/dist/memory/index.js +24 -0
  51. package/dist/memory/index.js.map +1 -1
  52. package/dist/memory/ingestion/ChunkingEngine.d.ts +143 -0
  53. package/dist/memory/ingestion/ChunkingEngine.d.ts.map +1 -0
  54. package/dist/memory/ingestion/ChunkingEngine.js +508 -0
  55. package/dist/memory/ingestion/ChunkingEngine.js.map +1 -0
  56. package/dist/memory/ingestion/DoclingLoader.d.ts +44 -0
  57. package/dist/memory/ingestion/DoclingLoader.d.ts.map +1 -0
  58. package/dist/memory/ingestion/DoclingLoader.js +228 -0
  59. package/dist/memory/ingestion/DoclingLoader.js.map +1 -0
  60. package/dist/memory/ingestion/DocxLoader.d.ts +37 -0
  61. package/dist/memory/ingestion/DocxLoader.d.ts.map +1 -0
  62. package/dist/memory/ingestion/DocxLoader.js +111 -0
  63. package/dist/memory/ingestion/DocxLoader.js.map +1 -0
  64. package/dist/memory/ingestion/FolderScanner.d.ts +116 -0
  65. package/dist/memory/ingestion/FolderScanner.d.ts.map +1 -0
  66. package/dist/memory/ingestion/FolderScanner.js +127 -0
  67. package/dist/memory/ingestion/FolderScanner.js.map +1 -0
  68. package/dist/memory/ingestion/HtmlLoader.d.ts +49 -0
  69. package/dist/memory/ingestion/HtmlLoader.d.ts.map +1 -0
  70. package/dist/memory/ingestion/HtmlLoader.js +202 -0
  71. package/dist/memory/ingestion/HtmlLoader.js.map +1 -0
  72. package/dist/memory/ingestion/IDocumentLoader.d.ts +63 -0
  73. package/dist/memory/ingestion/IDocumentLoader.d.ts.map +1 -0
  74. package/dist/memory/ingestion/IDocumentLoader.js +11 -0
  75. package/dist/memory/ingestion/IDocumentLoader.js.map +1 -0
  76. package/dist/memory/ingestion/LoaderRegistry.d.ts +140 -0
  77. package/dist/memory/ingestion/LoaderRegistry.d.ts.map +1 -0
  78. package/dist/memory/ingestion/LoaderRegistry.js +229 -0
  79. package/dist/memory/ingestion/LoaderRegistry.js.map +1 -0
  80. package/dist/memory/ingestion/MarkdownLoader.d.ts +50 -0
  81. package/dist/memory/ingestion/MarkdownLoader.d.ts.map +1 -0
  82. package/dist/memory/ingestion/MarkdownLoader.js +169 -0
  83. package/dist/memory/ingestion/MarkdownLoader.js.map +1 -0
  84. package/dist/memory/ingestion/MultimodalAggregator.d.ts +88 -0
  85. package/dist/memory/ingestion/MultimodalAggregator.d.ts.map +1 -0
  86. package/dist/memory/ingestion/MultimodalAggregator.js +96 -0
  87. package/dist/memory/ingestion/MultimodalAggregator.js.map +1 -0
  88. package/dist/memory/ingestion/OcrPdfLoader.d.ts +41 -0
  89. package/dist/memory/ingestion/OcrPdfLoader.d.ts.map +1 -0
  90. package/dist/memory/ingestion/OcrPdfLoader.js +149 -0
  91. package/dist/memory/ingestion/OcrPdfLoader.js.map +1 -0
  92. package/dist/memory/ingestion/PdfLoader.d.ts +78 -0
  93. package/dist/memory/ingestion/PdfLoader.d.ts.map +1 -0
  94. package/dist/memory/ingestion/PdfLoader.js +179 -0
  95. package/dist/memory/ingestion/PdfLoader.js.map +1 -0
  96. package/dist/memory/ingestion/TextLoader.d.ts +66 -0
  97. package/dist/memory/ingestion/TextLoader.d.ts.map +1 -0
  98. package/dist/memory/ingestion/TextLoader.js +207 -0
  99. package/dist/memory/ingestion/TextLoader.js.map +1 -0
  100. package/dist/memory/ingestion/UrlLoader.d.ts +95 -0
  101. package/dist/memory/ingestion/UrlLoader.d.ts.map +1 -0
  102. package/dist/memory/ingestion/UrlLoader.js +174 -0
  103. package/dist/memory/ingestion/UrlLoader.js.map +1 -0
  104. package/dist/memory/io/ChatGptImporter.d.ts +85 -0
  105. package/dist/memory/io/ChatGptImporter.d.ts.map +1 -0
  106. package/dist/memory/io/ChatGptImporter.js +231 -0
  107. package/dist/memory/io/ChatGptImporter.js.map +1 -0
  108. package/dist/memory/io/JsonExporter.d.ts +67 -0
  109. package/dist/memory/io/JsonExporter.d.ts.map +1 -0
  110. package/dist/memory/io/JsonExporter.js +132 -0
  111. package/dist/memory/io/JsonExporter.js.map +1 -0
  112. package/dist/memory/io/JsonImporter.d.ts +84 -0
  113. package/dist/memory/io/JsonImporter.d.ts.map +1 -0
  114. package/dist/memory/io/JsonImporter.js +234 -0
  115. package/dist/memory/io/JsonImporter.js.map +1 -0
  116. package/dist/memory/io/MarkdownExporter.d.ts +95 -0
  117. package/dist/memory/io/MarkdownExporter.d.ts.map +1 -0
  118. package/dist/memory/io/MarkdownExporter.js +130 -0
  119. package/dist/memory/io/MarkdownExporter.js.map +1 -0
  120. package/dist/memory/io/MarkdownImporter.d.ts +84 -0
  121. package/dist/memory/io/MarkdownImporter.d.ts.map +1 -0
  122. package/dist/memory/io/MarkdownImporter.js +166 -0
  123. package/dist/memory/io/MarkdownImporter.js.map +1 -0
  124. package/dist/memory/io/ObsidianExporter.d.ts +80 -0
  125. package/dist/memory/io/ObsidianExporter.d.ts.map +1 -0
  126. package/dist/memory/io/ObsidianExporter.js +127 -0
  127. package/dist/memory/io/ObsidianExporter.js.map +1 -0
  128. package/dist/memory/io/ObsidianImporter.d.ts +93 -0
  129. package/dist/memory/io/ObsidianImporter.d.ts.map +1 -0
  130. package/dist/memory/io/ObsidianImporter.js +221 -0
  131. package/dist/memory/io/ObsidianImporter.js.map +1 -0
  132. package/dist/memory/io/SqliteExporter.d.ts +47 -0
  133. package/dist/memory/io/SqliteExporter.d.ts.map +1 -0
  134. package/dist/memory/io/SqliteExporter.js +56 -0
  135. package/dist/memory/io/SqliteExporter.js.map +1 -0
  136. package/dist/memory/io/SqliteImporter.d.ts +82 -0
  137. package/dist/memory/io/SqliteImporter.d.ts.map +1 -0
  138. package/dist/memory/io/SqliteImporter.js +232 -0
  139. package/dist/memory/io/SqliteImporter.js.map +1 -0
  140. package/dist/memory/io/index.d.ts +31 -0
  141. package/dist/memory/io/index.d.ts.map +1 -0
  142. package/dist/memory/io/index.js +31 -0
  143. package/dist/memory/io/index.js.map +1 -0
  144. package/dist/memory/store/SqliteBrain.d.ts +125 -0
  145. package/dist/memory/store/SqliteBrain.d.ts.map +1 -0
  146. package/dist/memory/store/SqliteBrain.js +407 -0
  147. package/dist/memory/store/SqliteBrain.js.map +1 -0
  148. package/dist/memory/store/SqliteKnowledgeGraph.d.ts +259 -0
  149. package/dist/memory/store/SqliteKnowledgeGraph.d.ts.map +1 -0
  150. package/dist/memory/store/SqliteKnowledgeGraph.js +1062 -0
  151. package/dist/memory/store/SqliteKnowledgeGraph.js.map +1 -0
  152. package/dist/memory/store/SqliteMemoryGraph.d.ts +251 -0
  153. package/dist/memory/store/SqliteMemoryGraph.d.ts.map +1 -0
  154. package/dist/memory/store/SqliteMemoryGraph.js +637 -0
  155. package/dist/memory/store/SqliteMemoryGraph.js.map +1 -0
  156. package/dist/memory/tools/MemoryAddTool.d.ts +98 -0
  157. package/dist/memory/tools/MemoryAddTool.d.ts.map +1 -0
  158. package/dist/memory/tools/MemoryAddTool.js +131 -0
  159. package/dist/memory/tools/MemoryAddTool.js.map +1 -0
  160. package/dist/memory/tools/MemoryDeleteTool.d.ts +83 -0
  161. package/dist/memory/tools/MemoryDeleteTool.d.ts.map +1 -0
  162. package/dist/memory/tools/MemoryDeleteTool.js +96 -0
  163. package/dist/memory/tools/MemoryDeleteTool.js.map +1 -0
  164. package/dist/memory/tools/MemoryMergeTool.d.ts +95 -0
  165. package/dist/memory/tools/MemoryMergeTool.d.ts.map +1 -0
  166. package/dist/memory/tools/MemoryMergeTool.js +164 -0
  167. package/dist/memory/tools/MemoryMergeTool.js.map +1 -0
  168. package/dist/memory/tools/MemoryReflectTool.d.ts +86 -0
  169. package/dist/memory/tools/MemoryReflectTool.d.ts.map +1 -0
  170. package/dist/memory/tools/MemoryReflectTool.js +102 -0
  171. package/dist/memory/tools/MemoryReflectTool.js.map +1 -0
  172. package/dist/memory/tools/MemorySearchTool.d.ts +117 -0
  173. package/dist/memory/tools/MemorySearchTool.d.ts.map +1 -0
  174. package/dist/memory/tools/MemorySearchTool.js +162 -0
  175. package/dist/memory/tools/MemorySearchTool.js.map +1 -0
  176. package/dist/memory/tools/MemoryUpdateTool.d.ts +92 -0
  177. package/dist/memory/tools/MemoryUpdateTool.d.ts.map +1 -0
  178. package/dist/memory/tools/MemoryUpdateTool.js +125 -0
  179. package/dist/memory/tools/MemoryUpdateTool.js.map +1 -0
  180. package/dist/memory/tools/index.d.ts +32 -0
  181. package/dist/memory/tools/index.d.ts.map +1 -0
  182. package/dist/memory/tools/index.js +26 -0
  183. package/dist/memory/tools/index.js.map +1 -0
  184. package/package.json +6 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Memory.js","sourceRoot":"","sources":["../../../src/memory/facade/Memory.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * @fileoverview Barrel exports for the Memory facade.
3
+ *
4
+ * The facade re-exports the `Memory` class (the unified public API) along
5
+ * with all public types from `./types.ts`. Consumers should import from
6
+ * this module rather than reaching into individual subsystem files.
7
+ *
8
+ * @module memory/facade
9
+ */
10
+ export { Memory } from './Memory.js';
11
+ export type { ScoredTrace } from './Memory.js';
12
+ export type { MemoryConfig, EmbeddingConfig, ExtendedConsolidationConfig, IngestionConfig, RememberOptions, RecallOptions, IngestOptions, IngestResult, ExportOptions, ImportOptions, ImportResult, ConsolidationResult, MemoryHealth, LoadOptions, DocumentMetadata, DocumentChunk, ExtractedImage, ExtractedTable, LoadedDocument, } from './types.js';
13
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/facade/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,YAAY,EACV,YAAY,EACZ,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * @fileoverview Barrel exports for the Memory facade.
3
+ *
4
+ * The facade re-exports the `Memory` class (the unified public API) along
5
+ * with all public types from `./types.ts`. Consumers should import from
6
+ * this module rather than reaching into individual subsystem files.
7
+ *
8
+ * @module memory/facade
9
+ */
10
+ export { Memory } from './Memory.js';
11
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/facade/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,606 @@
1
+ /**
2
+ * @fileoverview Public API types for the Memory facade.
3
+ *
4
+ * These types form the stable, public-facing contract for the Memory subsystem.
5
+ * They are intentionally independent of internal cognitive-science machinery so
6
+ * consumers only need to import from this file rather than from deep internals.
7
+ *
8
+ * @module memory/facade/types
9
+ */
10
+ /**
11
+ * Configuration for the embedding model used to encode memory content and
12
+ * document chunks into dense vectors.
13
+ */
14
+ export interface EmbeddingConfig {
15
+ /**
16
+ * Embedding provider identifier.
17
+ * @example 'openai' | 'cohere' | 'local'
18
+ */
19
+ provider: string;
20
+ /**
21
+ * Model name to use for generating embeddings.
22
+ * When omitted the provider's default model is used.
23
+ * @example 'text-embedding-3-small'
24
+ */
25
+ model?: string;
26
+ /**
27
+ * Dimensionality of produced vectors.
28
+ * Must match the dimensionality expected by the configured vector store.
29
+ * @example 1536
30
+ */
31
+ dimensions?: number;
32
+ }
33
+ /**
34
+ * Extended consolidation configuration that adds lifecycle-management fields
35
+ * on top of the core `ConsolidationConfig` used internally.
36
+ *
37
+ * The `trigger` + `every` pair replace the internal `intervalMs` at the facade
38
+ * level; adapters translate these to the internal representation.
39
+ */
40
+ export interface ExtendedConsolidationConfig {
41
+ /**
42
+ * What event or schedule triggers a consolidation run.
43
+ * - `'turns'` – run after every N conversation turns (`every` = turn count).
44
+ * - `'interval'` – run on a wall-clock timer (`every` = milliseconds).
45
+ * - `'manual'` – only run when explicitly called via `consolidate()`.
46
+ * @default 'interval'
47
+ */
48
+ trigger?: 'turns' | 'interval' | 'manual';
49
+ /**
50
+ * Numeric complement to `trigger`.
51
+ * When `trigger='turns'` this is the turn count; when `trigger='interval'`
52
+ * this is the millisecond interval.
53
+ * @default 3_600_000
54
+ */
55
+ every?: number;
56
+ /**
57
+ * Minimum strength below which a memory trace is pruned.
58
+ * Must be between 0 and 1.
59
+ * @default 0.05
60
+ */
61
+ pruneThreshold?: number;
62
+ /**
63
+ * Cosine similarity above which two traces are candidates for merging.
64
+ * Must be between 0 and 1.
65
+ * @default 0.92
66
+ */
67
+ mergeThreshold?: number;
68
+ /**
69
+ * Whether the consolidation engine should derive new insight traces from
70
+ * clusters of related memories.
71
+ * @default true
72
+ */
73
+ deriveInsights?: boolean;
74
+ /**
75
+ * Maximum number of new insight traces derived per consolidation cycle.
76
+ * Guards against unbounded graph growth.
77
+ * @default 10
78
+ */
79
+ maxDerivedPerCycle?: number;
80
+ /**
81
+ * How often to run consolidation in milliseconds (internal scheduler).
82
+ * Superseded by `trigger`+`every` at the facade level; kept for compatibility.
83
+ * @default 3_600_000
84
+ */
85
+ intervalMs?: number;
86
+ /**
87
+ * Maximum number of traces to process per consolidation cycle.
88
+ * Bounds CPU/memory cost of a single run.
89
+ * @default 500
90
+ */
91
+ maxTracesPerCycle?: number;
92
+ /**
93
+ * Similarity threshold used when merging redundant traces.
94
+ * @default 0.92
95
+ */
96
+ mergeSimilarityThreshold?: number;
97
+ /**
98
+ * Minimum cluster size required before schema integration fires.
99
+ * @default 5
100
+ */
101
+ minClusterSize?: number;
102
+ }
103
+ /**
104
+ * Controls how documents are split into chunks before being stored and indexed.
105
+ */
106
+ export interface IngestionConfig {
107
+ /**
108
+ * Strategy for splitting a document into indexable chunks.
109
+ * - `'fixed'` – split at a fixed token/character count.
110
+ * - `'semantic'` – split at semantic boundaries (paragraphs, sections).
111
+ * - `'hierarchical'`– build a tree of coarse → fine chunks (good for Q&A).
112
+ * - `'layout'` – preserve the visual layout of the source (PDF columns etc.).
113
+ * @default 'semantic'
114
+ */
115
+ chunkStrategy?: 'fixed' | 'semantic' | 'hierarchical' | 'layout';
116
+ /**
117
+ * Target token/character count for each chunk.
118
+ * @default 512
119
+ */
120
+ chunkSize?: number;
121
+ /**
122
+ * Overlap between consecutive chunks in tokens/characters.
123
+ * Prevents context loss at chunk boundaries.
124
+ * @default 64
125
+ */
126
+ chunkOverlap?: number;
127
+ /**
128
+ * Whether to extract embedded images from documents (PDF, DOCX, etc.).
129
+ * Extracted images are stored as `ExtractedImage` objects.
130
+ * @default false
131
+ */
132
+ extractImages?: boolean;
133
+ /**
134
+ * Whether to run Optical Character Recognition on extracted images.
135
+ * Requires `extractImages: true`.
136
+ * @default false
137
+ */
138
+ ocrEnabled?: boolean;
139
+ /**
140
+ * Whether to use the Docling library for high-fidelity PDF/DOCX parsing.
141
+ * When `false`, a simpler text-extraction path is used.
142
+ * @default false
143
+ */
144
+ doclingEnabled?: boolean;
145
+ /**
146
+ * Vision-capable LLM model identifier used to caption extracted images.
147
+ * Only consulted when `extractImages: true`.
148
+ * @example 'gpt-4o'
149
+ */
150
+ visionLlm?: string;
151
+ }
152
+ /**
153
+ * Top-level configuration object for the Memory facade.
154
+ *
155
+ * All fields are optional; sensible defaults are applied per field.
156
+ * A minimal `{}` config is valid and will use in-memory storage with no graph,
157
+ * no decay and a default embedding provider.
158
+ */
159
+ export interface MemoryConfig {
160
+ /**
161
+ * Persistence backend for memory traces.
162
+ * - `'sqlite'` – file-based SQLite (recommended for single-process agents).
163
+ * - `'memory'` – in-process Map, no persistence (good for testing).
164
+ * - `'qdrant'` – Qdrant vector database (remote or local).
165
+ * - `'neo4j'` – Neo4j graph database (full graph-native storage).
166
+ * - `'hnsw'` – HNSW in-memory approximate nearest-neighbour index.
167
+ * @default 'memory'
168
+ */
169
+ store?: 'sqlite' | 'memory' | 'qdrant' | 'neo4j' | 'hnsw';
170
+ /**
171
+ * File-system path for stores that require one (e.g. SQLite db file).
172
+ * Ignored by in-memory and remote stores.
173
+ * @example './data/agent-memory.sqlite'
174
+ */
175
+ path?: string;
176
+ /** Embedding model configuration. */
177
+ embeddings?: EmbeddingConfig;
178
+ /**
179
+ * Whether to build and maintain a knowledge graph alongside the vector store.
180
+ * When enabled, entity co-occurrence and semantic edges are tracked.
181
+ * @default false
182
+ */
183
+ graph?: boolean;
184
+ /**
185
+ * Whether the agent may autonomously refine and restructure its own memories
186
+ * (write new insight traces, prune contradictions, merge redundancies).
187
+ * @default false
188
+ */
189
+ selfImprove?: boolean;
190
+ /**
191
+ * Whether memory traces lose strength over time following an Ebbinghaus
192
+ * forgetting-curve model.
193
+ * @default true
194
+ */
195
+ decay?: boolean;
196
+ /** Consolidation schedule and thresholds. */
197
+ consolidation?: ExtendedConsolidationConfig;
198
+ /** Document ingestion settings applied to all `ingest()` calls by default. */
199
+ ingestion?: IngestionConfig;
200
+ }
201
+ /**
202
+ * Options for storing a new memory trace via `Memory.remember()`.
203
+ */
204
+ export interface RememberOptions {
205
+ /**
206
+ * Tulving memory type.
207
+ * @example 'episodic' | 'semantic' | 'procedural' | 'prospective'
208
+ */
209
+ type?: string;
210
+ /**
211
+ * Visibility scope of the trace.
212
+ * @example 'thread' | 'user' | 'persona' | 'organization'
213
+ */
214
+ scope?: string;
215
+ /**
216
+ * Identifier for the scope (e.g. thread ID, user ID).
217
+ * Required when `scope` is set.
218
+ */
219
+ scopeId?: string;
220
+ /**
221
+ * Free-form tags for filtering and retrieval.
222
+ * @example ['project:alpha', 'decision']
223
+ */
224
+ tags?: string[];
225
+ /**
226
+ * Named entities extracted from or associated with this trace.
227
+ * @example ['Alice', 'GPT-4o', 'Q3 roadmap']
228
+ */
229
+ entities?: string[];
230
+ /**
231
+ * Manually supplied importance score (0–1).
232
+ * When omitted the encoding engine derives one automatically.
233
+ */
234
+ importance?: number;
235
+ }
236
+ /**
237
+ * Options for querying memory traces via `Memory.recall()`.
238
+ */
239
+ export interface RecallOptions {
240
+ /**
241
+ * Maximum number of traces to return.
242
+ * @default 10
243
+ */
244
+ limit?: number;
245
+ /**
246
+ * Filter by Tulving memory type.
247
+ */
248
+ type?: string;
249
+ /**
250
+ * Filter by visibility scope.
251
+ */
252
+ scope?: string;
253
+ /**
254
+ * Filter by scope ID.
255
+ */
256
+ scopeId?: string;
257
+ /**
258
+ * Minimum retrieval strength (Ebbinghaus current strength) to include.
259
+ * Traces below this value are considered too weak/forgotten.
260
+ * @default 0
261
+ */
262
+ minStrength?: number;
263
+ }
264
+ /**
265
+ * Options controlling a document-ingestion job launched via `Memory.ingest()`.
266
+ */
267
+ export interface IngestOptions {
268
+ /**
269
+ * Whether to recursively scan sub-directories when `source` is a directory.
270
+ * @default false
271
+ */
272
+ recursive?: boolean;
273
+ /**
274
+ * Glob patterns for file types to include.
275
+ * @example ['**\/*.md', '**\/*.pdf']
276
+ */
277
+ include?: string[];
278
+ /**
279
+ * Glob patterns for paths to exclude.
280
+ * @example ['node_modules/**', '**\/*.test.*']
281
+ */
282
+ exclude?: string[];
283
+ /**
284
+ * Format hint for the ingested content.
285
+ * - `'auto'` – detect from file extension / mime type.
286
+ * - `'obsidian'` – parse Obsidian wiki-links and front-matter.
287
+ * - `'markdown'` – treat as plain CommonMark.
288
+ * @default 'auto'
289
+ */
290
+ format?: 'auto' | 'obsidian' | 'markdown';
291
+ /**
292
+ * Callback invoked as each file is processed.
293
+ * Useful for building progress UI.
294
+ * @param processed - number of files completed so far
295
+ * @param total - total number of files discovered
296
+ * @param current - path of the file currently being processed
297
+ */
298
+ onProgress?: (processed: number, total: number, current: string) => void;
299
+ }
300
+ /**
301
+ * Summary of a completed ingestion run returned by `Memory.ingest()`.
302
+ */
303
+ export interface IngestResult {
304
+ /**
305
+ * Absolute paths of all files that were successfully ingested.
306
+ */
307
+ succeeded: string[];
308
+ /**
309
+ * Files that could not be ingested, with per-file error messages.
310
+ */
311
+ failed: Array<{
312
+ path: string;
313
+ error: string;
314
+ }>;
315
+ /**
316
+ * Total number of document chunks created and stored.
317
+ */
318
+ chunksCreated: number;
319
+ /**
320
+ * Total number of new memory traces created from the ingested content.
321
+ */
322
+ tracesCreated: number;
323
+ }
324
+ /**
325
+ * Options for exporting the memory store via `Memory.export()`.
326
+ */
327
+ export interface ExportOptions {
328
+ /**
329
+ * Serialisation format for the export artifact.
330
+ * - `'sqlite'` – copy of the SQLite file (binary).
331
+ * - `'json'` – newline-delimited JSON of all traces.
332
+ * - `'markdown'` – human-readable Markdown summary.
333
+ * - `'obsidian'` – Obsidian vault with one note per trace and wiki-links.
334
+ * @default 'json'
335
+ */
336
+ format?: 'sqlite' | 'json' | 'markdown' | 'obsidian';
337
+ /**
338
+ * Whether to include raw embedding vectors in the export.
339
+ * Embeddings dramatically increase file size but allow round-trip import
340
+ * without re-embedding.
341
+ * @default false
342
+ */
343
+ includeEmbeddings?: boolean;
344
+ /**
345
+ * Whether to include conversation turn traces in the export.
346
+ * @default true
347
+ */
348
+ includeConversations?: boolean;
349
+ }
350
+ /**
351
+ * Options for importing memory data via `Memory.import()`.
352
+ */
353
+ export interface ImportOptions {
354
+ /**
355
+ * Source format of the import file.
356
+ * - `'auto'` – detect from file extension / magic bytes.
357
+ * - `'sqlite'` – AgentOS SQLite export.
358
+ * - `'json'` – newline-delimited JSON export.
359
+ * - `'markdown'` – parse headings as trace content.
360
+ * - `'obsidian'` – Obsidian vault (wiki-links become graph edges).
361
+ * - `'chatgpt'` – ChatGPT conversation export (conversations.json).
362
+ * - `'csv'` – flat CSV with `content` column.
363
+ * @default 'auto'
364
+ */
365
+ format?: 'auto' | 'sqlite' | 'json' | 'markdown' | 'obsidian' | 'chatgpt' | 'csv';
366
+ /**
367
+ * Whether to skip importing traces whose content hash already exists in the
368
+ * store, preventing duplicates on repeated imports.
369
+ * @default true
370
+ */
371
+ dedup?: boolean;
372
+ }
373
+ /**
374
+ * Summary of a completed import operation returned by `Memory.import()`.
375
+ */
376
+ export interface ImportResult {
377
+ /**
378
+ * Number of traces successfully imported and written to the store.
379
+ */
380
+ imported: number;
381
+ /**
382
+ * Number of traces skipped (deduplication or format mismatch).
383
+ */
384
+ skipped: number;
385
+ /**
386
+ * Human-readable error messages for any traces that failed to import.
387
+ */
388
+ errors: string[];
389
+ }
390
+ /**
391
+ * Statistics returned after a consolidation cycle completes.
392
+ */
393
+ export interface ConsolidationResult {
394
+ /**
395
+ * Number of traces pruned (below strength threshold).
396
+ */
397
+ pruned: number;
398
+ /**
399
+ * Number of trace pairs merged into single traces.
400
+ */
401
+ merged: number;
402
+ /**
403
+ * Number of new insight traces derived from clusters.
404
+ */
405
+ derived: number;
406
+ /**
407
+ * Number of traces compacted (archived to long-term store).
408
+ */
409
+ compacted: number;
410
+ /**
411
+ * Wall-clock time the consolidation cycle took in milliseconds.
412
+ */
413
+ durationMs: number;
414
+ }
415
+ /**
416
+ * Snapshot of the memory store's health and usage statistics.
417
+ * Returned by `Memory.health()`.
418
+ */
419
+ export interface MemoryHealth {
420
+ /**
421
+ * Total number of traces in the store (active + inactive).
422
+ */
423
+ totalTraces: number;
424
+ /**
425
+ * Number of traces that are currently active (strength > pruneThreshold).
426
+ */
427
+ activeTraces: number;
428
+ /**
429
+ * Mean Ebbinghaus strength across all active traces (0–1).
430
+ */
431
+ avgStrength: number;
432
+ /**
433
+ * Strength of the weakest active trace.
434
+ */
435
+ weakestTraceStrength: number;
436
+ /**
437
+ * Number of nodes in the knowledge graph (0 when `graph` is disabled).
438
+ */
439
+ graphNodes: number;
440
+ /**
441
+ * Number of edges in the knowledge graph (0 when `graph` is disabled).
442
+ */
443
+ graphEdges: number;
444
+ /**
445
+ * ISO 8601 timestamp of the last successful consolidation run.
446
+ * `null` if consolidation has never been run.
447
+ */
448
+ lastConsolidation: string | null;
449
+ /**
450
+ * Trace count broken down by Tulving memory type.
451
+ */
452
+ tracesPerType: Record<string, number>;
453
+ /**
454
+ * Trace count broken down by visibility scope.
455
+ */
456
+ tracesPerScope: Record<string, number>;
457
+ /**
458
+ * Total number of document chunks ingested via `Memory.ingest()`.
459
+ */
460
+ documentsIngested: number;
461
+ }
462
+ /**
463
+ * Options for the lower-level `Memory.load()` document-parsing primitive.
464
+ */
465
+ export interface LoadOptions {
466
+ /**
467
+ * Format hint passed directly to the document parser.
468
+ * @example 'pdf' | 'docx' | 'md' | 'txt'
469
+ */
470
+ format?: string;
471
+ }
472
+ /**
473
+ * Arbitrary key-value metadata attached to a loaded document.
474
+ * Well-known fields are typed explicitly; any additional fields are allowed.
475
+ */
476
+ export interface DocumentMetadata {
477
+ /** Document title extracted from front-matter or PDF info dict. */
478
+ title?: string;
479
+ /** Primary author of the document. */
480
+ author?: string;
481
+ /** Number of pages (PDF/DOCX). */
482
+ pageCount?: number;
483
+ /** Approximate word count of the full document text. */
484
+ wordCount?: number;
485
+ /**
486
+ * ISO 639-1 language code detected in the document.
487
+ * @example 'en' | 'de' | 'fr'
488
+ */
489
+ language?: string;
490
+ /** ISO 8601 creation timestamp. */
491
+ createdAt?: string;
492
+ /** ISO 8601 last-modified timestamp. */
493
+ modifiedAt?: string;
494
+ /** Original file path or URL the document was loaded from. */
495
+ source?: string;
496
+ /** Any additional metadata fields from the source document. */
497
+ [key: string]: unknown;
498
+ }
499
+ /**
500
+ * A single chunk produced by splitting a document.
501
+ * Used internally and returned in `LoadedDocument.chunks`.
502
+ */
503
+ export interface DocumentChunk {
504
+ /**
505
+ * Text content of this chunk after extraction and cleaning.
506
+ */
507
+ content: string;
508
+ /**
509
+ * Zero-based chunk index within the parent document.
510
+ */
511
+ index: number;
512
+ /**
513
+ * Page number this chunk originates from (1-based, PDF/DOCX).
514
+ */
515
+ pageNumber?: number;
516
+ /**
517
+ * Heading or section title that precedes this chunk, if detected.
518
+ */
519
+ heading?: string;
520
+ /**
521
+ * Chunk-level metadata (e.g. bounding box, column number for layout mode).
522
+ */
523
+ metadata?: Record<string, unknown>;
524
+ }
525
+ /**
526
+ * An image extracted from a document during ingestion.
527
+ */
528
+ export interface ExtractedImage {
529
+ /**
530
+ * Raw image bytes (PNG, JPEG, WebP, etc.).
531
+ */
532
+ data: Buffer;
533
+ /**
534
+ * MIME type of `data`.
535
+ * @example 'image/png' | 'image/jpeg'
536
+ */
537
+ mimeType: string;
538
+ /**
539
+ * Auto-generated or OCR-derived caption.
540
+ * Present when a vision LLM is configured and `extractImages: true`.
541
+ */
542
+ caption?: string;
543
+ /**
544
+ * Page number the image appears on (1-based, PDF/DOCX).
545
+ */
546
+ pageNumber?: number;
547
+ /**
548
+ * Dense embedding of the image caption or visual content.
549
+ * Only present when embeddings were computed during extraction.
550
+ */
551
+ embedding?: number[];
552
+ }
553
+ /**
554
+ * A structured table extracted from a document.
555
+ */
556
+ export interface ExtractedTable {
557
+ /**
558
+ * Column header labels, in order.
559
+ */
560
+ headers: string[];
561
+ /**
562
+ * Data rows; each row is an array of cell strings aligned to `headers`.
563
+ */
564
+ rows: string[][];
565
+ /**
566
+ * Optional caption or title for the table.
567
+ */
568
+ caption?: string;
569
+ /**
570
+ * Page number the table appears on (1-based, PDF/DOCX).
571
+ */
572
+ pageNumber?: number;
573
+ }
574
+ /**
575
+ * The parsed representation of a document returned by `Memory.load()`.
576
+ * Contains full text, optional chunks, and any extracted images/tables.
577
+ */
578
+ export interface LoadedDocument {
579
+ /**
580
+ * Full extracted text content of the document.
581
+ */
582
+ content: string;
583
+ /**
584
+ * Document-level metadata (title, author, page count, etc.).
585
+ */
586
+ metadata: DocumentMetadata;
587
+ /**
588
+ * Pre-chunked segments, present when chunking was requested during load.
589
+ */
590
+ chunks?: DocumentChunk[];
591
+ /**
592
+ * Images extracted from the document.
593
+ * Populated only when `IngestionConfig.extractImages` is `true`.
594
+ */
595
+ images?: ExtractedImage[];
596
+ /**
597
+ * Structured tables extracted from the document.
598
+ */
599
+ tables?: ExtractedTable[];
600
+ /**
601
+ * The format that was detected or used to parse the document.
602
+ * @example 'pdf' | 'md' | 'docx' | 'txt'
603
+ */
604
+ format: string;
605
+ }
606
+ //# sourceMappingURL=types.d.ts.map