@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
@@ -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
- });