@agentmemory/agentmemory 0.7.2 → 0.7.3

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 (217) hide show
  1. package/AGENTS.md +2 -2
  2. package/README.md +41 -68
  3. package/dist/cli.mjs +3 -3
  4. package/dist/index.mjs +3 -2
  5. package/dist/index.mjs.map +1 -1
  6. package/dist/{src-1fTKFEtN.mjs → src-sYZDDbiA.mjs} +4 -3
  7. package/dist/src-sYZDDbiA.mjs.map +1 -0
  8. package/dist/standalone.mjs +1 -1
  9. package/dist/standalone.mjs.map +1 -1
  10. package/package.json +10 -1
  11. package/plugin/.claude-plugin/plugin.json +1 -1
  12. package/plugin/scripts/notification.d.mts +1 -0
  13. package/plugin/scripts/notification.mjs.map +1 -0
  14. package/plugin/scripts/post-tool-failure.d.mts +1 -0
  15. package/plugin/scripts/post-tool-failure.mjs.map +1 -0
  16. package/plugin/scripts/post-tool-use.d.mts +1 -0
  17. package/plugin/scripts/post-tool-use.mjs.map +1 -0
  18. package/plugin/scripts/pre-compact.d.mts +1 -0
  19. package/plugin/scripts/pre-compact.mjs.map +1 -0
  20. package/plugin/scripts/pre-tool-use.d.mts +1 -0
  21. package/plugin/scripts/pre-tool-use.mjs.map +1 -0
  22. package/plugin/scripts/prompt-submit.d.mts +1 -0
  23. package/plugin/scripts/prompt-submit.mjs.map +1 -0
  24. package/plugin/scripts/session-end.d.mts +1 -0
  25. package/plugin/scripts/session-end.mjs.map +1 -0
  26. package/plugin/scripts/session-start.d.mts +1 -0
  27. package/plugin/scripts/session-start.mjs.map +1 -0
  28. package/plugin/scripts/stop.d.mts +1 -0
  29. package/plugin/scripts/stop.mjs.map +1 -0
  30. package/plugin/scripts/subagent-start.d.mts +1 -0
  31. package/plugin/scripts/subagent-start.mjs.map +1 -0
  32. package/plugin/scripts/subagent-stop.d.mts +1 -0
  33. package/plugin/scripts/subagent-stop.mjs.map +1 -0
  34. package/plugin/scripts/task-completed.d.mts +1 -0
  35. package/plugin/scripts/task-completed.mjs.map +1 -0
  36. package/.claude-plugin/marketplace.json +0 -14
  37. package/.github/workflows/ci.yml +0 -22
  38. package/.github/workflows/publish.yml +0 -28
  39. package/assets/banner.png +0 -0
  40. package/assets/demo.gif +0 -0
  41. package/assets/demo.mp4 +0 -0
  42. package/benchmark/QUALITY.md +0 -73
  43. package/benchmark/REAL-EMBEDDINGS.md +0 -67
  44. package/benchmark/SCALE.md +0 -110
  45. package/benchmark/dataset.ts +0 -293
  46. package/benchmark/quality-eval.ts +0 -643
  47. package/benchmark/real-embeddings-eval.ts +0 -405
  48. package/benchmark/scale-eval.ts +0 -398
  49. package/dist/src-1fTKFEtN.mjs.map +0 -1
  50. package/src/auth.ts +0 -12
  51. package/src/cli.ts +0 -251
  52. package/src/config.ts +0 -221
  53. package/src/eval/metrics-store.ts +0 -65
  54. package/src/eval/quality.ts +0 -51
  55. package/src/eval/schemas.ts +0 -124
  56. package/src/eval/self-correct.ts +0 -28
  57. package/src/eval/validator.ts +0 -31
  58. package/src/functions/actions.ts +0 -288
  59. package/src/functions/audit.ts +0 -61
  60. package/src/functions/auto-forget.ts +0 -169
  61. package/src/functions/branch-aware.ts +0 -169
  62. package/src/functions/cascade.ts +0 -80
  63. package/src/functions/checkpoints.ts +0 -209
  64. package/src/functions/claude-bridge.ts +0 -161
  65. package/src/functions/compress.ts +0 -194
  66. package/src/functions/consolidate.ts +0 -212
  67. package/src/functions/consolidation-pipeline.ts +0 -258
  68. package/src/functions/context.ts +0 -169
  69. package/src/functions/crystallize.ts +0 -293
  70. package/src/functions/dedup.ts +0 -57
  71. package/src/functions/diagnostics.ts +0 -785
  72. package/src/functions/enrich.ts +0 -132
  73. package/src/functions/evict.ts +0 -163
  74. package/src/functions/export-import.ts +0 -508
  75. package/src/functions/facets.ts +0 -248
  76. package/src/functions/file-index.ts +0 -106
  77. package/src/functions/flow-compress.ts +0 -214
  78. package/src/functions/frontier.ts +0 -196
  79. package/src/functions/governance.ts +0 -131
  80. package/src/functions/graph-retrieval.ts +0 -277
  81. package/src/functions/graph.ts +0 -275
  82. package/src/functions/leases.ts +0 -216
  83. package/src/functions/lessons.ts +0 -253
  84. package/src/functions/mesh.ts +0 -434
  85. package/src/functions/migrate.ts +0 -165
  86. package/src/functions/observe.ts +0 -144
  87. package/src/functions/obsidian-export.ts +0 -310
  88. package/src/functions/patterns.ts +0 -138
  89. package/src/functions/privacy.ts +0 -39
  90. package/src/functions/profile.ts +0 -155
  91. package/src/functions/query-expansion.ts +0 -186
  92. package/src/functions/relations.ts +0 -237
  93. package/src/functions/remember.ts +0 -162
  94. package/src/functions/retention.ts +0 -235
  95. package/src/functions/routines.ts +0 -289
  96. package/src/functions/search.ts +0 -80
  97. package/src/functions/sentinels.ts +0 -417
  98. package/src/functions/signals.ts +0 -186
  99. package/src/functions/sketches.ts +0 -274
  100. package/src/functions/sliding-window.ts +0 -257
  101. package/src/functions/smart-search.ts +0 -115
  102. package/src/functions/snapshot.ts +0 -219
  103. package/src/functions/summarize.ts +0 -155
  104. package/src/functions/team.ts +0 -147
  105. package/src/functions/temporal-graph.ts +0 -476
  106. package/src/functions/timeline.ts +0 -138
  107. package/src/functions/verify.ts +0 -117
  108. package/src/health/monitor.ts +0 -110
  109. package/src/health/thresholds.ts +0 -73
  110. package/src/hooks/notification.ts +0 -52
  111. package/src/hooks/post-tool-failure.ts +0 -58
  112. package/src/hooks/post-tool-use.ts +0 -62
  113. package/src/hooks/pre-compact.ts +0 -60
  114. package/src/hooks/pre-tool-use.ts +0 -72
  115. package/src/hooks/prompt-submit.ts +0 -46
  116. package/src/hooks/session-end.ts +0 -71
  117. package/src/hooks/session-start.ts +0 -48
  118. package/src/hooks/stop.ts +0 -39
  119. package/src/hooks/subagent-start.ts +0 -49
  120. package/src/hooks/subagent-stop.ts +0 -54
  121. package/src/hooks/task-completed.ts +0 -54
  122. package/src/index.ts +0 -342
  123. package/src/mcp/in-memory-kv.ts +0 -61
  124. package/src/mcp/server.ts +0 -1455
  125. package/src/mcp/standalone.ts +0 -177
  126. package/src/mcp/tools-registry.ts +0 -769
  127. package/src/mcp/transport.ts +0 -91
  128. package/src/prompts/compression.ts +0 -67
  129. package/src/prompts/consolidation.ts +0 -48
  130. package/src/prompts/graph-extraction.ts +0 -35
  131. package/src/prompts/summary.ts +0 -38
  132. package/src/prompts/xml.ts +0 -26
  133. package/src/providers/agent-sdk.ts +0 -34
  134. package/src/providers/anthropic.ts +0 -35
  135. package/src/providers/circuit-breaker.ts +0 -82
  136. package/src/providers/embedding/cohere.ts +0 -46
  137. package/src/providers/embedding/gemini.ts +0 -54
  138. package/src/providers/embedding/index.ts +0 -39
  139. package/src/providers/embedding/local.ts +0 -52
  140. package/src/providers/embedding/openai.ts +0 -45
  141. package/src/providers/embedding/openrouter.ts +0 -51
  142. package/src/providers/embedding/voyage.ts +0 -46
  143. package/src/providers/fallback-chain.ts +0 -31
  144. package/src/providers/index.ts +0 -84
  145. package/src/providers/openrouter.ts +0 -71
  146. package/src/providers/resilient.ts +0 -37
  147. package/src/state/hybrid-search.ts +0 -295
  148. package/src/state/index-persistence.ts +0 -63
  149. package/src/state/keyed-mutex.ts +0 -18
  150. package/src/state/kv.ts +0 -33
  151. package/src/state/schema.ts +0 -71
  152. package/src/state/search-index.ts +0 -245
  153. package/src/state/stemmer.ts +0 -104
  154. package/src/state/synonyms.ts +0 -63
  155. package/src/state/vector-index.ts +0 -130
  156. package/src/telemetry/setup.ts +0 -116
  157. package/src/triggers/api.ts +0 -1904
  158. package/src/triggers/events.ts +0 -71
  159. package/src/types.ts +0 -769
  160. package/src/version.ts +0 -1
  161. package/src/viewer/index.html +0 -2556
  162. package/src/viewer/server.ts +0 -207
  163. package/src/xenova.d.ts +0 -3
  164. package/test/actions.test.ts +0 -490
  165. package/test/audit.test.ts +0 -108
  166. package/test/auto-forget.test.ts +0 -188
  167. package/test/cascade.test.ts +0 -277
  168. package/test/checkpoints.test.ts +0 -493
  169. package/test/circuit-breaker.test.ts +0 -107
  170. package/test/claude-bridge.test.ts +0 -178
  171. package/test/confidence.test.ts +0 -247
  172. package/test/consistency.test.ts +0 -61
  173. package/test/consolidation-pipeline.test.ts +0 -251
  174. package/test/crystallize.test.ts +0 -521
  175. package/test/diagnostics.test.ts +0 -638
  176. package/test/embedding-provider.test.ts +0 -49
  177. package/test/enrich.test.ts +0 -209
  178. package/test/eval.test.ts +0 -300
  179. package/test/export-import.test.ts +0 -251
  180. package/test/facets.test.ts +0 -448
  181. package/test/fallback-chain.test.ts +0 -93
  182. package/test/frontier.test.ts +0 -485
  183. package/test/governance.test.ts +0 -147
  184. package/test/graph-retrieval.test.ts +0 -186
  185. package/test/graph.test.ts +0 -160
  186. package/test/helpers/mocks.ts +0 -40
  187. package/test/hybrid-search.test.ts +0 -145
  188. package/test/index-persistence.test.ts +0 -124
  189. package/test/integration.test.ts +0 -265
  190. package/test/leases.test.ts +0 -399
  191. package/test/mcp-prompts.test.ts +0 -218
  192. package/test/mcp-resources.test.ts +0 -286
  193. package/test/mcp-standalone.test.ts +0 -113
  194. package/test/mesh.test.ts +0 -700
  195. package/test/privacy.test.ts +0 -87
  196. package/test/profile.test.ts +0 -161
  197. package/test/query-expansion.test.ts +0 -154
  198. package/test/relations.test.ts +0 -198
  199. package/test/retention.test.ts +0 -245
  200. package/test/routines.test.ts +0 -497
  201. package/test/schema-fingerprint.test.ts +0 -81
  202. package/test/schema.test.ts +0 -42
  203. package/test/search-index.test.ts +0 -128
  204. package/test/sentinels.test.ts +0 -626
  205. package/test/signals.test.ts +0 -410
  206. package/test/sketches.test.ts +0 -549
  207. package/test/sliding-window.test.ts +0 -199
  208. package/test/smart-search.test.ts +0 -169
  209. package/test/snapshot.test.ts +0 -165
  210. package/test/team.test.ts +0 -156
  211. package/test/temporal-graph.test.ts +0 -378
  212. package/test/timeline.test.ts +0 -148
  213. package/test/vector-index.test.ts +0 -79
  214. package/test/verify.test.ts +0 -209
  215. package/test/xml.test.ts +0 -65
  216. package/tsconfig.json +0 -22
  217. package/tsdown.config.ts +0 -62
package/test/mesh.test.ts DELETED
@@ -1,700 +0,0 @@
1
- import { describe, it, expect, beforeEach, vi } from "vitest";
2
-
3
- vi.mock("iii-sdk", () => ({
4
- getContext: () => ({
5
- logger: { info: vi.fn(), error: vi.fn(), warn: vi.fn() },
6
- }),
7
- }));
8
-
9
- import { registerMeshFunction } from "../src/functions/mesh.js";
10
- import type {
11
- MeshPeer,
12
- Memory,
13
- Action,
14
- SemanticMemory,
15
- ProceduralMemory,
16
- MemoryRelation,
17
- GraphNode,
18
- GraphEdge,
19
- } from "../src/types.js";
20
-
21
- function mockKV() {
22
- const store = new Map<string, Map<string, unknown>>();
23
- return {
24
- get: async <T>(scope: string, key: string): Promise<T | null> => {
25
- return (store.get(scope)?.get(key) as T) ?? null;
26
- },
27
- set: async <T>(scope: string, key: string, data: T): Promise<T> => {
28
- if (!store.has(scope)) store.set(scope, new Map());
29
- store.get(scope)!.set(key, data);
30
- return data;
31
- },
32
- delete: async (scope: string, key: string): Promise<void> => {
33
- store.get(scope)?.delete(key);
34
- },
35
- list: async <T>(scope: string): Promise<T[]> => {
36
- const entries = store.get(scope);
37
- return entries ? (Array.from(entries.values()) as T[]) : [];
38
- },
39
- };
40
- }
41
-
42
- function mockSdk() {
43
- const functions = new Map<string, Function>();
44
- return {
45
- registerFunction: (opts: { id: string }, handler: Function) => {
46
- functions.set(opts.id, handler);
47
- },
48
- registerTrigger: () => {},
49
- trigger: async (id: string, data: unknown) => {
50
- const fn = functions.get(id);
51
- if (!fn) throw new Error(`No function: ${id}`);
52
- return fn(data);
53
- },
54
- };
55
- }
56
-
57
- describe("Mesh Functions", () => {
58
- let sdk: ReturnType<typeof mockSdk>;
59
- let kv: ReturnType<typeof mockKV>;
60
-
61
- beforeEach(() => {
62
- sdk = mockSdk();
63
- kv = mockKV();
64
- vi.clearAllMocks();
65
- registerMeshFunction(sdk as never, kv as never);
66
- });
67
-
68
- describe("mesh-register", () => {
69
- it("registers a valid peer", async () => {
70
- const result = (await sdk.trigger("mem::mesh-register", {
71
- url: "https://peer1.example.com",
72
- name: "peer-1",
73
- sharedScopes: ["memories"],
74
- })) as { success: boolean; peer: MeshPeer };
75
-
76
- expect(result.success).toBe(true);
77
- expect(result.peer.url).toBe("https://peer1.example.com");
78
- expect(result.peer.name).toBe("peer-1");
79
- expect(result.peer.status).toBe("disconnected");
80
- expect(result.peer.sharedScopes).toEqual(["memories"]);
81
- expect(result.peer.id).toMatch(/^peer_/);
82
-
83
- const peers = await kv.list<MeshPeer>("mem:mesh");
84
- expect(peers.length).toBe(1);
85
- });
86
-
87
- it("uses expanded default sharedScopes when not provided", async () => {
88
- const result = (await sdk.trigger("mem::mesh-register", {
89
- url: "https://peer2.example.com",
90
- name: "peer-2",
91
- })) as { success: boolean; peer: MeshPeer };
92
-
93
- expect(result.success).toBe(true);
94
- expect(result.peer.sharedScopes).toEqual([
95
- "memories",
96
- "actions",
97
- "semantic",
98
- "procedural",
99
- "relations",
100
- "graph:nodes",
101
- "graph:edges",
102
- ]);
103
- });
104
-
105
- it("stores syncFilter when provided", async () => {
106
- const result = (await sdk.trigger("mem::mesh-register", {
107
- url: "https://peer3.example.com",
108
- name: "peer-3",
109
- syncFilter: { project: "/my/project" },
110
- })) as { success: boolean; peer: MeshPeer };
111
-
112
- expect(result.success).toBe(true);
113
- expect(result.peer.syncFilter).toEqual({ project: "/my/project" });
114
- });
115
-
116
- it("returns error when url is missing", async () => {
117
- const result = (await sdk.trigger("mem::mesh-register", {
118
- name: "peer-1",
119
- })) as { success: boolean; error: string };
120
-
121
- expect(result.success).toBe(false);
122
- expect(result.error).toContain("url and name are required");
123
- });
124
-
125
- it("returns error when name is missing", async () => {
126
- const result = (await sdk.trigger("mem::mesh-register", {
127
- url: "https://peer1.example.com",
128
- })) as { success: boolean; error: string };
129
-
130
- expect(result.success).toBe(false);
131
- expect(result.error).toContain("url and name are required");
132
- });
133
-
134
- it("returns error for duplicate url", async () => {
135
- await sdk.trigger("mem::mesh-register", {
136
- url: "https://peer1.example.com",
137
- name: "peer-1",
138
- });
139
-
140
- const result = (await sdk.trigger("mem::mesh-register", {
141
- url: "https://peer1.example.com",
142
- name: "peer-1-duplicate",
143
- })) as { success: boolean; error: string; peerId: string };
144
-
145
- expect(result.success).toBe(false);
146
- expect(result.error).toContain("peer already registered");
147
- expect(result.peerId).toBeDefined();
148
- });
149
- });
150
-
151
- describe("mesh-list", () => {
152
- it("returns empty list when no peers registered", async () => {
153
- const result = (await sdk.trigger("mem::mesh-list", {})) as {
154
- success: boolean;
155
- peers: MeshPeer[];
156
- };
157
-
158
- expect(result.success).toBe(true);
159
- expect(result.peers).toEqual([]);
160
- });
161
-
162
- it("returns all registered peers", async () => {
163
- await sdk.trigger("mem::mesh-register", {
164
- url: "https://peer1.example.com",
165
- name: "peer-1",
166
- });
167
- await sdk.trigger("mem::mesh-register", {
168
- url: "https://peer2.example.com",
169
- name: "peer-2",
170
- });
171
-
172
- const result = (await sdk.trigger("mem::mesh-list", {})) as {
173
- success: boolean;
174
- peers: MeshPeer[];
175
- };
176
-
177
- expect(result.success).toBe(true);
178
- expect(result.peers.length).toBe(2);
179
- expect(result.peers.map((p) => p.name).sort()).toEqual(["peer-1", "peer-2"]);
180
- });
181
- });
182
-
183
- describe("mesh-receive", () => {
184
- it("accepts new memories", async () => {
185
- const mem: Memory = {
186
- id: "mem_1",
187
- createdAt: "2026-03-01T00:00:00Z",
188
- updatedAt: "2026-03-01T00:00:00Z",
189
- type: "pattern",
190
- title: "Test memory",
191
- content: "Test content",
192
- concepts: ["test"],
193
- files: [],
194
- sessionIds: ["ses_1"],
195
- strength: 5,
196
- version: 1,
197
- isLatest: true,
198
- };
199
-
200
- const result = (await sdk.trigger("mem::mesh-receive", {
201
- memories: [mem],
202
- })) as { success: boolean; accepted: number };
203
-
204
- expect(result.success).toBe(true);
205
- expect(result.accepted).toBe(1);
206
-
207
- const stored = await kv.get<Memory>("mem:memories", "mem_1");
208
- expect(stored).toBeDefined();
209
- expect(stored!.title).toBe("Test memory");
210
- });
211
-
212
- it("accepts newer memory over existing (last-write-wins)", async () => {
213
- const older: Memory = {
214
- id: "mem_1",
215
- createdAt: "2026-03-01T00:00:00Z",
216
- updatedAt: "2026-03-01T00:00:00Z",
217
- type: "pattern",
218
- title: "Old title",
219
- content: "Old content",
220
- concepts: [],
221
- files: [],
222
- sessionIds: [],
223
- strength: 5,
224
- version: 1,
225
- isLatest: true,
226
- };
227
- await kv.set("mem:memories", "mem_1", older);
228
-
229
- const newer: Memory = {
230
- ...older,
231
- updatedAt: "2026-03-02T00:00:00Z",
232
- title: "New title",
233
- content: "New content",
234
- version: 2,
235
- };
236
-
237
- const result = (await sdk.trigger("mem::mesh-receive", {
238
- memories: [newer],
239
- })) as { success: boolean; accepted: number };
240
-
241
- expect(result.success).toBe(true);
242
- expect(result.accepted).toBe(1);
243
-
244
- const stored = await kv.get<Memory>("mem:memories", "mem_1");
245
- expect(stored!.title).toBe("New title");
246
- });
247
-
248
- it("rejects older memory than existing", async () => {
249
- const existing: Memory = {
250
- id: "mem_1",
251
- createdAt: "2026-03-01T00:00:00Z",
252
- updatedAt: "2026-03-02T00:00:00Z",
253
- type: "pattern",
254
- title: "Existing title",
255
- content: "Existing content",
256
- concepts: [],
257
- files: [],
258
- sessionIds: [],
259
- strength: 5,
260
- version: 2,
261
- isLatest: true,
262
- };
263
- await kv.set("mem:memories", "mem_1", existing);
264
-
265
- const older: Memory = {
266
- ...existing,
267
- updatedAt: "2026-03-01T00:00:00Z",
268
- title: "Old title",
269
- version: 1,
270
- };
271
-
272
- const result = (await sdk.trigger("mem::mesh-receive", {
273
- memories: [older],
274
- })) as { success: boolean; accepted: number };
275
-
276
- expect(result.success).toBe(true);
277
- expect(result.accepted).toBe(0);
278
-
279
- const stored = await kv.get<Memory>("mem:memories", "mem_1");
280
- expect(stored!.title).toBe("Existing title");
281
- });
282
-
283
- it("skips memory entries with missing id", async () => {
284
- const result = (await sdk.trigger("mem::mesh-receive", {
285
- memories: [
286
- { updatedAt: "2026-03-01T00:00:00Z", title: "No ID" } as unknown as Memory,
287
- ],
288
- })) as { success: boolean; accepted: number };
289
-
290
- expect(result.success).toBe(true);
291
- expect(result.accepted).toBe(0);
292
- });
293
-
294
- it("skips memory entries with invalid date", async () => {
295
- const result = (await sdk.trigger("mem::mesh-receive", {
296
- memories: [
297
- {
298
- id: "mem_bad_date",
299
- updatedAt: "not-a-date",
300
- title: "Bad date",
301
- } as unknown as Memory,
302
- ],
303
- })) as { success: boolean; accepted: number };
304
-
305
- expect(result.success).toBe(true);
306
- expect(result.accepted).toBe(0);
307
- });
308
-
309
- it("accepts new actions", async () => {
310
- const action: Action = {
311
- id: "act_1",
312
- title: "Fix bug",
313
- description: "Fix the login bug",
314
- status: "pending",
315
- priority: 1,
316
- createdAt: "2026-03-01T00:00:00Z",
317
- updatedAt: "2026-03-01T00:00:00Z",
318
- createdBy: "agent-1",
319
- tags: ["bug"],
320
- sourceObservationIds: [],
321
- sourceMemoryIds: [],
322
- };
323
-
324
- const result = (await sdk.trigger("mem::mesh-receive", {
325
- actions: [action],
326
- })) as { success: boolean; accepted: number };
327
-
328
- expect(result.success).toBe(true);
329
- expect(result.accepted).toBe(1);
330
-
331
- const stored = await kv.get<Action>("mem:actions", "act_1");
332
- expect(stored).toBeDefined();
333
- expect(stored!.title).toBe("Fix bug");
334
- });
335
-
336
- it("accepts newer action over existing (last-write-wins)", async () => {
337
- const older: Action = {
338
- id: "act_1",
339
- title: "Old action",
340
- description: "Old desc",
341
- status: "pending",
342
- priority: 1,
343
- createdAt: "2026-03-01T00:00:00Z",
344
- updatedAt: "2026-03-01T00:00:00Z",
345
- createdBy: "agent-1",
346
- tags: [],
347
- sourceObservationIds: [],
348
- sourceMemoryIds: [],
349
- };
350
- await kv.set("mem:actions", "act_1", older);
351
-
352
- const newer: Action = {
353
- ...older,
354
- updatedAt: "2026-03-02T00:00:00Z",
355
- title: "Updated action",
356
- status: "done",
357
- };
358
-
359
- const result = (await sdk.trigger("mem::mesh-receive", {
360
- actions: [newer],
361
- })) as { success: boolean; accepted: number };
362
-
363
- expect(result.success).toBe(true);
364
- expect(result.accepted).toBe(1);
365
-
366
- const stored = await kv.get<Action>("mem:actions", "act_1");
367
- expect(stored!.title).toBe("Updated action");
368
- expect(stored!.status).toBe("done");
369
- });
370
-
371
- it("rejects older action than existing", async () => {
372
- const existing: Action = {
373
- id: "act_1",
374
- title: "Current action",
375
- description: "Current desc",
376
- status: "active",
377
- priority: 1,
378
- createdAt: "2026-03-01T00:00:00Z",
379
- updatedAt: "2026-03-02T00:00:00Z",
380
- createdBy: "agent-1",
381
- tags: [],
382
- sourceObservationIds: [],
383
- sourceMemoryIds: [],
384
- };
385
- await kv.set("mem:actions", "act_1", existing);
386
-
387
- const older: Action = {
388
- ...existing,
389
- updatedAt: "2026-03-01T00:00:00Z",
390
- title: "Stale action",
391
- };
392
-
393
- const result = (await sdk.trigger("mem::mesh-receive", {
394
- actions: [older],
395
- })) as { success: boolean; accepted: number };
396
-
397
- expect(result.success).toBe(true);
398
- expect(result.accepted).toBe(0);
399
-
400
- const stored = await kv.get<Action>("mem:actions", "act_1");
401
- expect(stored!.title).toBe("Current action");
402
- });
403
-
404
- it("skips action entries with missing id", async () => {
405
- const result = (await sdk.trigger("mem::mesh-receive", {
406
- actions: [
407
- { updatedAt: "2026-03-01T00:00:00Z", title: "No ID" } as unknown as Action,
408
- ],
409
- })) as { success: boolean; accepted: number };
410
-
411
- expect(result.success).toBe(true);
412
- expect(result.accepted).toBe(0);
413
- });
414
-
415
- it("skips action entries with invalid date", async () => {
416
- const result = (await sdk.trigger("mem::mesh-receive", {
417
- actions: [
418
- {
419
- id: "act_bad_date",
420
- updatedAt: "invalid-date-string",
421
- title: "Bad date",
422
- } as unknown as Action,
423
- ],
424
- })) as { success: boolean; accepted: number };
425
-
426
- expect(result.success).toBe(true);
427
- expect(result.accepted).toBe(0);
428
- });
429
-
430
- it("accepts both memories and actions in one call", async () => {
431
- const mem: Memory = {
432
- id: "mem_combo",
433
- createdAt: "2026-03-01T00:00:00Z",
434
- updatedAt: "2026-03-01T00:00:00Z",
435
- type: "fact",
436
- title: "Combo memory",
437
- content: "Content",
438
- concepts: [],
439
- files: [],
440
- sessionIds: [],
441
- strength: 3,
442
- version: 1,
443
- isLatest: true,
444
- };
445
- const action: Action = {
446
- id: "act_combo",
447
- title: "Combo action",
448
- description: "Desc",
449
- status: "pending",
450
- priority: 2,
451
- createdAt: "2026-03-01T00:00:00Z",
452
- updatedAt: "2026-03-01T00:00:00Z",
453
- createdBy: "agent-1",
454
- tags: [],
455
- sourceObservationIds: [],
456
- sourceMemoryIds: [],
457
- };
458
-
459
- const result = (await sdk.trigger("mem::mesh-receive", {
460
- memories: [mem],
461
- actions: [action],
462
- })) as { success: boolean; accepted: number };
463
-
464
- expect(result.success).toBe(true);
465
- expect(result.accepted).toBe(2);
466
- });
467
-
468
- it("returns zero accepted for empty arrays", async () => {
469
- const result = (await sdk.trigger("mem::mesh-receive", {
470
- memories: [],
471
- actions: [],
472
- })) as { success: boolean; accepted: number };
473
-
474
- expect(result.success).toBe(true);
475
- expect(result.accepted).toBe(0);
476
- });
477
- });
478
-
479
- describe("mesh-remove", () => {
480
- it("removes a registered peer", async () => {
481
- const regResult = (await sdk.trigger("mem::mesh-register", {
482
- url: "https://peer1.example.com",
483
- name: "peer-1",
484
- })) as { success: boolean; peer: MeshPeer };
485
-
486
- const result = (await sdk.trigger("mem::mesh-remove", {
487
- peerId: regResult.peer.id,
488
- })) as { success: boolean };
489
-
490
- expect(result.success).toBe(true);
491
-
492
- const peers = await kv.list<MeshPeer>("mem:mesh");
493
- expect(peers.length).toBe(0);
494
- });
495
-
496
- it("returns error when peerId is missing", async () => {
497
- const result = (await sdk.trigger("mem::mesh-remove", {})) as {
498
- success: boolean;
499
- error: string;
500
- };
501
-
502
- expect(result.success).toBe(false);
503
- expect(result.error).toContain("peerId is required");
504
- });
505
-
506
- it("succeeds silently for non-existent peerId", async () => {
507
- const result = (await sdk.trigger("mem::mesh-remove", {
508
- peerId: "peer_nonexistent",
509
- })) as { success: boolean };
510
-
511
- expect(result.success).toBe(true);
512
- });
513
- });
514
-
515
- describe("mesh-receive expanded scopes", () => {
516
- it("accepts semantic memories", async () => {
517
- const sem: SemanticMemory = {
518
- id: "sem_1",
519
- fact: "React uses JSX",
520
- confidence: 0.9,
521
- sourceSessionIds: ["ses_1"],
522
- sourceMemoryIds: ["mem_1"],
523
- accessCount: 1,
524
- lastAccessedAt: "2026-03-01T00:00:00Z",
525
- strength: 7,
526
- createdAt: "2026-03-01T00:00:00Z",
527
- updatedAt: "2026-03-01T00:00:00Z",
528
- };
529
-
530
- const result = (await sdk.trigger("mem::mesh-receive", {
531
- semantic: [sem],
532
- })) as { success: boolean; accepted: number };
533
-
534
- expect(result.success).toBe(true);
535
- expect(result.accepted).toBe(1);
536
- const stored = await kv.get<SemanticMemory>("mem:semantic", "sem_1");
537
- expect(stored).toBeDefined();
538
- expect(stored!.fact).toBe("React uses JSX");
539
- });
540
-
541
- it("accepts procedural memories", async () => {
542
- const proc: ProceduralMemory = {
543
- id: "proc_1",
544
- name: "Deploy to prod",
545
- steps: ["build", "test", "deploy"],
546
- triggerCondition: "on merge to main",
547
- frequency: 5,
548
- sourceSessionIds: ["ses_1"],
549
- strength: 8,
550
- createdAt: "2026-03-01T00:00:00Z",
551
- updatedAt: "2026-03-01T00:00:00Z",
552
- };
553
-
554
- const result = (await sdk.trigger("mem::mesh-receive", {
555
- procedural: [proc],
556
- })) as { success: boolean; accepted: number };
557
-
558
- expect(result.success).toBe(true);
559
- expect(result.accepted).toBe(1);
560
- const stored = await kv.get<ProceduralMemory>("mem:procedural", "proc_1");
561
- expect(stored!.name).toBe("Deploy to prod");
562
- });
563
-
564
- it("accepts graph nodes", async () => {
565
- const node: GraphNode = {
566
- id: "gn_1",
567
- type: "concept",
568
- name: "typescript",
569
- properties: {},
570
- sourceObservationIds: ["obs_1"],
571
- createdAt: "2026-03-01T00:00:00Z",
572
- };
573
-
574
- const result = (await sdk.trigger("mem::mesh-receive", {
575
- graphNodes: [node],
576
- })) as { success: boolean; accepted: number };
577
-
578
- expect(result.success).toBe(true);
579
- expect(result.accepted).toBe(1);
580
- const stored = await kv.get<GraphNode>("mem:graph:nodes", "gn_1");
581
- expect(stored!.name).toBe("typescript");
582
- });
583
-
584
- it("accepts graph edges", async () => {
585
- const edge: GraphEdge = {
586
- id: "ge_1",
587
- type: "uses",
588
- sourceNodeId: "gn_1",
589
- targetNodeId: "gn_2",
590
- weight: 1,
591
- sourceObservationIds: ["obs_1"],
592
- createdAt: "2026-03-01T00:00:00Z",
593
- };
594
-
595
- const result = (await sdk.trigger("mem::mesh-receive", {
596
- graphEdges: [edge],
597
- })) as { success: boolean; accepted: number };
598
-
599
- expect(result.success).toBe(true);
600
- expect(result.accepted).toBe(1);
601
- const stored = await kv.get<GraphEdge>("mem:graph:edges", "ge_1");
602
- expect(stored!.type).toBe("uses");
603
- });
604
-
605
- it("accepts relations", async () => {
606
- const rel: MemoryRelation = {
607
- type: "supersedes",
608
- sourceId: "mem_2",
609
- targetId: "mem_1",
610
- createdAt: "2026-03-01T00:00:00Z",
611
- confidence: 0.95,
612
- };
613
- const relWithId = { ...rel, id: "rel_1" } as MemoryRelation & { id: string };
614
-
615
- const result = (await sdk.trigger("mem::mesh-receive", {
616
- relations: [relWithId],
617
- })) as { success: boolean; accepted: number };
618
-
619
- expect(result.success).toBe(true);
620
- expect(result.accepted).toBe(1);
621
- });
622
-
623
- it("accepts all scope types in one call", async () => {
624
- const mem: Memory = {
625
- id: "mem_all",
626
- createdAt: "2026-03-01T00:00:00Z",
627
- updatedAt: "2026-03-01T00:00:00Z",
628
- type: "fact",
629
- title: "All scopes test",
630
- content: "Content",
631
- concepts: [],
632
- files: [],
633
- sessionIds: [],
634
- strength: 5,
635
- version: 1,
636
- isLatest: true,
637
- };
638
- const sem: SemanticMemory = {
639
- id: "sem_all",
640
- fact: "Test",
641
- confidence: 0.5,
642
- sourceSessionIds: [],
643
- sourceMemoryIds: [],
644
- accessCount: 0,
645
- lastAccessedAt: "2026-03-01T00:00:00Z",
646
- strength: 5,
647
- createdAt: "2026-03-01T00:00:00Z",
648
- updatedAt: "2026-03-01T00:00:00Z",
649
- };
650
- const node: GraphNode = {
651
- id: "gn_all",
652
- type: "file",
653
- name: "test.ts",
654
- properties: {},
655
- sourceObservationIds: [],
656
- createdAt: "2026-03-01T00:00:00Z",
657
- };
658
-
659
- const result = (await sdk.trigger("mem::mesh-receive", {
660
- memories: [mem],
661
- semantic: [sem],
662
- graphNodes: [node],
663
- })) as { success: boolean; accepted: number };
664
-
665
- expect(result.success).toBe(true);
666
- expect(result.accepted).toBe(3);
667
- });
668
-
669
- it("applies LWW for semantic memories", async () => {
670
- const older: SemanticMemory = {
671
- id: "sem_lww",
672
- fact: "Old fact",
673
- confidence: 0.5,
674
- sourceSessionIds: [],
675
- sourceMemoryIds: [],
676
- accessCount: 1,
677
- lastAccessedAt: "2026-03-01T00:00:00Z",
678
- strength: 5,
679
- createdAt: "2026-03-01T00:00:00Z",
680
- updatedAt: "2026-03-01T00:00:00Z",
681
- };
682
- await kv.set("mem:semantic", "sem_lww", older);
683
-
684
- const newer: SemanticMemory = {
685
- ...older,
686
- fact: "New fact",
687
- updatedAt: "2026-03-02T00:00:00Z",
688
- };
689
-
690
- const result = (await sdk.trigger("mem::mesh-receive", {
691
- semantic: [newer],
692
- })) as { success: boolean; accepted: number };
693
-
694
- expect(result.success).toBe(true);
695
- expect(result.accepted).toBe(1);
696
- const stored = await kv.get<SemanticMemory>("mem:semantic", "sem_lww");
697
- expect(stored!.fact).toBe("New fact");
698
- });
699
- });
700
- });