@agentmemory/agentmemory 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +14 -0
- package/.github/workflows/ci.yml +22 -0
- package/.github/workflows/publish.yml +28 -0
- package/AGENTS.md +113 -0
- package/LICENSE +190 -0
- package/README.md +828 -0
- package/assets/banner.png +0 -0
- package/assets/demo.gif +0 -0
- package/assets/demo.mp4 +0 -0
- package/benchmark/QUALITY.md +73 -0
- package/benchmark/REAL-EMBEDDINGS.md +67 -0
- package/benchmark/SCALE.md +110 -0
- package/benchmark/dataset.ts +293 -0
- package/benchmark/quality-eval.ts +643 -0
- package/benchmark/real-embeddings-eval.ts +405 -0
- package/benchmark/scale-eval.ts +398 -0
- package/dist/cli.d.mts +1 -0
- package/dist/cli.mjs +137 -0
- package/dist/cli.mjs.map +1 -0
- package/dist/docker-compose.yml +14 -0
- package/dist/hooks/notification.d.mts +1 -0
- package/dist/hooks/notification.mjs +45 -0
- package/dist/hooks/notification.mjs.map +1 -0
- package/dist/hooks/post-tool-failure.d.mts +1 -0
- package/dist/hooks/post-tool-failure.mjs +45 -0
- package/dist/hooks/post-tool-failure.mjs.map +1 -0
- package/dist/hooks/post-tool-use.d.mts +1 -0
- package/dist/hooks/post-tool-use.mjs +53 -0
- package/dist/hooks/post-tool-use.mjs.map +1 -0
- package/dist/hooks/pre-compact.d.mts +1 -0
- package/dist/hooks/pre-compact.mjs +50 -0
- package/dist/hooks/pre-compact.mjs.map +1 -0
- package/dist/hooks/pre-tool-use.d.mts +1 -0
- package/dist/hooks/pre-tool-use.mjs +69 -0
- package/dist/hooks/pre-tool-use.mjs.map +1 -0
- package/dist/hooks/prompt-submit.d.mts +1 -0
- package/dist/hooks/prompt-submit.mjs +40 -0
- package/dist/hooks/prompt-submit.mjs.map +1 -0
- package/dist/hooks/session-end.d.mts +1 -0
- package/dist/hooks/session-end.mjs +61 -0
- package/dist/hooks/session-end.mjs.map +1 -0
- package/dist/hooks/session-start.d.mts +1 -0
- package/dist/hooks/session-start.mjs +42 -0
- package/dist/hooks/session-start.mjs.map +1 -0
- package/dist/hooks/stop.d.mts +1 -0
- package/dist/hooks/stop.mjs +33 -0
- package/dist/hooks/stop.mjs.map +1 -0
- package/dist/hooks/subagent-start.d.mts +1 -0
- package/dist/hooks/subagent-start.mjs +43 -0
- package/dist/hooks/subagent-start.mjs.map +1 -0
- package/dist/hooks/subagent-stop.d.mts +1 -0
- package/dist/hooks/subagent-stop.mjs +45 -0
- package/dist/hooks/subagent-stop.mjs.map +1 -0
- package/dist/hooks/task-completed.d.mts +1 -0
- package/dist/hooks/task-completed.mjs +46 -0
- package/dist/hooks/task-completed.mjs.map +1 -0
- package/dist/iii-config.yaml +51 -0
- package/dist/index.d.mts +2 -0
- package/dist/index.mjs +13776 -0
- package/dist/index.mjs.map +1 -0
- package/dist/src-QxitMPfJ.mjs +13775 -0
- package/dist/src-QxitMPfJ.mjs.map +1 -0
- package/dist/standalone.d.mts +1 -0
- package/dist/standalone.mjs +1155 -0
- package/dist/standalone.mjs.map +1 -0
- package/dist/transformers-BX_tgxdO.mjs +38684 -0
- package/dist/transformers-BX_tgxdO.mjs.map +1 -0
- package/dist/transformers-KMm1i9no.mjs +38683 -0
- package/dist/transformers-KMm1i9no.mjs.map +1 -0
- package/docker-compose.yml +14 -0
- package/iii-config.yaml +51 -0
- package/package.json +59 -0
- package/plugin/.claude-plugin/plugin.json +10 -0
- package/plugin/hooks/hooks.json +77 -0
- package/plugin/scripts/diagnostics.mjs +551 -0
- package/plugin/scripts/notification.mjs +45 -0
- package/plugin/scripts/post-tool-failure.mjs +45 -0
- package/plugin/scripts/post-tool-use.mjs +53 -0
- package/plugin/scripts/pre-compact.mjs +50 -0
- package/plugin/scripts/pre-tool-use.mjs +69 -0
- package/plugin/scripts/prompt-submit.mjs +40 -0
- package/plugin/scripts/session-end.mjs +61 -0
- package/plugin/scripts/session-start.mjs +42 -0
- package/plugin/scripts/stop.mjs +33 -0
- package/plugin/scripts/subagent-start.mjs +43 -0
- package/plugin/scripts/subagent-stop.mjs +45 -0
- package/plugin/scripts/task-completed.mjs +46 -0
- package/plugin/skills/forget/SKILL.md +32 -0
- package/plugin/skills/recall/SKILL.md +18 -0
- package/plugin/skills/remember/SKILL.md +25 -0
- package/plugin/skills/session-history/SKILL.md +17 -0
- package/src/auth.ts +12 -0
- package/src/cli.ts +159 -0
- package/src/config.ts +221 -0
- package/src/eval/metrics-store.ts +65 -0
- package/src/eval/quality.ts +51 -0
- package/src/eval/schemas.ts +124 -0
- package/src/eval/self-correct.ts +28 -0
- package/src/eval/validator.ts +31 -0
- package/src/functions/actions.ts +288 -0
- package/src/functions/audit.ts +61 -0
- package/src/functions/auto-forget.ts +169 -0
- package/src/functions/branch-aware.ts +169 -0
- package/src/functions/cascade.ts +80 -0
- package/src/functions/checkpoints.ts +209 -0
- package/src/functions/claude-bridge.ts +161 -0
- package/src/functions/compress.ts +194 -0
- package/src/functions/consolidate.ts +212 -0
- package/src/functions/consolidation-pipeline.ts +258 -0
- package/src/functions/context.ts +169 -0
- package/src/functions/crystallize.ts +293 -0
- package/src/functions/dedup.ts +57 -0
- package/src/functions/diagnostics.ts +785 -0
- package/src/functions/enrich.ts +132 -0
- package/src/functions/evict.ts +163 -0
- package/src/functions/export-import.ts +508 -0
- package/src/functions/facets.ts +248 -0
- package/src/functions/file-index.ts +106 -0
- package/src/functions/flow-compress.ts +214 -0
- package/src/functions/frontier.ts +196 -0
- package/src/functions/governance.ts +131 -0
- package/src/functions/graph-retrieval.ts +277 -0
- package/src/functions/graph.ts +275 -0
- package/src/functions/leases.ts +216 -0
- package/src/functions/lessons.ts +253 -0
- package/src/functions/mesh.ts +434 -0
- package/src/functions/migrate.ts +165 -0
- package/src/functions/observe.ts +144 -0
- package/src/functions/obsidian-export.ts +310 -0
- package/src/functions/patterns.ts +138 -0
- package/src/functions/privacy.ts +39 -0
- package/src/functions/profile.ts +155 -0
- package/src/functions/query-expansion.ts +186 -0
- package/src/functions/relations.ts +237 -0
- package/src/functions/remember.ts +162 -0
- package/src/functions/retention.ts +235 -0
- package/src/functions/routines.ts +289 -0
- package/src/functions/search.ts +80 -0
- package/src/functions/sentinels.ts +417 -0
- package/src/functions/signals.ts +186 -0
- package/src/functions/sketches.ts +274 -0
- package/src/functions/sliding-window.ts +257 -0
- package/src/functions/smart-search.ts +115 -0
- package/src/functions/snapshot.ts +219 -0
- package/src/functions/summarize.ts +155 -0
- package/src/functions/team.ts +147 -0
- package/src/functions/temporal-graph.ts +476 -0
- package/src/functions/timeline.ts +138 -0
- package/src/functions/verify.ts +117 -0
- package/src/health/monitor.ts +110 -0
- package/src/health/thresholds.ts +73 -0
- package/src/hooks/notification.ts +52 -0
- package/src/hooks/post-tool-failure.ts +58 -0
- package/src/hooks/post-tool-use.ts +62 -0
- package/src/hooks/pre-compact.ts +60 -0
- package/src/hooks/pre-tool-use.ts +72 -0
- package/src/hooks/prompt-submit.ts +46 -0
- package/src/hooks/session-end.ts +71 -0
- package/src/hooks/session-start.ts +48 -0
- package/src/hooks/stop.ts +39 -0
- package/src/hooks/subagent-start.ts +49 -0
- package/src/hooks/subagent-stop.ts +54 -0
- package/src/hooks/task-completed.ts +54 -0
- package/src/index.ts +342 -0
- package/src/mcp/in-memory-kv.ts +61 -0
- package/src/mcp/server.ts +1455 -0
- package/src/mcp/standalone.ts +177 -0
- package/src/mcp/tools-registry.ts +769 -0
- package/src/mcp/transport.ts +91 -0
- package/src/prompts/compression.ts +67 -0
- package/src/prompts/consolidation.ts +48 -0
- package/src/prompts/graph-extraction.ts +35 -0
- package/src/prompts/summary.ts +38 -0
- package/src/prompts/xml.ts +26 -0
- package/src/providers/agent-sdk.ts +34 -0
- package/src/providers/anthropic.ts +35 -0
- package/src/providers/circuit-breaker.ts +82 -0
- package/src/providers/embedding/cohere.ts +46 -0
- package/src/providers/embedding/gemini.ts +54 -0
- package/src/providers/embedding/index.ts +39 -0
- package/src/providers/embedding/local.ts +52 -0
- package/src/providers/embedding/openai.ts +45 -0
- package/src/providers/embedding/openrouter.ts +51 -0
- package/src/providers/embedding/voyage.ts +46 -0
- package/src/providers/fallback-chain.ts +31 -0
- package/src/providers/index.ts +84 -0
- package/src/providers/openrouter.ts +71 -0
- package/src/providers/resilient.ts +37 -0
- package/src/state/hybrid-search.ts +295 -0
- package/src/state/index-persistence.ts +63 -0
- package/src/state/keyed-mutex.ts +18 -0
- package/src/state/kv.ts +33 -0
- package/src/state/schema.ts +71 -0
- package/src/state/search-index.ts +245 -0
- package/src/state/stemmer.ts +104 -0
- package/src/state/synonyms.ts +63 -0
- package/src/state/vector-index.ts +130 -0
- package/src/telemetry/setup.ts +116 -0
- package/src/triggers/api.ts +1904 -0
- package/src/triggers/events.ts +71 -0
- package/src/types.ts +769 -0
- package/src/version.ts +1 -0
- package/src/viewer/index.html +2497 -0
- package/src/viewer/server.ts +207 -0
- package/src/xenova.d.ts +3 -0
- package/test/actions.test.ts +490 -0
- package/test/audit.test.ts +108 -0
- package/test/auto-forget.test.ts +188 -0
- package/test/cascade.test.ts +277 -0
- package/test/checkpoints.test.ts +493 -0
- package/test/circuit-breaker.test.ts +107 -0
- package/test/claude-bridge.test.ts +178 -0
- package/test/confidence.test.ts +247 -0
- package/test/consistency.test.ts +61 -0
- package/test/consolidation-pipeline.test.ts +251 -0
- package/test/crystallize.test.ts +521 -0
- package/test/diagnostics.test.ts +638 -0
- package/test/embedding-provider.test.ts +49 -0
- package/test/enrich.test.ts +209 -0
- package/test/eval.test.ts +300 -0
- package/test/export-import.test.ts +251 -0
- package/test/facets.test.ts +448 -0
- package/test/fallback-chain.test.ts +93 -0
- package/test/frontier.test.ts +485 -0
- package/test/governance.test.ts +147 -0
- package/test/graph-retrieval.test.ts +186 -0
- package/test/graph.test.ts +160 -0
- package/test/helpers/mocks.ts +40 -0
- package/test/hybrid-search.test.ts +145 -0
- package/test/index-persistence.test.ts +124 -0
- package/test/integration.test.ts +265 -0
- package/test/leases.test.ts +399 -0
- package/test/mcp-prompts.test.ts +218 -0
- package/test/mcp-resources.test.ts +286 -0
- package/test/mcp-standalone.test.ts +113 -0
- package/test/mesh.test.ts +700 -0
- package/test/privacy.test.ts +87 -0
- package/test/profile.test.ts +161 -0
- package/test/query-expansion.test.ts +154 -0
- package/test/relations.test.ts +198 -0
- package/test/retention.test.ts +245 -0
- package/test/routines.test.ts +497 -0
- package/test/schema-fingerprint.test.ts +81 -0
- package/test/schema.test.ts +42 -0
- package/test/search-index.test.ts +128 -0
- package/test/sentinels.test.ts +626 -0
- package/test/signals.test.ts +410 -0
- package/test/sketches.test.ts +549 -0
- package/test/sliding-window.test.ts +199 -0
- package/test/smart-search.test.ts +169 -0
- package/test/snapshot.test.ts +165 -0
- package/test/team.test.ts +156 -0
- package/test/temporal-graph.test.ts +378 -0
- package/test/timeline.test.ts +148 -0
- package/test/vector-index.test.ts +79 -0
- package/test/verify.test.ts +209 -0
- package/test/xml.test.ts +65 -0
- package/tsconfig.json +22 -0
- package/tsdown.config.ts +62 -0
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { describe, it, expect, beforeEach } from "vitest";
|
|
2
|
+
import { SearchIndex } from "../src/state/search-index.js";
|
|
3
|
+
import type { CompressedObservation } from "../src/types.js";
|
|
4
|
+
|
|
5
|
+
function makeObs(
|
|
6
|
+
overrides: Partial<CompressedObservation> = {},
|
|
7
|
+
): CompressedObservation {
|
|
8
|
+
return {
|
|
9
|
+
id: "obs_1",
|
|
10
|
+
sessionId: "ses_1",
|
|
11
|
+
timestamp: new Date().toISOString(),
|
|
12
|
+
type: "file_edit",
|
|
13
|
+
title: "Edit auth middleware",
|
|
14
|
+
subtitle: "JWT validation",
|
|
15
|
+
facts: ["Added token check"],
|
|
16
|
+
narrative: "Modified the auth middleware to validate JWT tokens",
|
|
17
|
+
concepts: ["authentication", "jwt"],
|
|
18
|
+
files: ["src/middleware/auth.ts"],
|
|
19
|
+
importance: 7,
|
|
20
|
+
...overrides,
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
describe("SearchIndex", () => {
|
|
25
|
+
let index: SearchIndex;
|
|
26
|
+
|
|
27
|
+
beforeEach(() => {
|
|
28
|
+
index = new SearchIndex();
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
it("starts empty", () => {
|
|
32
|
+
expect(index.size).toBe(0);
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
it("adds and finds observations", () => {
|
|
36
|
+
index.add(makeObs());
|
|
37
|
+
expect(index.size).toBe(1);
|
|
38
|
+
const results = index.search("auth");
|
|
39
|
+
expect(results.length).toBe(1);
|
|
40
|
+
expect(results[0].obsId).toBe("obs_1");
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
it("returns empty for no matches", () => {
|
|
44
|
+
index.add(makeObs());
|
|
45
|
+
expect(index.search("database")).toEqual([]);
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
it("scores exact matches higher than prefix matches", () => {
|
|
49
|
+
index.add(
|
|
50
|
+
makeObs({
|
|
51
|
+
id: "obs_exact",
|
|
52
|
+
title: "redis cache",
|
|
53
|
+
narrative: "Set up redis caching layer",
|
|
54
|
+
concepts: ["redis"],
|
|
55
|
+
facts: ["Added redis"],
|
|
56
|
+
files: ["src/redis.ts"],
|
|
57
|
+
}),
|
|
58
|
+
);
|
|
59
|
+
index.add(
|
|
60
|
+
makeObs({
|
|
61
|
+
id: "obs_prefix",
|
|
62
|
+
title: "redistool handler",
|
|
63
|
+
narrative: "Set up redistool for ops",
|
|
64
|
+
concepts: ["redistool"],
|
|
65
|
+
facts: ["Added redistool"],
|
|
66
|
+
files: ["src/redistool.ts"],
|
|
67
|
+
}),
|
|
68
|
+
);
|
|
69
|
+
const results = index.search("redis");
|
|
70
|
+
const exact = results.find((r) => r.obsId === "obs_exact");
|
|
71
|
+
const prefix = results.find((r) => r.obsId === "obs_prefix");
|
|
72
|
+
expect(exact).toBeDefined();
|
|
73
|
+
expect(prefix).toBeDefined();
|
|
74
|
+
expect(exact!.score).toBeGreaterThanOrEqual(prefix!.score);
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
it("respects limit", () => {
|
|
78
|
+
for (let i = 0; i < 30; i++) {
|
|
79
|
+
index.add(makeObs({ id: `obs_${i}`, title: `auth feature ${i}` }));
|
|
80
|
+
}
|
|
81
|
+
expect(index.search("auth", 5).length).toBe(5);
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
it("clears the index", () => {
|
|
85
|
+
index.add(makeObs());
|
|
86
|
+
index.clear();
|
|
87
|
+
expect(index.size).toBe(0);
|
|
88
|
+
expect(index.search("auth")).toEqual([]);
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
it("returns empty for empty query", () => {
|
|
92
|
+
index.add(makeObs());
|
|
93
|
+
expect(index.search("")).toEqual([]);
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
it("searches across multiple fields", () => {
|
|
97
|
+
index.add(
|
|
98
|
+
makeObs({ id: "obs_file", title: "something", files: ["auth.ts"] }),
|
|
99
|
+
);
|
|
100
|
+
expect(index.search("auth").length).toBe(1);
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
it("handles multiple query terms", () => {
|
|
104
|
+
index.add(
|
|
105
|
+
makeObs({
|
|
106
|
+
id: "obs_both",
|
|
107
|
+
title: "redis cache",
|
|
108
|
+
narrative: "Set up redis and cache layer",
|
|
109
|
+
concepts: ["redis", "cache"],
|
|
110
|
+
facts: ["Added caching"],
|
|
111
|
+
files: ["src/cache.ts"],
|
|
112
|
+
}),
|
|
113
|
+
);
|
|
114
|
+
index.add(
|
|
115
|
+
makeObs({
|
|
116
|
+
id: "obs_one",
|
|
117
|
+
title: "redis only",
|
|
118
|
+
narrative: "Set up redis connection",
|
|
119
|
+
concepts: ["redis"],
|
|
120
|
+
facts: ["Added redis"],
|
|
121
|
+
files: ["src/redis.ts"],
|
|
122
|
+
}),
|
|
123
|
+
);
|
|
124
|
+
const results = index.search("redis cache");
|
|
125
|
+
expect(results[0].obsId).toBe("obs_both");
|
|
126
|
+
expect(results[0].score).toBeGreaterThan(results[1].score);
|
|
127
|
+
});
|
|
128
|
+
});
|