@agentmemory/agentmemory 0.7.0 → 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 (218) hide show
  1. package/AGENTS.md +2 -2
  2. package/README.md +76 -82
  3. package/dist/cli.mjs +99 -32
  4. package/dist/cli.mjs.map +1 -1
  5. package/dist/index.mjs +4 -2
  6. package/dist/index.mjs.map +1 -1
  7. package/dist/{src-QxitMPfJ.mjs → src-sYZDDbiA.mjs} +5 -3
  8. package/dist/src-sYZDDbiA.mjs.map +1 -0
  9. package/dist/standalone.mjs +1 -1
  10. package/dist/standalone.mjs.map +1 -1
  11. package/package.json +11 -1
  12. package/plugin/.claude-plugin/plugin.json +1 -1
  13. package/plugin/scripts/notification.d.mts +1 -0
  14. package/plugin/scripts/notification.mjs.map +1 -0
  15. package/plugin/scripts/post-tool-failure.d.mts +1 -0
  16. package/plugin/scripts/post-tool-failure.mjs.map +1 -0
  17. package/plugin/scripts/post-tool-use.d.mts +1 -0
  18. package/plugin/scripts/post-tool-use.mjs.map +1 -0
  19. package/plugin/scripts/pre-compact.d.mts +1 -0
  20. package/plugin/scripts/pre-compact.mjs.map +1 -0
  21. package/plugin/scripts/pre-tool-use.d.mts +1 -0
  22. package/plugin/scripts/pre-tool-use.mjs.map +1 -0
  23. package/plugin/scripts/prompt-submit.d.mts +1 -0
  24. package/plugin/scripts/prompt-submit.mjs.map +1 -0
  25. package/plugin/scripts/session-end.d.mts +1 -0
  26. package/plugin/scripts/session-end.mjs.map +1 -0
  27. package/plugin/scripts/session-start.d.mts +1 -0
  28. package/plugin/scripts/session-start.mjs.map +1 -0
  29. package/plugin/scripts/stop.d.mts +1 -0
  30. package/plugin/scripts/stop.mjs.map +1 -0
  31. package/plugin/scripts/subagent-start.d.mts +1 -0
  32. package/plugin/scripts/subagent-start.mjs.map +1 -0
  33. package/plugin/scripts/subagent-stop.d.mts +1 -0
  34. package/plugin/scripts/subagent-stop.mjs.map +1 -0
  35. package/plugin/scripts/task-completed.d.mts +1 -0
  36. package/plugin/scripts/task-completed.mjs.map +1 -0
  37. package/.claude-plugin/marketplace.json +0 -14
  38. package/.github/workflows/ci.yml +0 -22
  39. package/.github/workflows/publish.yml +0 -28
  40. package/assets/banner.png +0 -0
  41. package/assets/demo.gif +0 -0
  42. package/assets/demo.mp4 +0 -0
  43. package/benchmark/QUALITY.md +0 -73
  44. package/benchmark/REAL-EMBEDDINGS.md +0 -67
  45. package/benchmark/SCALE.md +0 -110
  46. package/benchmark/dataset.ts +0 -293
  47. package/benchmark/quality-eval.ts +0 -643
  48. package/benchmark/real-embeddings-eval.ts +0 -405
  49. package/benchmark/scale-eval.ts +0 -398
  50. package/dist/src-QxitMPfJ.mjs.map +0 -1
  51. package/src/auth.ts +0 -12
  52. package/src/cli.ts +0 -159
  53. package/src/config.ts +0 -221
  54. package/src/eval/metrics-store.ts +0 -65
  55. package/src/eval/quality.ts +0 -51
  56. package/src/eval/schemas.ts +0 -124
  57. package/src/eval/self-correct.ts +0 -28
  58. package/src/eval/validator.ts +0 -31
  59. package/src/functions/actions.ts +0 -288
  60. package/src/functions/audit.ts +0 -61
  61. package/src/functions/auto-forget.ts +0 -169
  62. package/src/functions/branch-aware.ts +0 -169
  63. package/src/functions/cascade.ts +0 -80
  64. package/src/functions/checkpoints.ts +0 -209
  65. package/src/functions/claude-bridge.ts +0 -161
  66. package/src/functions/compress.ts +0 -194
  67. package/src/functions/consolidate.ts +0 -212
  68. package/src/functions/consolidation-pipeline.ts +0 -258
  69. package/src/functions/context.ts +0 -169
  70. package/src/functions/crystallize.ts +0 -293
  71. package/src/functions/dedup.ts +0 -57
  72. package/src/functions/diagnostics.ts +0 -785
  73. package/src/functions/enrich.ts +0 -132
  74. package/src/functions/evict.ts +0 -163
  75. package/src/functions/export-import.ts +0 -508
  76. package/src/functions/facets.ts +0 -248
  77. package/src/functions/file-index.ts +0 -106
  78. package/src/functions/flow-compress.ts +0 -214
  79. package/src/functions/frontier.ts +0 -196
  80. package/src/functions/governance.ts +0 -131
  81. package/src/functions/graph-retrieval.ts +0 -277
  82. package/src/functions/graph.ts +0 -275
  83. package/src/functions/leases.ts +0 -216
  84. package/src/functions/lessons.ts +0 -253
  85. package/src/functions/mesh.ts +0 -434
  86. package/src/functions/migrate.ts +0 -165
  87. package/src/functions/observe.ts +0 -144
  88. package/src/functions/obsidian-export.ts +0 -310
  89. package/src/functions/patterns.ts +0 -138
  90. package/src/functions/privacy.ts +0 -39
  91. package/src/functions/profile.ts +0 -155
  92. package/src/functions/query-expansion.ts +0 -186
  93. package/src/functions/relations.ts +0 -237
  94. package/src/functions/remember.ts +0 -162
  95. package/src/functions/retention.ts +0 -235
  96. package/src/functions/routines.ts +0 -289
  97. package/src/functions/search.ts +0 -80
  98. package/src/functions/sentinels.ts +0 -417
  99. package/src/functions/signals.ts +0 -186
  100. package/src/functions/sketches.ts +0 -274
  101. package/src/functions/sliding-window.ts +0 -257
  102. package/src/functions/smart-search.ts +0 -115
  103. package/src/functions/snapshot.ts +0 -219
  104. package/src/functions/summarize.ts +0 -155
  105. package/src/functions/team.ts +0 -147
  106. package/src/functions/temporal-graph.ts +0 -476
  107. package/src/functions/timeline.ts +0 -138
  108. package/src/functions/verify.ts +0 -117
  109. package/src/health/monitor.ts +0 -110
  110. package/src/health/thresholds.ts +0 -73
  111. package/src/hooks/notification.ts +0 -52
  112. package/src/hooks/post-tool-failure.ts +0 -58
  113. package/src/hooks/post-tool-use.ts +0 -62
  114. package/src/hooks/pre-compact.ts +0 -60
  115. package/src/hooks/pre-tool-use.ts +0 -72
  116. package/src/hooks/prompt-submit.ts +0 -46
  117. package/src/hooks/session-end.ts +0 -71
  118. package/src/hooks/session-start.ts +0 -48
  119. package/src/hooks/stop.ts +0 -39
  120. package/src/hooks/subagent-start.ts +0 -49
  121. package/src/hooks/subagent-stop.ts +0 -54
  122. package/src/hooks/task-completed.ts +0 -54
  123. package/src/index.ts +0 -342
  124. package/src/mcp/in-memory-kv.ts +0 -61
  125. package/src/mcp/server.ts +0 -1455
  126. package/src/mcp/standalone.ts +0 -177
  127. package/src/mcp/tools-registry.ts +0 -769
  128. package/src/mcp/transport.ts +0 -91
  129. package/src/prompts/compression.ts +0 -67
  130. package/src/prompts/consolidation.ts +0 -48
  131. package/src/prompts/graph-extraction.ts +0 -35
  132. package/src/prompts/summary.ts +0 -38
  133. package/src/prompts/xml.ts +0 -26
  134. package/src/providers/agent-sdk.ts +0 -34
  135. package/src/providers/anthropic.ts +0 -35
  136. package/src/providers/circuit-breaker.ts +0 -82
  137. package/src/providers/embedding/cohere.ts +0 -46
  138. package/src/providers/embedding/gemini.ts +0 -54
  139. package/src/providers/embedding/index.ts +0 -39
  140. package/src/providers/embedding/local.ts +0 -52
  141. package/src/providers/embedding/openai.ts +0 -45
  142. package/src/providers/embedding/openrouter.ts +0 -51
  143. package/src/providers/embedding/voyage.ts +0 -46
  144. package/src/providers/fallback-chain.ts +0 -31
  145. package/src/providers/index.ts +0 -84
  146. package/src/providers/openrouter.ts +0 -71
  147. package/src/providers/resilient.ts +0 -37
  148. package/src/state/hybrid-search.ts +0 -295
  149. package/src/state/index-persistence.ts +0 -63
  150. package/src/state/keyed-mutex.ts +0 -18
  151. package/src/state/kv.ts +0 -33
  152. package/src/state/schema.ts +0 -71
  153. package/src/state/search-index.ts +0 -245
  154. package/src/state/stemmer.ts +0 -104
  155. package/src/state/synonyms.ts +0 -63
  156. package/src/state/vector-index.ts +0 -130
  157. package/src/telemetry/setup.ts +0 -116
  158. package/src/triggers/api.ts +0 -1904
  159. package/src/triggers/events.ts +0 -71
  160. package/src/types.ts +0 -769
  161. package/src/version.ts +0 -1
  162. package/src/viewer/index.html +0 -2497
  163. package/src/viewer/server.ts +0 -207
  164. package/src/xenova.d.ts +0 -3
  165. package/test/actions.test.ts +0 -490
  166. package/test/audit.test.ts +0 -108
  167. package/test/auto-forget.test.ts +0 -188
  168. package/test/cascade.test.ts +0 -277
  169. package/test/checkpoints.test.ts +0 -493
  170. package/test/circuit-breaker.test.ts +0 -107
  171. package/test/claude-bridge.test.ts +0 -178
  172. package/test/confidence.test.ts +0 -247
  173. package/test/consistency.test.ts +0 -61
  174. package/test/consolidation-pipeline.test.ts +0 -251
  175. package/test/crystallize.test.ts +0 -521
  176. package/test/diagnostics.test.ts +0 -638
  177. package/test/embedding-provider.test.ts +0 -49
  178. package/test/enrich.test.ts +0 -209
  179. package/test/eval.test.ts +0 -300
  180. package/test/export-import.test.ts +0 -251
  181. package/test/facets.test.ts +0 -448
  182. package/test/fallback-chain.test.ts +0 -93
  183. package/test/frontier.test.ts +0 -485
  184. package/test/governance.test.ts +0 -147
  185. package/test/graph-retrieval.test.ts +0 -186
  186. package/test/graph.test.ts +0 -160
  187. package/test/helpers/mocks.ts +0 -40
  188. package/test/hybrid-search.test.ts +0 -145
  189. package/test/index-persistence.test.ts +0 -124
  190. package/test/integration.test.ts +0 -265
  191. package/test/leases.test.ts +0 -399
  192. package/test/mcp-prompts.test.ts +0 -218
  193. package/test/mcp-resources.test.ts +0 -286
  194. package/test/mcp-standalone.test.ts +0 -113
  195. package/test/mesh.test.ts +0 -700
  196. package/test/privacy.test.ts +0 -87
  197. package/test/profile.test.ts +0 -161
  198. package/test/query-expansion.test.ts +0 -154
  199. package/test/relations.test.ts +0 -198
  200. package/test/retention.test.ts +0 -245
  201. package/test/routines.test.ts +0 -497
  202. package/test/schema-fingerprint.test.ts +0 -81
  203. package/test/schema.test.ts +0 -42
  204. package/test/search-index.test.ts +0 -128
  205. package/test/sentinels.test.ts +0 -626
  206. package/test/signals.test.ts +0 -410
  207. package/test/sketches.test.ts +0 -549
  208. package/test/sliding-window.test.ts +0 -199
  209. package/test/smart-search.test.ts +0 -169
  210. package/test/snapshot.test.ts +0 -165
  211. package/test/team.test.ts +0 -156
  212. package/test/temporal-graph.test.ts +0 -378
  213. package/test/timeline.test.ts +0 -148
  214. package/test/vector-index.test.ts +0 -79
  215. package/test/verify.test.ts +0 -209
  216. package/test/xml.test.ts +0 -65
  217. package/tsconfig.json +0 -22
  218. package/tsdown.config.ts +0 -62
@@ -1,87 +0,0 @@
1
- import { describe, it, expect } from "vitest";
2
- import { stripPrivateData } from "../src/functions/privacy.js";
3
-
4
- describe("stripPrivateData", () => {
5
- it("strips private tags", () => {
6
- expect(stripPrivateData("hello <private>secret</private> world")).toBe(
7
- "hello [REDACTED] world",
8
- );
9
- });
10
-
11
- it("strips private tags case-insensitive", () => {
12
- expect(stripPrivateData("<Private>data</Private>")).toBe("[REDACTED]");
13
- });
14
-
15
- it("strips API keys", () => {
16
- expect(stripPrivateData("api_key=sk-ant-1234567890abcdefghij")).toBe(
17
- "[REDACTED_SECRET]",
18
- );
19
- });
20
-
21
- it("strips GitHub PATs", () => {
22
- expect(
23
- stripPrivateData("token: ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefgh"),
24
- ).toBe("[REDACTED_SECRET]");
25
- });
26
-
27
- it("strips standalone GitHub PATs", () => {
28
- expect(
29
- stripPrivateData("found ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghij here"),
30
- ).toBe("found [REDACTED_SECRET] here");
31
- });
32
-
33
- it("strips Slack tokens", () => {
34
- expect(stripPrivateData("xoxb-123456-789012-abcdef")).toBe(
35
- "[REDACTED_SECRET]",
36
- );
37
- });
38
-
39
- it("strips AWS access keys", () => {
40
- expect(stripPrivateData("key=AKIAIOSFODNN7EXAMPLE")).toBe(
41
- "key=[REDACTED_SECRET]",
42
- );
43
- });
44
-
45
- it("strips JWT tokens", () => {
46
- expect(
47
- stripPrivateData(
48
- "eyJhbGciOiJIUzI1.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIn0.SflKxwRJSMeKKF2QT4fwpM",
49
- ),
50
- ).toBe("[REDACTED_SECRET]");
51
- });
52
-
53
- it("strips sk- prefixed keys", () => {
54
- expect(stripPrivateData("sk-1234567890abcdefghijklmnopqr")).toBe(
55
- "[REDACTED_SECRET]",
56
- );
57
- });
58
-
59
- it("handles multiple secrets in one string", () => {
60
- const input =
61
- "sk-abcdefghijklmnopqrstuv and ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghij";
62
- const result = stripPrivateData(input);
63
- expect(result).not.toContain("sk-");
64
- expect(result).not.toContain("ghp_");
65
- });
66
-
67
- it("does not strip short strings", () => {
68
- expect(stripPrivateData("api_key=short")).toBe("api_key=short");
69
- });
70
-
71
- it("returns empty string unchanged", () => {
72
- expect(stripPrivateData("")).toBe("");
73
- });
74
-
75
- it("handles no secrets gracefully", () => {
76
- expect(stripPrivateData("normal text without secrets")).toBe(
77
- "normal text without secrets",
78
- );
79
- });
80
-
81
- it("works correctly on consecutive calls (no regex statefulness)", () => {
82
- const input = "sk-ABCDEFGHIJKLMNOPQRSTUVWXYZabc";
83
- expect(stripPrivateData(input)).toBe("[REDACTED_SECRET]");
84
- expect(stripPrivateData(input)).toBe("[REDACTED_SECRET]");
85
- expect(stripPrivateData(input)).toBe("[REDACTED_SECRET]");
86
- });
87
- });
@@ -1,161 +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 { registerProfileFunction } from "../src/functions/profile.js";
10
- import type {
11
- CompressedObservation,
12
- Session,
13
- ProjectProfile,
14
- } from "../src/types.js";
15
-
16
- function mockKV() {
17
- const store = new Map<string, Map<string, unknown>>();
18
- return {
19
- get: async <T>(scope: string, key: string): Promise<T | null> => {
20
- return (store.get(scope)?.get(key) as T) ?? null;
21
- },
22
- set: async <T>(scope: string, key: string, data: T): Promise<T> => {
23
- if (!store.has(scope)) store.set(scope, new Map());
24
- store.get(scope)!.set(key, data);
25
- return data;
26
- },
27
- delete: async (scope: string, key: string): Promise<void> => {
28
- store.get(scope)?.delete(key);
29
- },
30
- list: async <T>(scope: string): Promise<T[]> => {
31
- const entries = store.get(scope);
32
- return entries ? (Array.from(entries.values()) as T[]) : [];
33
- },
34
- };
35
- }
36
-
37
- function mockSdk() {
38
- const functions = new Map<string, Function>();
39
- return {
40
- registerFunction: (opts: { id: string }, handler: Function) => {
41
- functions.set(opts.id, handler);
42
- },
43
- registerTrigger: () => {},
44
- trigger: async (id: string, data: unknown) => {
45
- const fn = functions.get(id);
46
- if (!fn) throw new Error(`No function: ${id}`);
47
- return fn(data);
48
- },
49
- };
50
- }
51
-
52
- describe("Profile Function", () => {
53
- let sdk: ReturnType<typeof mockSdk>;
54
- let kv: ReturnType<typeof mockKV>;
55
-
56
- beforeEach(async () => {
57
- sdk = mockSdk();
58
- kv = mockKV();
59
- registerProfileFunction(sdk as never, kv as never);
60
-
61
- const session: Session = {
62
- id: "ses_1",
63
- project: "my-project",
64
- cwd: "/tmp/my-project",
65
- startedAt: "2026-02-01T00:00:00Z",
66
- status: "completed",
67
- observationCount: 3,
68
- };
69
- await kv.set("mem:sessions", "ses_1", session);
70
-
71
- const obs1: CompressedObservation = {
72
- id: "obs_1",
73
- sessionId: "ses_1",
74
- timestamp: "2026-02-01T10:00:00Z",
75
- type: "file_edit",
76
- title: "Edit auth module",
77
- facts: [],
78
- narrative: "Auth changes",
79
- concepts: ["typescript", "authentication"],
80
- files: ["/project/src/auth.ts", "/project/src/middleware.ts"],
81
- importance: 8,
82
- };
83
- const obs2: CompressedObservation = {
84
- id: "obs_2",
85
- sessionId: "ses_1",
86
- timestamp: "2026-02-01T11:00:00Z",
87
- type: "file_edit",
88
- title: "Update database",
89
- facts: [],
90
- narrative: "DB changes",
91
- concepts: ["typescript", "database"],
92
- files: ["/project/src/db.ts"],
93
- importance: 6,
94
- };
95
- const obs3: CompressedObservation = {
96
- id: "obs_3",
97
- sessionId: "ses_1",
98
- timestamp: "2026-02-01T12:00:00Z",
99
- type: "error",
100
- title: "Connection timeout",
101
- facts: [],
102
- narrative: "Error occurred",
103
- concepts: ["error"],
104
- files: ["/project/src/db.ts"],
105
- importance: 4,
106
- };
107
-
108
- await kv.set("mem:obs:ses_1", "obs_1", obs1);
109
- await kv.set("mem:obs:ses_1", "obs_2", obs2);
110
- await kv.set("mem:obs:ses_1", "obs_3", obs3);
111
- });
112
-
113
- it("generates profile with topConcepts sorted by frequency", async () => {
114
- const result = (await sdk.trigger("mem::profile", {
115
- project: "my-project",
116
- })) as { profile: ProjectProfile; cached: boolean };
117
-
118
- expect(result.cached).toBe(false);
119
- expect(result.profile.topConcepts[0].concept).toBe("typescript");
120
- expect(result.profile.topConcepts[0].frequency).toBe(2);
121
- });
122
-
123
- it("generates profile with topFiles sorted by frequency", async () => {
124
- const result = (await sdk.trigger("mem::profile", {
125
- project: "my-project",
126
- })) as { profile: ProjectProfile };
127
-
128
- expect(result.profile.topFiles[0].file).toBe("/project/src/db.ts");
129
- expect(result.profile.topFiles[0].frequency).toBe(2);
130
- });
131
-
132
- it("extracts conventions from file patterns", async () => {
133
- const result = (await sdk.trigger("mem::profile", {
134
- project: "my-project",
135
- })) as { profile: ProjectProfile };
136
-
137
- expect(result.profile.conventions).toContain("TypeScript project");
138
- expect(result.profile.conventions).toContain(
139
- "Standard src/ directory structure",
140
- );
141
- });
142
-
143
- it("returns cached profile if fresh", async () => {
144
- await sdk.trigger("mem::profile", { project: "my-project" });
145
-
146
- const result = (await sdk.trigger("mem::profile", {
147
- project: "my-project",
148
- })) as { profile: ProjectProfile; cached: boolean };
149
-
150
- expect(result.cached).toBe(true);
151
- });
152
-
153
- it("returns null profile for unknown project", async () => {
154
- const result = (await sdk.trigger("mem::profile", {
155
- project: "nonexistent",
156
- })) as { profile: null; reason: string };
157
-
158
- expect(result.profile).toBeNull();
159
- expect(result.reason).toBe("no_sessions");
160
- });
161
- });
@@ -1,154 +0,0 @@
1
- import { describe, it, expect, vi } from "vitest";
2
- import type { MemoryProvider } from "../src/types.js";
3
-
4
- vi.mock("iii-sdk", () => ({
5
- getContext: () => ({
6
- logger: {
7
- info: () => {},
8
- warn: () => {},
9
- error: () => {},
10
- },
11
- }),
12
- }));
13
-
14
- function mockSdk() {
15
- const functions = new Map<string, Function>();
16
- return {
17
- registerFunction: (opts: { id: string }, fn: Function) => {
18
- functions.set(opts.id, fn);
19
- },
20
- trigger: async (id: string, data: unknown) => {
21
- const fn = functions.get(id);
22
- if (fn) return fn(data);
23
- return null;
24
- },
25
- };
26
- }
27
-
28
- describe("QueryExpansion", () => {
29
- it("imports without errors", async () => {
30
- const mod = await import("../src/functions/query-expansion.js");
31
- expect(mod.registerQueryExpansionFunction).toBeDefined();
32
- expect(mod.extractEntitiesFromQuery).toBeDefined();
33
- });
34
-
35
- it("extracts entities from capitalized words", async () => {
36
- const { extractEntitiesFromQuery } = await import(
37
- "../src/functions/query-expansion.js"
38
- );
39
- const entities = extractEntitiesFromQuery(
40
- 'What happened with React and the Vue migration?',
41
- );
42
- expect(entities).toContain("React");
43
- expect(entities).toContain("Vue");
44
- expect(entities).not.toContain("What");
45
- });
46
-
47
- it("extracts quoted entities", async () => {
48
- const { extractEntitiesFromQuery } = await import(
49
- "../src/functions/query-expansion.js"
50
- );
51
- const entities = extractEntitiesFromQuery(
52
- 'Find memories about "auth middleware" changes',
53
- );
54
- expect(entities).toContain("auth middleware");
55
- });
56
-
57
- it("expands queries via LLM", async () => {
58
- const { registerQueryExpansionFunction } = await import(
59
- "../src/functions/query-expansion.js"
60
- );
61
-
62
- const response = `<expansion>
63
- <reformulations>
64
- <query>Authentication middleware modifications</query>
65
- <query>JWT token validation changes</query>
66
- <query>Security layer updates</query>
67
- </reformulations>
68
- <temporal>
69
- <query>Auth changes in the past 7 days</query>
70
- </temporal>
71
- <entities>
72
- <entity>auth middleware</entity>
73
- <entity>JWT</entity>
74
- </entities>
75
- </expansion>`;
76
-
77
- const provider: MemoryProvider = {
78
- name: "test",
79
- compress: vi.fn().mockResolvedValue(response),
80
- summarize: vi.fn().mockResolvedValue(response),
81
- };
82
-
83
- const sdk = mockSdk();
84
- registerQueryExpansionFunction(sdk as never, provider);
85
-
86
- const result = (await sdk.trigger("mem::expand-query", {
87
- query: "What changed in auth?",
88
- })) as { success: boolean; expansion: any };
89
-
90
- expect(result.success).toBe(true);
91
- expect(result.expansion.original).toBe("What changed in auth?");
92
- expect(result.expansion.reformulations.length).toBe(3);
93
- expect(result.expansion.entityExtractions).toContain("auth middleware");
94
- expect(result.expansion.temporalConcretizations.length).toBe(1);
95
- });
96
-
97
- it("returns empty expansion on LLM failure", async () => {
98
- const { registerQueryExpansionFunction } = await import(
99
- "../src/functions/query-expansion.js"
100
- );
101
-
102
- const provider: MemoryProvider = {
103
- name: "test",
104
- compress: vi.fn().mockRejectedValue(new Error("LLM down")),
105
- summarize: vi.fn().mockRejectedValue(new Error("LLM down")),
106
- };
107
-
108
- const sdk = mockSdk();
109
- registerQueryExpansionFunction(sdk as never, provider);
110
-
111
- const result = (await sdk.trigger("mem::expand-query", {
112
- query: "test query",
113
- })) as { success: boolean; expansion: any };
114
-
115
- expect(result.success).toBe(true);
116
- expect(result.expansion.original).toBe("test query");
117
- expect(result.expansion.reformulations).toEqual([]);
118
- });
119
-
120
- it("respects maxReformulations limit", async () => {
121
- const { registerQueryExpansionFunction } = await import(
122
- "../src/functions/query-expansion.js"
123
- );
124
-
125
- const response = `<expansion>
126
- <reformulations>
127
- <query>Query A</query>
128
- <query>Query B</query>
129
- <query>Query C</query>
130
- <query>Query D</query>
131
- <query>Query E</query>
132
- <query>Query F</query>
133
- </reformulations>
134
- <temporal></temporal>
135
- <entities></entities>
136
- </expansion>`;
137
-
138
- const provider: MemoryProvider = {
139
- name: "test",
140
- compress: vi.fn().mockResolvedValue(response),
141
- summarize: vi.fn().mockResolvedValue(response),
142
- };
143
-
144
- const sdk = mockSdk();
145
- registerQueryExpansionFunction(sdk as never, provider);
146
-
147
- const result = (await sdk.trigger("mem::expand-query", {
148
- query: "test",
149
- maxReformulations: 3,
150
- })) as { success: boolean; expansion: any };
151
-
152
- expect(result.expansion.reformulations.length).toBe(3);
153
- });
154
- });
@@ -1,198 +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 { registerRelationsFunction } from "../src/functions/relations.js";
10
- import type { Memory } from "../src/types.js";
11
-
12
- function mockKV() {
13
- const store = new Map<string, Map<string, unknown>>();
14
- return {
15
- get: async <T>(scope: string, key: string): Promise<T | null> => {
16
- return (store.get(scope)?.get(key) as T) ?? null;
17
- },
18
- set: async <T>(scope: string, key: string, data: T): Promise<T> => {
19
- if (!store.has(scope)) store.set(scope, new Map());
20
- store.get(scope)!.set(key, data);
21
- return data;
22
- },
23
- delete: async (scope: string, key: string): Promise<void> => {
24
- store.get(scope)?.delete(key);
25
- },
26
- list: async <T>(scope: string): Promise<T[]> => {
27
- const entries = store.get(scope);
28
- return entries ? (Array.from(entries.values()) as T[]) : [];
29
- },
30
- };
31
- }
32
-
33
- function mockSdk() {
34
- const functions = new Map<string, Function>();
35
- return {
36
- registerFunction: (opts: { id: string }, handler: Function) => {
37
- functions.set(opts.id, handler);
38
- },
39
- registerTrigger: () => {},
40
- trigger: async (id: string, data: unknown) => {
41
- const fn = functions.get(id);
42
- if (!fn) throw new Error(`No function: ${id}`);
43
- return fn(data);
44
- },
45
- getFunction: (id: string) => functions.get(id),
46
- };
47
- }
48
-
49
- function makeMemory(overrides: Partial<Memory> = {}): Memory {
50
- return {
51
- id: "mem_1",
52
- createdAt: new Date().toISOString(),
53
- updatedAt: new Date().toISOString(),
54
- type: "pattern",
55
- title: "Test memory",
56
- content: "This is a test memory",
57
- concepts: ["test"],
58
- files: [],
59
- sessionIds: ["ses_1"],
60
- strength: 5,
61
- version: 1,
62
- isLatest: true,
63
- ...overrides,
64
- };
65
- }
66
-
67
- describe("Relations Functions", () => {
68
- let sdk: ReturnType<typeof mockSdk>;
69
- let kv: ReturnType<typeof mockKV>;
70
-
71
- beforeEach(() => {
72
- sdk = mockSdk();
73
- kv = mockKV();
74
- registerRelationsFunction(sdk as never, kv as never);
75
- });
76
-
77
- describe("mem::relate", () => {
78
- it("creates a relation between two memories", async () => {
79
- const mem1 = makeMemory({ id: "mem_1" });
80
- const mem2 = makeMemory({ id: "mem_2" });
81
- await kv.set("mem:memories", "mem_1", mem1);
82
- await kv.set("mem:memories", "mem_2", mem2);
83
-
84
- const result = await sdk.trigger("mem::relate", {
85
- sourceId: "mem_1",
86
- targetId: "mem_2",
87
- type: "related",
88
- });
89
-
90
- expect((result as { success: boolean }).success).toBe(true);
91
-
92
- const updated1 = await kv.get<Memory>("mem:memories", "mem_1");
93
- const updated2 = await kv.get<Memory>("mem:memories", "mem_2");
94
- expect(updated1!.relatedIds).toContain("mem_2");
95
- expect(updated2!.relatedIds).toContain("mem_1");
96
- });
97
-
98
- it("returns error when source memory not found", async () => {
99
- const mem2 = makeMemory({ id: "mem_2" });
100
- await kv.set("mem:memories", "mem_2", mem2);
101
-
102
- const result = await sdk.trigger("mem::relate", {
103
- sourceId: "mem_missing",
104
- targetId: "mem_2",
105
- type: "related",
106
- });
107
-
108
- expect((result as { success: boolean }).success).toBe(false);
109
- });
110
-
111
- it("does not duplicate relatedIds on repeated calls", async () => {
112
- const mem1 = makeMemory({ id: "mem_1", relatedIds: ["mem_2"] });
113
- const mem2 = makeMemory({ id: "mem_2", relatedIds: ["mem_1"] });
114
- await kv.set("mem:memories", "mem_1", mem1);
115
- await kv.set("mem:memories", "mem_2", mem2);
116
-
117
- await sdk.trigger("mem::relate", {
118
- sourceId: "mem_1",
119
- targetId: "mem_2",
120
- type: "related",
121
- });
122
-
123
- const updated1 = await kv.get<Memory>("mem:memories", "mem_1");
124
- expect(updated1!.relatedIds!.filter((id) => id === "mem_2").length).toBe(1);
125
- });
126
- });
127
-
128
- describe("mem::evolve", () => {
129
- it("marks old memory as not latest and creates new version", async () => {
130
- const original = makeMemory({ id: "mem_old", version: 1 });
131
- await kv.set("mem:memories", "mem_old", original);
132
-
133
- const result = (await sdk.trigger("mem::evolve", {
134
- memoryId: "mem_old",
135
- newContent: "Updated content",
136
- newTitle: "Updated title",
137
- })) as { success: boolean; memory: Memory; previousId: string };
138
-
139
- expect(result.success).toBe(true);
140
- expect(result.memory.version).toBe(2);
141
- expect(result.memory.content).toBe("Updated content");
142
- expect(result.memory.title).toBe("Updated title");
143
- expect(result.memory.parentId).toBe("mem_old");
144
- expect(result.memory.isLatest).toBe(true);
145
-
146
- const old = await kv.get<Memory>("mem:memories", "mem_old");
147
- expect(old!.isLatest).toBe(false);
148
- });
149
-
150
- it("returns error when memory not found", async () => {
151
- const result = await sdk.trigger("mem::evolve", {
152
- memoryId: "mem_missing",
153
- newContent: "Updated content",
154
- });
155
-
156
- expect((result as { success: boolean }).success).toBe(false);
157
- });
158
- });
159
-
160
- describe("mem::get-related", () => {
161
- it("retrieves related memories within 1 hop", async () => {
162
- const mem1 = makeMemory({ id: "mem_1", relatedIds: ["mem_2"] });
163
- const mem2 = makeMemory({ id: "mem_2", relatedIds: ["mem_1", "mem_3"] });
164
- const mem3 = makeMemory({ id: "mem_3", relatedIds: ["mem_2"] });
165
- await kv.set("mem:memories", "mem_1", mem1);
166
- await kv.set("mem:memories", "mem_2", mem2);
167
- await kv.set("mem:memories", "mem_3", mem3);
168
-
169
- const result = (await sdk.trigger("mem::get-related", {
170
- memoryId: "mem_1",
171
- maxHops: 1,
172
- })) as { results: Array<{ memory: Memory; hop: number }> };
173
-
174
- expect(result.results.length).toBe(1);
175
- expect(result.results[0].memory.id).toBe("mem_2");
176
- expect(result.results[0].hop).toBe(1);
177
- });
178
-
179
- it("retrieves related memories within 2 hops", async () => {
180
- const mem1 = makeMemory({ id: "mem_1", relatedIds: ["mem_2"] });
181
- const mem2 = makeMemory({ id: "mem_2", relatedIds: ["mem_1", "mem_3"] });
182
- const mem3 = makeMemory({ id: "mem_3", relatedIds: ["mem_2"] });
183
- await kv.set("mem:memories", "mem_1", mem1);
184
- await kv.set("mem:memories", "mem_2", mem2);
185
- await kv.set("mem:memories", "mem_3", mem3);
186
-
187
- const result = (await sdk.trigger("mem::get-related", {
188
- memoryId: "mem_1",
189
- maxHops: 2,
190
- })) as { results: Array<{ memory: Memory; hop: number }> };
191
-
192
- expect(result.results.length).toBe(2);
193
- const ids = result.results.map((r) => r.memory.id);
194
- expect(ids).toContain("mem_2");
195
- expect(ids).toContain("mem_3");
196
- });
197
- });
198
- });