ai-memory-layer 2.0.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.
Files changed (245) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/LICENSE +21 -0
  3. package/README.md +765 -0
  4. package/bin/memory-server.mjs +157 -0
  5. package/dist/adapters/memory/embeddings.d.ts +4 -0
  6. package/dist/adapters/memory/embeddings.d.ts.map +1 -0
  7. package/dist/adapters/memory/embeddings.js +53 -0
  8. package/dist/adapters/memory/embeddings.js.map +1 -0
  9. package/dist/adapters/memory/index.d.ts +7 -0
  10. package/dist/adapters/memory/index.d.ts.map +1 -0
  11. package/dist/adapters/memory/index.js +650 -0
  12. package/dist/adapters/memory/index.js.map +1 -0
  13. package/dist/adapters/postgres/index.d.ts +38 -0
  14. package/dist/adapters/postgres/index.d.ts.map +1 -0
  15. package/dist/adapters/postgres/index.js +982 -0
  16. package/dist/adapters/postgres/index.js.map +1 -0
  17. package/dist/adapters/sqlite/embeddings.d.ts +5 -0
  18. package/dist/adapters/sqlite/embeddings.d.ts.map +1 -0
  19. package/dist/adapters/sqlite/embeddings.js +122 -0
  20. package/dist/adapters/sqlite/embeddings.js.map +1 -0
  21. package/dist/adapters/sqlite/index.d.ts +8 -0
  22. package/dist/adapters/sqlite/index.d.ts.map +1 -0
  23. package/dist/adapters/sqlite/index.js +839 -0
  24. package/dist/adapters/sqlite/index.js.map +1 -0
  25. package/dist/adapters/sqlite/mappers.d.ts +40 -0
  26. package/dist/adapters/sqlite/mappers.d.ts.map +1 -0
  27. package/dist/adapters/sqlite/mappers.js +95 -0
  28. package/dist/adapters/sqlite/mappers.js.map +1 -0
  29. package/dist/adapters/sqlite/schema.d.ts +4 -0
  30. package/dist/adapters/sqlite/schema.d.ts.map +1 -0
  31. package/dist/adapters/sqlite/schema.js +394 -0
  32. package/dist/adapters/sqlite/schema.js.map +1 -0
  33. package/dist/adapters/sync-to-async.d.ts +15 -0
  34. package/dist/adapters/sync-to-async.d.ts.map +1 -0
  35. package/dist/adapters/sync-to-async.js +95 -0
  36. package/dist/adapters/sync-to-async.js.map +1 -0
  37. package/dist/cli/inspect.d.ts +34 -0
  38. package/dist/cli/inspect.d.ts.map +1 -0
  39. package/dist/cli/inspect.js +190 -0
  40. package/dist/cli/inspect.js.map +1 -0
  41. package/dist/contracts/async-storage.d.ts +86 -0
  42. package/dist/contracts/async-storage.d.ts.map +1 -0
  43. package/dist/contracts/async-storage.js +2 -0
  44. package/dist/contracts/async-storage.js.map +1 -0
  45. package/dist/contracts/embedding.d.ts +22 -0
  46. package/dist/contracts/embedding.d.ts.map +1 -0
  47. package/dist/contracts/embedding.js +2 -0
  48. package/dist/contracts/embedding.js.map +1 -0
  49. package/dist/contracts/identity.d.ts +29 -0
  50. package/dist/contracts/identity.d.ts.map +1 -0
  51. package/dist/contracts/identity.js +34 -0
  52. package/dist/contracts/identity.js.map +1 -0
  53. package/dist/contracts/observability.d.ts +18 -0
  54. package/dist/contracts/observability.d.ts.map +1 -0
  55. package/dist/contracts/observability.js +7 -0
  56. package/dist/contracts/observability.js.map +1 -0
  57. package/dist/contracts/policy.d.ts +108 -0
  58. package/dist/contracts/policy.d.ts.map +1 -0
  59. package/dist/contracts/policy.js +107 -0
  60. package/dist/contracts/policy.js.map +1 -0
  61. package/dist/contracts/storage.d.ts +78 -0
  62. package/dist/contracts/storage.d.ts.map +1 -0
  63. package/dist/contracts/storage.js +2 -0
  64. package/dist/contracts/storage.js.map +1 -0
  65. package/dist/contracts/types.d.ts +381 -0
  66. package/dist/contracts/types.d.ts.map +1 -0
  67. package/dist/contracts/types.js +94 -0
  68. package/dist/contracts/types.js.map +1 -0
  69. package/dist/core/circuit-breaker.d.ts +11 -0
  70. package/dist/core/circuit-breaker.d.ts.map +1 -0
  71. package/dist/core/circuit-breaker.js +38 -0
  72. package/dist/core/circuit-breaker.js.map +1 -0
  73. package/dist/core/context.d.ts +56 -0
  74. package/dist/core/context.d.ts.map +1 -0
  75. package/dist/core/context.js +345 -0
  76. package/dist/core/context.js.map +1 -0
  77. package/dist/core/events.d.ts +8 -0
  78. package/dist/core/events.d.ts.map +1 -0
  79. package/dist/core/events.js +25 -0
  80. package/dist/core/events.js.map +1 -0
  81. package/dist/core/extractor.d.ts +37 -0
  82. package/dist/core/extractor.d.ts.map +1 -0
  83. package/dist/core/extractor.js +448 -0
  84. package/dist/core/extractor.js.map +1 -0
  85. package/dist/core/formatter.d.ts +25 -0
  86. package/dist/core/formatter.d.ts.map +1 -0
  87. package/dist/core/formatter.js +97 -0
  88. package/dist/core/formatter.js.map +1 -0
  89. package/dist/core/knowledge-lifecycle.d.ts +15 -0
  90. package/dist/core/knowledge-lifecycle.d.ts.map +1 -0
  91. package/dist/core/knowledge-lifecycle.js +103 -0
  92. package/dist/core/knowledge-lifecycle.js.map +1 -0
  93. package/dist/core/maintenance.d.ts +13 -0
  94. package/dist/core/maintenance.d.ts.map +1 -0
  95. package/dist/core/maintenance.js +102 -0
  96. package/dist/core/maintenance.js.map +1 -0
  97. package/dist/core/manager.d.ts +110 -0
  98. package/dist/core/manager.d.ts.map +1 -0
  99. package/dist/core/manager.js +640 -0
  100. package/dist/core/manager.js.map +1 -0
  101. package/dist/core/monitor.d.ts +73 -0
  102. package/dist/core/monitor.d.ts.map +1 -0
  103. package/dist/core/monitor.js +395 -0
  104. package/dist/core/monitor.js.map +1 -0
  105. package/dist/core/orchestrator.d.ts +64 -0
  106. package/dist/core/orchestrator.d.ts.map +1 -0
  107. package/dist/core/orchestrator.js +916 -0
  108. package/dist/core/orchestrator.js.map +1 -0
  109. package/dist/core/presets.d.ts +15 -0
  110. package/dist/core/presets.d.ts.map +1 -0
  111. package/dist/core/presets.js +99 -0
  112. package/dist/core/presets.js.map +1 -0
  113. package/dist/core/provider-managers.d.ts +47 -0
  114. package/dist/core/provider-managers.d.ts.map +1 -0
  115. package/dist/core/provider-managers.js +112 -0
  116. package/dist/core/provider-managers.js.map +1 -0
  117. package/dist/core/quick.d.ts +62 -0
  118. package/dist/core/quick.d.ts.map +1 -0
  119. package/dist/core/quick.js +300 -0
  120. package/dist/core/quick.js.map +1 -0
  121. package/dist/core/retrieval.d.ts +29 -0
  122. package/dist/core/retrieval.d.ts.map +1 -0
  123. package/dist/core/retrieval.js +150 -0
  124. package/dist/core/retrieval.js.map +1 -0
  125. package/dist/core/runtime.d.ts +67 -0
  126. package/dist/core/runtime.d.ts.map +1 -0
  127. package/dist/core/runtime.js +84 -0
  128. package/dist/core/runtime.js.map +1 -0
  129. package/dist/core/streaming.d.ts +37 -0
  130. package/dist/core/streaming.d.ts.map +1 -0
  131. package/dist/core/streaming.js +51 -0
  132. package/dist/core/streaming.js.map +1 -0
  133. package/dist/core/sync.d.ts +13 -0
  134. package/dist/core/sync.d.ts.map +1 -0
  135. package/dist/core/sync.js +46 -0
  136. package/dist/core/sync.js.map +1 -0
  137. package/dist/core/telemetry.d.ts +8 -0
  138. package/dist/core/telemetry.d.ts.map +1 -0
  139. package/dist/core/telemetry.js +14 -0
  140. package/dist/core/telemetry.js.map +1 -0
  141. package/dist/core/tokens.d.ts +8 -0
  142. package/dist/core/tokens.d.ts.map +1 -0
  143. package/dist/core/tokens.js +59 -0
  144. package/dist/core/tokens.js.map +1 -0
  145. package/dist/core/trust.d.ts +23 -0
  146. package/dist/core/trust.d.ts.map +1 -0
  147. package/dist/core/trust.js +164 -0
  148. package/dist/core/trust.js.map +1 -0
  149. package/dist/core/validation.d.ts +36 -0
  150. package/dist/core/validation.d.ts.map +1 -0
  151. package/dist/core/validation.js +185 -0
  152. package/dist/core/validation.js.map +1 -0
  153. package/dist/embeddings/local.d.ts +5 -0
  154. package/dist/embeddings/local.d.ts.map +1 -0
  155. package/dist/embeddings/local.js +128 -0
  156. package/dist/embeddings/local.js.map +1 -0
  157. package/dist/embeddings/openai.d.ts +26 -0
  158. package/dist/embeddings/openai.d.ts.map +1 -0
  159. package/dist/embeddings/openai.js +48 -0
  160. package/dist/embeddings/openai.js.map +1 -0
  161. package/dist/embeddings/resilience.d.ts +5 -0
  162. package/dist/embeddings/resilience.d.ts.map +1 -0
  163. package/dist/embeddings/resilience.js +53 -0
  164. package/dist/embeddings/resilience.js.map +1 -0
  165. package/dist/embeddings/voyage.d.ts +30 -0
  166. package/dist/embeddings/voyage.d.ts.map +1 -0
  167. package/dist/embeddings/voyage.js +53 -0
  168. package/dist/embeddings/voyage.js.map +1 -0
  169. package/dist/index.d.ts +72 -0
  170. package/dist/index.d.ts.map +1 -0
  171. package/dist/index.js +40 -0
  172. package/dist/index.js.map +1 -0
  173. package/dist/integrations/claude-agent.d.ts +21 -0
  174. package/dist/integrations/claude-agent.d.ts.map +1 -0
  175. package/dist/integrations/claude-agent.js +44 -0
  176. package/dist/integrations/claude-agent.js.map +1 -0
  177. package/dist/integrations/claude-tools.d.ts +18 -0
  178. package/dist/integrations/claude-tools.d.ts.map +1 -0
  179. package/dist/integrations/claude-tools.js +60 -0
  180. package/dist/integrations/claude-tools.js.map +1 -0
  181. package/dist/integrations/langchain.d.ts +24 -0
  182. package/dist/integrations/langchain.d.ts.map +1 -0
  183. package/dist/integrations/langchain.js +48 -0
  184. package/dist/integrations/langchain.js.map +1 -0
  185. package/dist/integrations/mcp.d.ts +23 -0
  186. package/dist/integrations/mcp.d.ts.map +1 -0
  187. package/dist/integrations/mcp.js +60 -0
  188. package/dist/integrations/mcp.js.map +1 -0
  189. package/dist/integrations/middleware.d.ts +15 -0
  190. package/dist/integrations/middleware.d.ts.map +1 -0
  191. package/dist/integrations/middleware.js +27 -0
  192. package/dist/integrations/middleware.js.map +1 -0
  193. package/dist/integrations/openai-tools.d.ts +21 -0
  194. package/dist/integrations/openai-tools.d.ts.map +1 -0
  195. package/dist/integrations/openai-tools.js +69 -0
  196. package/dist/integrations/openai-tools.js.map +1 -0
  197. package/dist/integrations/vercel-ai.d.ts +19 -0
  198. package/dist/integrations/vercel-ai.d.ts.map +1 -0
  199. package/dist/integrations/vercel-ai.js +41 -0
  200. package/dist/integrations/vercel-ai.js.map +1 -0
  201. package/dist/server/http-server.d.ts +61 -0
  202. package/dist/server/http-server.d.ts.map +1 -0
  203. package/dist/server/http-server.js +684 -0
  204. package/dist/server/http-server.js.map +1 -0
  205. package/dist/server/index.d.ts +5 -0
  206. package/dist/server/index.d.ts.map +1 -0
  207. package/dist/server/index.js +3 -0
  208. package/dist/server/index.js.map +1 -0
  209. package/dist/server/mcp-server.d.ts +61 -0
  210. package/dist/server/mcp-server.d.ts.map +1 -0
  211. package/dist/server/mcp-server.js +465 -0
  212. package/dist/server/mcp-server.js.map +1 -0
  213. package/dist/summarizers/claude.d.ts +11 -0
  214. package/dist/summarizers/claude.d.ts.map +1 -0
  215. package/dist/summarizers/claude.js +39 -0
  216. package/dist/summarizers/claude.js.map +1 -0
  217. package/dist/summarizers/client.d.ts +23 -0
  218. package/dist/summarizers/client.d.ts.map +1 -0
  219. package/dist/summarizers/client.js +24 -0
  220. package/dist/summarizers/client.js.map +1 -0
  221. package/dist/summarizers/extractive.d.ts +6 -0
  222. package/dist/summarizers/extractive.d.ts.map +1 -0
  223. package/dist/summarizers/extractive.js +204 -0
  224. package/dist/summarizers/extractive.js.map +1 -0
  225. package/dist/summarizers/extractor.d.ts +12 -0
  226. package/dist/summarizers/extractor.d.ts.map +1 -0
  227. package/dist/summarizers/extractor.js +75 -0
  228. package/dist/summarizers/extractor.js.map +1 -0
  229. package/dist/summarizers/openai.d.ts +11 -0
  230. package/dist/summarizers/openai.d.ts.map +1 -0
  231. package/dist/summarizers/openai.js +41 -0
  232. package/dist/summarizers/openai.js.map +1 -0
  233. package/dist/summarizers/prompts.d.ts +11 -0
  234. package/dist/summarizers/prompts.d.ts.map +1 -0
  235. package/dist/summarizers/prompts.js +104 -0
  236. package/dist/summarizers/prompts.js.map +1 -0
  237. package/docs/DEPLOYMENT.md +84 -0
  238. package/docs/INTEGRATIONS.md +64 -0
  239. package/docs/MEMORY_QUALITY_BASELINE.md +55 -0
  240. package/docs/MEMORY_QUALITY_RELEASE_GATE.md +63 -0
  241. package/docs/MEMORY_QUALITY_RUBRIC.md +249 -0
  242. package/docs/OPERATIONS.md +49 -0
  243. package/docs/SECURITY.md +25 -0
  244. package/openapi.yaml +843 -0
  245. package/package.json +157 -0
@@ -0,0 +1,650 @@
1
+ import { normalizeScope } from '../../contracts/identity.js';
2
+ import { estimateTokens } from '../../core/tokens.js';
3
+ import { emitMemoryEvent } from '../../core/telemetry.js';
4
+ import { matchesKnowledgeSearchOptions } from '../../core/retrieval.js';
5
+ import { assertArchiveInput, nowSeconds, validateContextMonitorUpsert, validateNewCompactionLog, validateNewKnowledgeCandidate, validateNewKnowledgeEvidence, validateNewKnowledgeMemory, validateNewKnowledgeMemoryAudit, validateNewTurn, validateNewWorkItem, validateNewWorkingMemory, validateTimeRange, } from '../../core/validation.js';
6
+ import { createInMemoryEmbeddingAdapter } from './embeddings.js';
7
+ const SCHEMA_VERSION = 1;
8
+ function matchesScope(item, scope) {
9
+ const left = normalizeScope(item);
10
+ const right = normalizeScope(scope);
11
+ return (left.tenant_id === right.tenant_id &&
12
+ left.system_id === right.system_id &&
13
+ left.workspace_id === right.workspace_id &&
14
+ left.collaboration_id === right.collaboration_id &&
15
+ left.scope_id === right.scope_id);
16
+ }
17
+ function matchesScopedSession(item, scope, sessionId) {
18
+ return matchesScope(item, scope) && (sessionId == null || item.session_id === sessionId);
19
+ }
20
+ function matchesLevel(item, scope, level) {
21
+ const left = normalizeScope(item);
22
+ const right = normalizeScope(scope);
23
+ if (left.tenant_id !== right.tenant_id)
24
+ return false;
25
+ if (level === 'tenant')
26
+ return true;
27
+ const explicitCollaboration = left.collaboration_id.length > 0 && right.collaboration_id.length > 0;
28
+ if (level === 'workspace' && explicitCollaboration) {
29
+ return left.collaboration_id === right.collaboration_id;
30
+ }
31
+ if (left.system_id !== right.system_id)
32
+ return false;
33
+ if (level === 'system')
34
+ return true;
35
+ if (explicitCollaboration) {
36
+ if (left.collaboration_id !== right.collaboration_id)
37
+ return false;
38
+ }
39
+ else if (left.workspace_id !== right.workspace_id) {
40
+ return false;
41
+ }
42
+ if (level === 'workspace')
43
+ return true;
44
+ return left.scope_id === right.scope_id;
45
+ }
46
+ function inRange(createdAt, range) {
47
+ validateTimeRange(range);
48
+ if (range.start_at !== undefined && createdAt < range.start_at)
49
+ return false;
50
+ if (range.end_at !== undefined && createdAt > range.end_at)
51
+ return false;
52
+ return true;
53
+ }
54
+ function tokenize(text) {
55
+ return text
56
+ .toLowerCase()
57
+ .split(/[^a-z0-9]+/g)
58
+ .filter((token) => token.length > 0);
59
+ }
60
+ function scoreText(query, text) {
61
+ const queryTokens = new Set(tokenize(query));
62
+ const textTokens = new Set(tokenize(text));
63
+ if (queryTokens.size === 0 || textTokens.size === 0)
64
+ return 0;
65
+ let matches = 0;
66
+ for (const token of queryTokens) {
67
+ if (textTokens.has(token))
68
+ matches += 1;
69
+ }
70
+ if (matches === 0)
71
+ return 0;
72
+ const containsWhole = text.toLowerCase().includes(query.toLowerCase()) ? 0.25 : 0;
73
+ return matches / queryTokens.size + containsWhole;
74
+ }
75
+ function resolveSearchOptions(options) {
76
+ return {
77
+ limit: options?.limit ?? 10,
78
+ activeOnly: options?.activeOnly ?? true,
79
+ includeProvisional: options?.includeProvisional ?? false,
80
+ includeDisputed: options?.includeDisputed ?? false,
81
+ minimumTrustScore: options?.minimumTrustScore ?? 0,
82
+ knowledgeStates: options?.knowledgeStates ?? [],
83
+ knowledgeClasses: options?.knowledgeClasses ?? [],
84
+ preferLocalTrusted: options?.preferLocalTrusted ?? false,
85
+ preferLineageMemory: options?.preferLineageMemory ?? false,
86
+ };
87
+ }
88
+ function resolvePaginationOptions(options) {
89
+ return {
90
+ limit: options?.limit ?? 25,
91
+ offset: options?.offset ?? 0,
92
+ cursor: options?.cursor ?? 0,
93
+ };
94
+ }
95
+ function paginateItems(items, options) {
96
+ const resolved = resolvePaginationOptions(options);
97
+ const ordered = [...items].sort((a, b) => a.id - b.id);
98
+ const filtered = resolved.cursor > 0 ? ordered.filter((item) => item.id > resolved.cursor) : ordered.slice(resolved.offset);
99
+ const page = filtered.slice(0, resolved.limit + 1);
100
+ const hasMore = page.length > resolved.limit;
101
+ const itemsPage = hasMore ? page.slice(0, resolved.limit) : page;
102
+ return {
103
+ items: itemsPage,
104
+ hasMore,
105
+ nextCursor: hasMore ? itemsPage[itemsPage.length - 1]?.id ?? null : null,
106
+ };
107
+ }
108
+ export function createInMemoryAdapter(telemetry) {
109
+ const state = {
110
+ turns: [],
111
+ workingMemory: [],
112
+ knowledgeMemory: [],
113
+ knowledgeCandidates: [],
114
+ knowledgeEvidence: [],
115
+ knowledgeAudits: [],
116
+ workItems: [],
117
+ contextMonitors: [],
118
+ compactionLogs: [],
119
+ };
120
+ const ids = {
121
+ turn: 1,
122
+ workingMemory: 1,
123
+ knowledgeMemory: 1,
124
+ knowledgeCandidate: 1,
125
+ knowledgeEvidence: 1,
126
+ knowledgeAudit: 1,
127
+ workItem: 1,
128
+ contextMonitor: 1,
129
+ compactionLog: 1,
130
+ };
131
+ return {
132
+ insertTurn(input) {
133
+ const scope = validateNewTurn(input);
134
+ const turn = {
135
+ ...scope,
136
+ id: ids.turn++,
137
+ session_id: input.session_id,
138
+ actor: input.actor,
139
+ role: input.role,
140
+ content: input.content,
141
+ priority: input.priority ?? (input.role === 'system' ? 1.5 : 1),
142
+ token_estimate: input.token_estimate ?? estimateTokens(input.content),
143
+ created_at: input.created_at ?? nowSeconds(),
144
+ archived_at: null,
145
+ compaction_log_id: null,
146
+ schema_version: SCHEMA_VERSION,
147
+ };
148
+ state.turns.push(turn);
149
+ return turn;
150
+ },
151
+ insertTurns(inputs) {
152
+ return inputs.map((input) => this.insertTurn(input));
153
+ },
154
+ getTurnById(id) {
155
+ return state.turns.find((turn) => turn.id === id) ?? null;
156
+ },
157
+ getActiveTurns(scope, sessionId) {
158
+ return state.turns.filter((turn) => matchesScopedSession(turn, scope, sessionId) && turn.archived_at === null);
159
+ },
160
+ getActiveTurnsPaginated(scope, options) {
161
+ return paginateItems(state.turns.filter((turn) => matchesScope(turn, scope) && turn.archived_at === null), options);
162
+ },
163
+ getTurnsByTimeRange(scope, range) {
164
+ return state.turns.filter((turn) => matchesScope(turn, scope) && inRange(turn.created_at, range));
165
+ },
166
+ searchTurns(scope, query, options) {
167
+ const startedAt = Date.now();
168
+ const resolved = resolveSearchOptions(options);
169
+ const results = state.turns
170
+ .filter((turn) => matchesScope(turn, scope) && (!resolved.activeOnly || turn.archived_at === null))
171
+ .map((turn) => ({
172
+ item: turn,
173
+ rank: scoreText(query, turn.content),
174
+ }))
175
+ .filter((result) => result.rank > 0)
176
+ .sort((a, b) => b.rank - a.rank || b.item.created_at - a.item.created_at)
177
+ .slice(0, resolved.limit);
178
+ emitMemoryEvent('search', scope, telemetry, Date.now() - startedAt, {
179
+ entity: 'turn',
180
+ query,
181
+ resultCount: results.length,
182
+ });
183
+ return results;
184
+ },
185
+ archiveTurn(id, archivedAt, compactionLogId) {
186
+ assertArchiveInput(id, archivedAt, compactionLogId);
187
+ const turn = state.turns.find((item) => item.id === id);
188
+ if (!turn)
189
+ return;
190
+ turn.archived_at = archivedAt;
191
+ turn.compaction_log_id = compactionLogId;
192
+ },
193
+ getArchivedTurnRange(sessionId, startId, endId, scope) {
194
+ return state.turns.filter((turn) => turn.session_id === sessionId &&
195
+ turn.id >= startId &&
196
+ turn.id <= endId &&
197
+ turn.archived_at !== null &&
198
+ matchesScope(turn, scope));
199
+ },
200
+ insertWorkingMemory(input) {
201
+ const scope = validateNewWorkingMemory(input);
202
+ const createdAt = nowSeconds();
203
+ const record = {
204
+ ...scope,
205
+ id: ids.workingMemory++,
206
+ session_id: input.session_id,
207
+ summary: input.summary,
208
+ key_entities: [...input.key_entities],
209
+ topic_tags: [...input.topic_tags],
210
+ turn_id_start: input.turn_id_start,
211
+ turn_id_end: input.turn_id_end,
212
+ turn_count: input.turn_count,
213
+ compaction_trigger: input.compaction_trigger,
214
+ created_at: createdAt,
215
+ expires_at: input.expires_at ?? createdAt + 86400,
216
+ promoted_to_knowledge_id: null,
217
+ schema_version: SCHEMA_VERSION,
218
+ };
219
+ state.workingMemory.push(record);
220
+ return record;
221
+ },
222
+ getWorkingMemoryById(id) {
223
+ return state.workingMemory.find((item) => item.id === id) ?? null;
224
+ },
225
+ getWorkingMemoryBySession(sessionId, scope) {
226
+ return state.workingMemory.filter((item) => item.session_id === sessionId && matchesScope(item, scope));
227
+ },
228
+ getActiveWorkingMemory(scope, sessionId) {
229
+ const now = nowSeconds();
230
+ return state.workingMemory.filter((item) => matchesScopedSession(item, scope, sessionId) &&
231
+ (item.expires_at === null || item.expires_at > now));
232
+ },
233
+ getLatestWorkingMemory(scope, sessionId) {
234
+ return (this.getActiveWorkingMemory(scope, sessionId).sort((a, b) => b.id - a.id)[0] ?? null);
235
+ },
236
+ getWorkingMemoryByTimeRange(scope, range) {
237
+ return state.workingMemory.filter((item) => matchesScope(item, scope) && inRange(item.created_at, range));
238
+ },
239
+ expireWorkingMemory(id) {
240
+ const item = state.workingMemory.find((entry) => entry.id === id);
241
+ if (item)
242
+ item.expires_at = nowSeconds();
243
+ },
244
+ markWorkingMemoryPromoted(id, knowledgeMemoryId) {
245
+ const item = state.workingMemory.find((entry) => entry.id === id);
246
+ if (item)
247
+ item.promoted_to_knowledge_id = knowledgeMemoryId;
248
+ },
249
+ insertKnowledgeMemory(input) {
250
+ const scope = validateNewKnowledgeMemory(input);
251
+ const createdAt = nowSeconds();
252
+ const record = {
253
+ ...scope,
254
+ id: ids.knowledgeMemory++,
255
+ fact: input.fact,
256
+ fact_type: input.fact_type,
257
+ knowledge_state: input.knowledge_state ?? 'trusted',
258
+ knowledge_class: input.knowledge_class ?? 'project_fact',
259
+ fact_subject: input.fact_subject ?? null,
260
+ fact_attribute: input.fact_attribute ?? null,
261
+ fact_value: input.fact_value ?? null,
262
+ normalized_fact: input.normalized_fact ?? null,
263
+ slot_key: input.slot_key ?? null,
264
+ is_negated: input.is_negated ?? false,
265
+ source: input.source,
266
+ confidence: input.confidence,
267
+ confidence_score: input.confidence_score ?? 0.5,
268
+ grounding_strength: input.grounding_strength ?? 'moderate',
269
+ evidence_count: input.evidence_count ?? Math.max(1, (input.source_turn_ids ?? []).length),
270
+ trust_score: input.trust_score ?? (input.confidence_score ?? 0.5),
271
+ verification_status: input.verification_status ?? 'unverified',
272
+ verification_notes: input.verification_notes ?? null,
273
+ last_verified_at: input.last_verified_at ?? null,
274
+ next_reverification_at: input.next_reverification_at ?? null,
275
+ last_confirmed_at: input.last_confirmed_at ?? null,
276
+ confirmation_count: input.confirmation_count ?? 0,
277
+ source_system_id: input.source_system_id ?? scope.system_id,
278
+ source_scope_id: input.source_scope_id ?? scope.scope_id,
279
+ source_collaboration_id: input.source_collaboration_id ?? scope.collaboration_id,
280
+ source_working_memory_id: input.source_working_memory_id ?? null,
281
+ source_turn_ids: input.source_turn_ids ?? [],
282
+ successful_use_count: input.successful_use_count ?? 0,
283
+ failed_use_count: input.failed_use_count ?? 0,
284
+ disputed_at: input.disputed_at ?? null,
285
+ dispute_reason: input.dispute_reason ?? null,
286
+ contradiction_score: input.contradiction_score ?? 0,
287
+ superseded_at: input.superseded_at ?? null,
288
+ superseded_by_id: null,
289
+ retired_at: input.retired_at ?? null,
290
+ created_at: createdAt,
291
+ last_accessed_at: createdAt,
292
+ access_count: 1,
293
+ schema_version: SCHEMA_VERSION,
294
+ };
295
+ state.knowledgeMemory.push(record);
296
+ return record;
297
+ },
298
+ insertKnowledgeMemories(inputs) {
299
+ return inputs.map((input) => this.insertKnowledgeMemory(input));
300
+ },
301
+ insertKnowledgeCandidate(input) {
302
+ const scope = validateNewKnowledgeCandidate(input);
303
+ const record = {
304
+ ...scope,
305
+ id: ids.knowledgeCandidate++,
306
+ working_memory_id: input.working_memory_id,
307
+ fact: input.fact,
308
+ fact_type: input.fact_type,
309
+ knowledge_class: input.knowledge_class,
310
+ normalized_fact: input.normalized_fact,
311
+ slot_key: input.slot_key ?? null,
312
+ confidence: input.confidence,
313
+ source_summary: input.source_summary ?? false,
314
+ source_turns: input.source_turns ?? true,
315
+ grounding_strength: input.grounding_strength ?? 'weak',
316
+ evidence_count: input.evidence_count ?? 0,
317
+ trust_score: input.trust_score ?? 0,
318
+ state: input.state ?? 'candidate',
319
+ created_at: input.created_at ?? nowSeconds(),
320
+ promoted_knowledge_id: input.promoted_knowledge_id ?? null,
321
+ };
322
+ state.knowledgeCandidates.push(record);
323
+ return record;
324
+ },
325
+ insertKnowledgeCandidates(inputs) {
326
+ return inputs.map((input) => this.insertKnowledgeCandidate(input));
327
+ },
328
+ getKnowledgeCandidateById(id) {
329
+ return state.knowledgeCandidates.find((item) => item.id === id) ?? null;
330
+ },
331
+ listKnowledgeCandidates(scope, options) {
332
+ return state.knowledgeCandidates.filter((item) => matchesScope(item, scope) &&
333
+ (!options?.state || options.state.includes(item.state)));
334
+ },
335
+ insertKnowledgeEvidence(input) {
336
+ const scope = validateNewKnowledgeEvidence(input);
337
+ const record = {
338
+ ...scope,
339
+ id: ids.knowledgeEvidence++,
340
+ knowledge_memory_id: input.knowledge_memory_id ?? null,
341
+ knowledge_candidate_id: input.knowledge_candidate_id ?? null,
342
+ working_memory_id: input.working_memory_id ?? null,
343
+ turn_id: input.turn_id ?? null,
344
+ source_type: input.source_type,
345
+ support_polarity: input.support_polarity,
346
+ speaker_role: input.speaker_role ?? null,
347
+ actor: input.actor ?? null,
348
+ excerpt: input.excerpt,
349
+ start_offset: input.start_offset ?? null,
350
+ end_offset: input.end_offset ?? null,
351
+ is_explicit: input.is_explicit ?? false,
352
+ explicitness_score: input.explicitness_score ?? 0,
353
+ outcome: input.outcome ?? null,
354
+ created_at: input.created_at ?? nowSeconds(),
355
+ };
356
+ state.knowledgeEvidence.push(record);
357
+ return record;
358
+ },
359
+ insertKnowledgeEvidenceBatch(inputs) {
360
+ return inputs.map((input) => this.insertKnowledgeEvidence(input));
361
+ },
362
+ listKnowledgeEvidenceForKnowledge(knowledgeId) {
363
+ return state.knowledgeEvidence.filter((item) => item.knowledge_memory_id === knowledgeId);
364
+ },
365
+ listKnowledgeEvidenceForCandidate(candidateId) {
366
+ return state.knowledgeEvidence.filter((item) => item.knowledge_candidate_id === candidateId);
367
+ },
368
+ promoteKnowledgeCandidate(candidateId, input) {
369
+ const candidate = state.knowledgeCandidates.find((item) => item.id === candidateId);
370
+ const knowledge = this.insertKnowledgeMemory(input);
371
+ if (candidate) {
372
+ candidate.promoted_knowledge_id = knowledge.id;
373
+ candidate.state = 'provisional';
374
+ }
375
+ return knowledge;
376
+ },
377
+ getKnowledgeMemoryById(id) {
378
+ return state.knowledgeMemory.find((item) => item.id === id) ?? null;
379
+ },
380
+ getActiveKnowledgeMemory(scope) {
381
+ return state.knowledgeMemory.filter((item) => matchesScope(item, scope) && item.superseded_by_id === null && item.retired_at === null);
382
+ },
383
+ getActiveKnowledgeMemoryPaginated(scope, options) {
384
+ return paginateItems(state.knowledgeMemory.filter((item) => matchesScope(item, scope) &&
385
+ item.superseded_by_id === null &&
386
+ item.retired_at === null), options);
387
+ },
388
+ getActiveKnowledgeCrossScope(scope, level) {
389
+ return state.knowledgeMemory.filter((item) => matchesLevel(item, scope, level) &&
390
+ item.superseded_by_id === null &&
391
+ item.retired_at === null);
392
+ },
393
+ getKnowledgeSince(scope, level, since) {
394
+ return state.knowledgeMemory.filter((item) => matchesLevel(item, scope, level) &&
395
+ item.created_at >= since &&
396
+ item.superseded_by_id === null &&
397
+ item.retired_at === null);
398
+ },
399
+ getKnowledgeByTimeRange(scope, range) {
400
+ return state.knowledgeMemory.filter((item) => matchesScope(item, scope) && inRange(item.created_at, range));
401
+ },
402
+ searchKnowledge(scope, query, options) {
403
+ const startedAt = Date.now();
404
+ const resolved = resolveSearchOptions(options);
405
+ const results = state.knowledgeMemory
406
+ .filter((item) => matchesScope(item, scope) &&
407
+ (!resolved.activeOnly ||
408
+ (item.superseded_by_id === null && item.retired_at === null)))
409
+ .filter((item) => matchesKnowledgeSearchOptions(item, resolved))
410
+ .map((item) => ({
411
+ item,
412
+ rank: scoreText(query, item.fact),
413
+ }))
414
+ .filter((result) => result.rank > 0)
415
+ .sort((a, b) => b.rank - a.rank || b.item.last_accessed_at - a.item.last_accessed_at)
416
+ .slice(0, resolved.limit);
417
+ emitMemoryEvent('search', scope, telemetry, Date.now() - startedAt, {
418
+ entity: 'knowledge',
419
+ query,
420
+ resultCount: results.length,
421
+ });
422
+ return results;
423
+ },
424
+ searchKnowledgeCrossScope(scope, level, query, options) {
425
+ const startedAt = Date.now();
426
+ const resolved = resolveSearchOptions(options);
427
+ const results = state.knowledgeMemory
428
+ .filter((item) => matchesLevel(item, scope, level) &&
429
+ (!resolved.activeOnly ||
430
+ (item.superseded_by_id === null && item.retired_at === null)))
431
+ .filter((item) => matchesKnowledgeSearchOptions(item, resolved))
432
+ .map((item) => ({
433
+ item,
434
+ rank: scoreText(query, item.fact),
435
+ }))
436
+ .filter((result) => result.rank > 0)
437
+ .sort((a, b) => b.rank - a.rank || b.item.last_accessed_at - a.item.last_accessed_at)
438
+ .slice(0, resolved.limit);
439
+ emitMemoryEvent('search', scope, telemetry, Date.now() - startedAt, {
440
+ entity: 'knowledge',
441
+ query,
442
+ resultCount: results.length,
443
+ scopeLevel: level,
444
+ });
445
+ return results;
446
+ },
447
+ insertKnowledgeMemoryAudit(input) {
448
+ const scope = validateNewKnowledgeMemoryAudit(input);
449
+ const record = {
450
+ ...scope,
451
+ id: ids.knowledgeAudit++,
452
+ working_memory_id: input.working_memory_id ?? null,
453
+ fact: input.fact,
454
+ fact_type: input.fact_type,
455
+ fact_subject: input.fact_subject ?? null,
456
+ fact_attribute: input.fact_attribute ?? null,
457
+ fact_value: input.fact_value ?? null,
458
+ normalized_fact: input.normalized_fact ?? null,
459
+ slot_key: input.slot_key ?? null,
460
+ is_negated: input.is_negated ?? false,
461
+ confidence: input.confidence,
462
+ confidence_score: input.confidence_score ?? 0.5,
463
+ verification_status: input.verification_status ?? 'unverified',
464
+ source_text: input.source_text ?? null,
465
+ decision: input.decision,
466
+ created_knowledge_id: input.created_knowledge_id ?? null,
467
+ related_knowledge_id: input.related_knowledge_id ?? null,
468
+ detail: input.detail ?? null,
469
+ created_at: input.created_at ?? nowSeconds(),
470
+ };
471
+ state.knowledgeAudits.push(record);
472
+ return record;
473
+ },
474
+ getRecentKnowledgeMemoryAudits(scope, limit = 10) {
475
+ return state.knowledgeAudits
476
+ .filter((item) => matchesScope(item, scope))
477
+ .sort((a, b) => b.id - a.id)
478
+ .slice(0, limit);
479
+ },
480
+ getKnowledgeMemoryAuditsForKnowledge(scope, knowledgeId, limit = 10) {
481
+ return state.knowledgeAudits
482
+ .filter((item) => matchesScope(item, scope) &&
483
+ (item.created_knowledge_id === knowledgeId || item.related_knowledge_id === knowledgeId))
484
+ .sort((a, b) => b.id - a.id)
485
+ .slice(0, limit);
486
+ },
487
+ updateKnowledgeMemory(id, patch) {
488
+ const item = state.knowledgeMemory.find((entry) => entry.id === id);
489
+ if (!item)
490
+ return null;
491
+ if (patch.knowledge_state !== undefined)
492
+ item.knowledge_state = patch.knowledge_state;
493
+ if (patch.knowledge_class !== undefined)
494
+ item.knowledge_class = patch.knowledge_class;
495
+ if (patch.trust_score !== undefined)
496
+ item.trust_score = patch.trust_score;
497
+ if (patch.verification_status !== undefined)
498
+ item.verification_status = patch.verification_status;
499
+ if (patch.verification_notes !== undefined)
500
+ item.verification_notes = patch.verification_notes;
501
+ if (patch.last_verified_at !== undefined)
502
+ item.last_verified_at = patch.last_verified_at;
503
+ if (patch.next_reverification_at !== undefined) {
504
+ item.next_reverification_at = patch.next_reverification_at;
505
+ }
506
+ if (patch.last_confirmed_at !== undefined)
507
+ item.last_confirmed_at = patch.last_confirmed_at;
508
+ if (patch.confirmation_count !== undefined)
509
+ item.confirmation_count = patch.confirmation_count;
510
+ if (patch.disputed_at !== undefined)
511
+ item.disputed_at = patch.disputed_at;
512
+ if (patch.dispute_reason !== undefined)
513
+ item.dispute_reason = patch.dispute_reason;
514
+ if (patch.contradiction_score !== undefined)
515
+ item.contradiction_score = patch.contradiction_score;
516
+ if (patch.superseded_at !== undefined)
517
+ item.superseded_at = patch.superseded_at;
518
+ if (patch.successful_use_count !== undefined)
519
+ item.successful_use_count = patch.successful_use_count;
520
+ if (patch.failed_use_count !== undefined)
521
+ item.failed_use_count = patch.failed_use_count;
522
+ return item;
523
+ },
524
+ touchKnowledgeMemory(id) {
525
+ const item = state.knowledgeMemory.find((entry) => entry.id === id);
526
+ if (!item)
527
+ return;
528
+ item.last_accessed_at = nowSeconds();
529
+ item.access_count += 1;
530
+ },
531
+ retireKnowledgeMemory(id, retiredAt = nowSeconds()) {
532
+ const item = state.knowledgeMemory.find((entry) => entry.id === id);
533
+ if (item)
534
+ item.retired_at = retiredAt;
535
+ },
536
+ supersedeKnowledgeMemory(oldId, newId) {
537
+ const item = state.knowledgeMemory.find((entry) => entry.id === oldId);
538
+ if (item) {
539
+ item.superseded_by_id = newId;
540
+ item.superseded_at = nowSeconds();
541
+ item.knowledge_state = 'superseded';
542
+ }
543
+ },
544
+ insertWorkItem(input) {
545
+ const scope = validateNewWorkItem(input);
546
+ const createdAt = input.created_at ?? nowSeconds();
547
+ const item = {
548
+ ...scope,
549
+ id: ids.workItem++,
550
+ session_id: input.session_id ?? null,
551
+ kind: input.kind,
552
+ title: input.title,
553
+ detail: input.detail ?? null,
554
+ status: input.status ?? 'open',
555
+ source_working_memory_id: input.source_working_memory_id ?? null,
556
+ created_at: createdAt,
557
+ updated_at: createdAt,
558
+ };
559
+ state.workItems.push(item);
560
+ return item;
561
+ },
562
+ getActiveWorkItems(scope) {
563
+ return state.workItems.filter((item) => matchesScope(item, scope) && item.status !== 'done');
564
+ },
565
+ getWorkItemsByTimeRange(scope, range) {
566
+ return state.workItems.filter((item) => matchesScope(item, scope) && inRange(item.created_at, range));
567
+ },
568
+ updateWorkItemStatus(id, status) {
569
+ const item = state.workItems.find((entry) => entry.id === id);
570
+ if (!item)
571
+ return;
572
+ item.status = status;
573
+ item.updated_at = nowSeconds();
574
+ },
575
+ deleteWorkItem(id) {
576
+ const index = state.workItems.findIndex((item) => item.id === id);
577
+ if (index >= 0)
578
+ state.workItems.splice(index, 1);
579
+ },
580
+ upsertContextMonitor(input) {
581
+ const scope = validateContextMonitorUpsert(input);
582
+ const existing = state.contextMonitors.find((item) => matchesScope(item, scope));
583
+ if (existing) {
584
+ existing.compaction_state = input.compaction_state;
585
+ existing.last_compaction_at = input.last_compaction_at ?? null;
586
+ existing.active_turn_count = input.active_turn_count;
587
+ existing.active_token_estimate = input.active_token_estimate;
588
+ existing.compaction_score = input.compaction_score;
589
+ existing.updated_at = nowSeconds();
590
+ return existing;
591
+ }
592
+ const monitor = {
593
+ ...scope,
594
+ id: ids.contextMonitor++,
595
+ compaction_state: input.compaction_state,
596
+ last_compaction_at: input.last_compaction_at ?? null,
597
+ active_turn_count: input.active_turn_count,
598
+ active_token_estimate: input.active_token_estimate,
599
+ compaction_score: input.compaction_score,
600
+ updated_at: nowSeconds(),
601
+ };
602
+ state.contextMonitors.push(monitor);
603
+ return monitor;
604
+ },
605
+ getContextMonitor(scope) {
606
+ return state.contextMonitors.find((item) => matchesScope(item, scope)) ?? null;
607
+ },
608
+ insertCompactionLog(input) {
609
+ const scope = validateNewCompactionLog(input);
610
+ const item = {
611
+ ...scope,
612
+ id: ids.compactionLog++,
613
+ session_id: input.session_id,
614
+ trigger_type: input.trigger_type,
615
+ turn_id_start: input.turn_id_start,
616
+ turn_id_end: input.turn_id_end,
617
+ turns_compacted: input.turns_compacted,
618
+ tokens_compacted_estimate: input.tokens_compacted_estimate,
619
+ working_memory_id: input.working_memory_id,
620
+ active_turn_count_before: input.active_turn_count_before,
621
+ active_turn_count_after: input.active_turn_count_after,
622
+ duration_ms: input.duration_ms,
623
+ model_call_made: input.model_call_made ?? true,
624
+ error: input.error ?? null,
625
+ created_at: input.created_at ?? nowSeconds(),
626
+ };
627
+ state.compactionLogs.push(item);
628
+ return item;
629
+ },
630
+ getCompactionLogById(id) {
631
+ return state.compactionLogs.find((item) => item.id === id) ?? null;
632
+ },
633
+ getRecentCompactionLogs(scope, limit = 10) {
634
+ return state.compactionLogs
635
+ .filter((item) => matchesScope(item, scope))
636
+ .sort((a, b) => b.id - a.id)
637
+ .slice(0, limit);
638
+ },
639
+ transaction(fn) {
640
+ return fn();
641
+ },
642
+ close() { },
643
+ };
644
+ }
645
+ export function createInMemoryAdapterWithEmbeddings(telemetry) {
646
+ const adapter = createInMemoryAdapter(telemetry);
647
+ const embeddings = createInMemoryEmbeddingAdapter(adapter);
648
+ return Object.assign(adapter, { embeddings });
649
+ }
650
+ //# sourceMappingURL=index.js.map