@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.
- package/AGENTS.md +2 -2
- package/README.md +41 -68
- package/dist/cli.mjs +3 -3
- package/dist/index.mjs +3 -2
- package/dist/index.mjs.map +1 -1
- package/dist/{src-1fTKFEtN.mjs → src-sYZDDbiA.mjs} +4 -3
- package/dist/src-sYZDDbiA.mjs.map +1 -0
- package/dist/standalone.mjs +1 -1
- package/dist/standalone.mjs.map +1 -1
- package/package.json +10 -1
- package/plugin/.claude-plugin/plugin.json +1 -1
- package/plugin/scripts/notification.d.mts +1 -0
- package/plugin/scripts/notification.mjs.map +1 -0
- package/plugin/scripts/post-tool-failure.d.mts +1 -0
- package/plugin/scripts/post-tool-failure.mjs.map +1 -0
- package/plugin/scripts/post-tool-use.d.mts +1 -0
- package/plugin/scripts/post-tool-use.mjs.map +1 -0
- package/plugin/scripts/pre-compact.d.mts +1 -0
- package/plugin/scripts/pre-compact.mjs.map +1 -0
- package/plugin/scripts/pre-tool-use.d.mts +1 -0
- package/plugin/scripts/pre-tool-use.mjs.map +1 -0
- package/plugin/scripts/prompt-submit.d.mts +1 -0
- package/plugin/scripts/prompt-submit.mjs.map +1 -0
- package/plugin/scripts/session-end.d.mts +1 -0
- package/plugin/scripts/session-end.mjs.map +1 -0
- package/plugin/scripts/session-start.d.mts +1 -0
- package/plugin/scripts/session-start.mjs.map +1 -0
- package/plugin/scripts/stop.d.mts +1 -0
- package/plugin/scripts/stop.mjs.map +1 -0
- package/plugin/scripts/subagent-start.d.mts +1 -0
- package/plugin/scripts/subagent-start.mjs.map +1 -0
- package/plugin/scripts/subagent-stop.d.mts +1 -0
- package/plugin/scripts/subagent-stop.mjs.map +1 -0
- package/plugin/scripts/task-completed.d.mts +1 -0
- package/plugin/scripts/task-completed.mjs.map +1 -0
- package/.claude-plugin/marketplace.json +0 -14
- package/.github/workflows/ci.yml +0 -22
- package/.github/workflows/publish.yml +0 -28
- package/assets/banner.png +0 -0
- package/assets/demo.gif +0 -0
- package/assets/demo.mp4 +0 -0
- package/benchmark/QUALITY.md +0 -73
- package/benchmark/REAL-EMBEDDINGS.md +0 -67
- package/benchmark/SCALE.md +0 -110
- package/benchmark/dataset.ts +0 -293
- package/benchmark/quality-eval.ts +0 -643
- package/benchmark/real-embeddings-eval.ts +0 -405
- package/benchmark/scale-eval.ts +0 -398
- package/dist/src-1fTKFEtN.mjs.map +0 -1
- package/src/auth.ts +0 -12
- package/src/cli.ts +0 -251
- package/src/config.ts +0 -221
- package/src/eval/metrics-store.ts +0 -65
- package/src/eval/quality.ts +0 -51
- package/src/eval/schemas.ts +0 -124
- package/src/eval/self-correct.ts +0 -28
- package/src/eval/validator.ts +0 -31
- package/src/functions/actions.ts +0 -288
- package/src/functions/audit.ts +0 -61
- package/src/functions/auto-forget.ts +0 -169
- package/src/functions/branch-aware.ts +0 -169
- package/src/functions/cascade.ts +0 -80
- package/src/functions/checkpoints.ts +0 -209
- package/src/functions/claude-bridge.ts +0 -161
- package/src/functions/compress.ts +0 -194
- package/src/functions/consolidate.ts +0 -212
- package/src/functions/consolidation-pipeline.ts +0 -258
- package/src/functions/context.ts +0 -169
- package/src/functions/crystallize.ts +0 -293
- package/src/functions/dedup.ts +0 -57
- package/src/functions/diagnostics.ts +0 -785
- package/src/functions/enrich.ts +0 -132
- package/src/functions/evict.ts +0 -163
- package/src/functions/export-import.ts +0 -508
- package/src/functions/facets.ts +0 -248
- package/src/functions/file-index.ts +0 -106
- package/src/functions/flow-compress.ts +0 -214
- package/src/functions/frontier.ts +0 -196
- package/src/functions/governance.ts +0 -131
- package/src/functions/graph-retrieval.ts +0 -277
- package/src/functions/graph.ts +0 -275
- package/src/functions/leases.ts +0 -216
- package/src/functions/lessons.ts +0 -253
- package/src/functions/mesh.ts +0 -434
- package/src/functions/migrate.ts +0 -165
- package/src/functions/observe.ts +0 -144
- package/src/functions/obsidian-export.ts +0 -310
- package/src/functions/patterns.ts +0 -138
- package/src/functions/privacy.ts +0 -39
- package/src/functions/profile.ts +0 -155
- package/src/functions/query-expansion.ts +0 -186
- package/src/functions/relations.ts +0 -237
- package/src/functions/remember.ts +0 -162
- package/src/functions/retention.ts +0 -235
- package/src/functions/routines.ts +0 -289
- package/src/functions/search.ts +0 -80
- package/src/functions/sentinels.ts +0 -417
- package/src/functions/signals.ts +0 -186
- package/src/functions/sketches.ts +0 -274
- package/src/functions/sliding-window.ts +0 -257
- package/src/functions/smart-search.ts +0 -115
- package/src/functions/snapshot.ts +0 -219
- package/src/functions/summarize.ts +0 -155
- package/src/functions/team.ts +0 -147
- package/src/functions/temporal-graph.ts +0 -476
- package/src/functions/timeline.ts +0 -138
- package/src/functions/verify.ts +0 -117
- package/src/health/monitor.ts +0 -110
- package/src/health/thresholds.ts +0 -73
- package/src/hooks/notification.ts +0 -52
- package/src/hooks/post-tool-failure.ts +0 -58
- package/src/hooks/post-tool-use.ts +0 -62
- package/src/hooks/pre-compact.ts +0 -60
- package/src/hooks/pre-tool-use.ts +0 -72
- package/src/hooks/prompt-submit.ts +0 -46
- package/src/hooks/session-end.ts +0 -71
- package/src/hooks/session-start.ts +0 -48
- package/src/hooks/stop.ts +0 -39
- package/src/hooks/subagent-start.ts +0 -49
- package/src/hooks/subagent-stop.ts +0 -54
- package/src/hooks/task-completed.ts +0 -54
- package/src/index.ts +0 -342
- package/src/mcp/in-memory-kv.ts +0 -61
- package/src/mcp/server.ts +0 -1455
- package/src/mcp/standalone.ts +0 -177
- package/src/mcp/tools-registry.ts +0 -769
- package/src/mcp/transport.ts +0 -91
- package/src/prompts/compression.ts +0 -67
- package/src/prompts/consolidation.ts +0 -48
- package/src/prompts/graph-extraction.ts +0 -35
- package/src/prompts/summary.ts +0 -38
- package/src/prompts/xml.ts +0 -26
- package/src/providers/agent-sdk.ts +0 -34
- package/src/providers/anthropic.ts +0 -35
- package/src/providers/circuit-breaker.ts +0 -82
- package/src/providers/embedding/cohere.ts +0 -46
- package/src/providers/embedding/gemini.ts +0 -54
- package/src/providers/embedding/index.ts +0 -39
- package/src/providers/embedding/local.ts +0 -52
- package/src/providers/embedding/openai.ts +0 -45
- package/src/providers/embedding/openrouter.ts +0 -51
- package/src/providers/embedding/voyage.ts +0 -46
- package/src/providers/fallback-chain.ts +0 -31
- package/src/providers/index.ts +0 -84
- package/src/providers/openrouter.ts +0 -71
- package/src/providers/resilient.ts +0 -37
- package/src/state/hybrid-search.ts +0 -295
- package/src/state/index-persistence.ts +0 -63
- package/src/state/keyed-mutex.ts +0 -18
- package/src/state/kv.ts +0 -33
- package/src/state/schema.ts +0 -71
- package/src/state/search-index.ts +0 -245
- package/src/state/stemmer.ts +0 -104
- package/src/state/synonyms.ts +0 -63
- package/src/state/vector-index.ts +0 -130
- package/src/telemetry/setup.ts +0 -116
- package/src/triggers/api.ts +0 -1904
- package/src/triggers/events.ts +0 -71
- package/src/types.ts +0 -769
- package/src/version.ts +0 -1
- package/src/viewer/index.html +0 -2556
- package/src/viewer/server.ts +0 -207
- package/src/xenova.d.ts +0 -3
- package/test/actions.test.ts +0 -490
- package/test/audit.test.ts +0 -108
- package/test/auto-forget.test.ts +0 -188
- package/test/cascade.test.ts +0 -277
- package/test/checkpoints.test.ts +0 -493
- package/test/circuit-breaker.test.ts +0 -107
- package/test/claude-bridge.test.ts +0 -178
- package/test/confidence.test.ts +0 -247
- package/test/consistency.test.ts +0 -61
- package/test/consolidation-pipeline.test.ts +0 -251
- package/test/crystallize.test.ts +0 -521
- package/test/diagnostics.test.ts +0 -638
- package/test/embedding-provider.test.ts +0 -49
- package/test/enrich.test.ts +0 -209
- package/test/eval.test.ts +0 -300
- package/test/export-import.test.ts +0 -251
- package/test/facets.test.ts +0 -448
- package/test/fallback-chain.test.ts +0 -93
- package/test/frontier.test.ts +0 -485
- package/test/governance.test.ts +0 -147
- package/test/graph-retrieval.test.ts +0 -186
- package/test/graph.test.ts +0 -160
- package/test/helpers/mocks.ts +0 -40
- package/test/hybrid-search.test.ts +0 -145
- package/test/index-persistence.test.ts +0 -124
- package/test/integration.test.ts +0 -265
- package/test/leases.test.ts +0 -399
- package/test/mcp-prompts.test.ts +0 -218
- package/test/mcp-resources.test.ts +0 -286
- package/test/mcp-standalone.test.ts +0 -113
- package/test/mesh.test.ts +0 -700
- package/test/privacy.test.ts +0 -87
- package/test/profile.test.ts +0 -161
- package/test/query-expansion.test.ts +0 -154
- package/test/relations.test.ts +0 -198
- package/test/retention.test.ts +0 -245
- package/test/routines.test.ts +0 -497
- package/test/schema-fingerprint.test.ts +0 -81
- package/test/schema.test.ts +0 -42
- package/test/search-index.test.ts +0 -128
- package/test/sentinels.test.ts +0 -626
- package/test/signals.test.ts +0 -410
- package/test/sketches.test.ts +0 -549
- package/test/sliding-window.test.ts +0 -199
- package/test/smart-search.test.ts +0 -169
- package/test/snapshot.test.ts +0 -165
- package/test/team.test.ts +0 -156
- package/test/temporal-graph.test.ts +0 -378
- package/test/timeline.test.ts +0 -148
- package/test/vector-index.test.ts +0 -79
- package/test/verify.test.ts +0 -209
- package/test/xml.test.ts +0 -65
- package/tsconfig.json +0 -22
- package/tsdown.config.ts +0 -62
|
@@ -1,130 +0,0 @@
|
|
|
1
|
-
function float32ToBase64(arr: Float32Array): string {
|
|
2
|
-
return Buffer.from(arr.buffer).toString("base64");
|
|
3
|
-
}
|
|
4
|
-
|
|
5
|
-
function base64ToFloat32(b64: string): Float32Array {
|
|
6
|
-
return new Float32Array(Buffer.from(b64, "base64").buffer);
|
|
7
|
-
}
|
|
8
|
-
|
|
9
|
-
function cosineSimilarity(a: Float32Array, b: Float32Array): number {
|
|
10
|
-
if (a.length !== b.length) return 0;
|
|
11
|
-
let dot = 0;
|
|
12
|
-
let normA = 0;
|
|
13
|
-
let normB = 0;
|
|
14
|
-
for (let i = 0; i < a.length; i++) {
|
|
15
|
-
dot += a[i] * b[i];
|
|
16
|
-
normA += a[i] * a[i];
|
|
17
|
-
normB += b[i] * b[i];
|
|
18
|
-
}
|
|
19
|
-
const denom = Math.sqrt(normA) * Math.sqrt(normB);
|
|
20
|
-
return denom === 0 ? 0 : dot / denom;
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
export class VectorIndex {
|
|
24
|
-
private vectors: Map<string, { embedding: Float32Array; sessionId: string }> =
|
|
25
|
-
new Map();
|
|
26
|
-
|
|
27
|
-
add(obsId: string, sessionId: string, embedding: Float32Array): void {
|
|
28
|
-
this.vectors.set(obsId, { embedding, sessionId });
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
remove(obsId: string): void {
|
|
32
|
-
this.vectors.delete(obsId);
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
search(
|
|
36
|
-
query: Float32Array,
|
|
37
|
-
limit = 20,
|
|
38
|
-
): Array<{ obsId: string; sessionId: string; score: number }> {
|
|
39
|
-
const results: Array<{
|
|
40
|
-
obsId: string;
|
|
41
|
-
sessionId: string;
|
|
42
|
-
score: number;
|
|
43
|
-
}> = [];
|
|
44
|
-
let minScore = -Infinity;
|
|
45
|
-
|
|
46
|
-
for (const [obsId, entry] of this.vectors) {
|
|
47
|
-
const score = cosineSimilarity(query, entry.embedding);
|
|
48
|
-
if (results.length < limit) {
|
|
49
|
-
results.push({ obsId, sessionId: entry.sessionId, score });
|
|
50
|
-
if (results.length === limit) {
|
|
51
|
-
results.sort((a, b) => a.score - b.score);
|
|
52
|
-
minScore = results[0].score;
|
|
53
|
-
}
|
|
54
|
-
} else if (score > minScore) {
|
|
55
|
-
results[0] = { obsId, sessionId: entry.sessionId, score };
|
|
56
|
-
results.sort((a, b) => a.score - b.score);
|
|
57
|
-
minScore = results[0].score;
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
results.sort((a, b) => b.score - a.score);
|
|
62
|
-
return results;
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
get size(): number {
|
|
66
|
-
return this.vectors.size;
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
clear(): void {
|
|
70
|
-
this.vectors.clear();
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
restoreFrom(other: VectorIndex): void {
|
|
74
|
-
const src = (other as any).vectors as Map<
|
|
75
|
-
string,
|
|
76
|
-
{ embedding: Float32Array; sessionId: string }
|
|
77
|
-
>;
|
|
78
|
-
this.vectors = new Map();
|
|
79
|
-
for (const [obsId, entry] of src) {
|
|
80
|
-
this.vectors.set(obsId, {
|
|
81
|
-
embedding: new Float32Array(entry.embedding),
|
|
82
|
-
sessionId: entry.sessionId,
|
|
83
|
-
});
|
|
84
|
-
}
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
serialize(): string {
|
|
88
|
-
const data: Array<[string, { embedding: string; sessionId: string }]> = [];
|
|
89
|
-
for (const [obsId, entry] of this.vectors) {
|
|
90
|
-
data.push([
|
|
91
|
-
obsId,
|
|
92
|
-
{
|
|
93
|
-
embedding: float32ToBase64(entry.embedding),
|
|
94
|
-
sessionId: entry.sessionId,
|
|
95
|
-
},
|
|
96
|
-
]);
|
|
97
|
-
}
|
|
98
|
-
return JSON.stringify(data);
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
static deserialize(json: string): VectorIndex {
|
|
102
|
-
const idx = new VectorIndex();
|
|
103
|
-
let data: unknown;
|
|
104
|
-
try {
|
|
105
|
-
data = JSON.parse(json);
|
|
106
|
-
} catch {
|
|
107
|
-
return idx;
|
|
108
|
-
}
|
|
109
|
-
if (!Array.isArray(data)) return idx;
|
|
110
|
-
for (const row of data) {
|
|
111
|
-
try {
|
|
112
|
-
if (!Array.isArray(row) || row.length < 2) continue;
|
|
113
|
-
const [obsId, entry] = row;
|
|
114
|
-
if (
|
|
115
|
-
typeof obsId !== "string" ||
|
|
116
|
-
typeof entry?.embedding !== "string" ||
|
|
117
|
-
typeof entry?.sessionId !== "string"
|
|
118
|
-
)
|
|
119
|
-
continue;
|
|
120
|
-
idx.vectors.set(obsId, {
|
|
121
|
-
embedding: base64ToFloat32(entry.embedding),
|
|
122
|
-
sessionId: entry.sessionId,
|
|
123
|
-
});
|
|
124
|
-
} catch {
|
|
125
|
-
continue;
|
|
126
|
-
}
|
|
127
|
-
}
|
|
128
|
-
return idx;
|
|
129
|
-
}
|
|
130
|
-
}
|
package/src/telemetry/setup.ts
DELETED
|
@@ -1,116 +0,0 @@
|
|
|
1
|
-
import { VERSION } from "../version.js";
|
|
2
|
-
|
|
3
|
-
interface OtelConfig {
|
|
4
|
-
serviceName: string;
|
|
5
|
-
serviceVersion: string;
|
|
6
|
-
metricsExportIntervalMs: number;
|
|
7
|
-
}
|
|
8
|
-
|
|
9
|
-
export const OTEL_CONFIG: OtelConfig = {
|
|
10
|
-
serviceName: "agentmemory",
|
|
11
|
-
serviceVersion: VERSION,
|
|
12
|
-
metricsExportIntervalMs: 30_000,
|
|
13
|
-
};
|
|
14
|
-
|
|
15
|
-
interface Counter {
|
|
16
|
-
add: (n: number) => void;
|
|
17
|
-
}
|
|
18
|
-
interface Histogram {
|
|
19
|
-
record: (v: number) => void;
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
interface Counters {
|
|
23
|
-
observationsTotal: Counter;
|
|
24
|
-
compressionSuccess: Counter;
|
|
25
|
-
compressionFailure: Counter;
|
|
26
|
-
searchTotal: Counter;
|
|
27
|
-
dedupSkipped: Counter;
|
|
28
|
-
evictionTotal: Counter;
|
|
29
|
-
circuitBreakerOpen: Counter;
|
|
30
|
-
embeddingSuccess: Counter;
|
|
31
|
-
embeddingFailure: Counter;
|
|
32
|
-
vectorSearchTotal: Counter;
|
|
33
|
-
autoForgetTotal: Counter;
|
|
34
|
-
profileGenerated: Counter;
|
|
35
|
-
claudeBridgeSync: Counter;
|
|
36
|
-
graphExtraction: Counter;
|
|
37
|
-
consolidationRun: Counter;
|
|
38
|
-
teamShare: Counter;
|
|
39
|
-
auditLog: Counter;
|
|
40
|
-
snapshotCreate: Counter;
|
|
41
|
-
governanceDelete: Counter;
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
interface Histograms {
|
|
45
|
-
compressionLatency: Histogram;
|
|
46
|
-
searchLatency: Histogram;
|
|
47
|
-
contextTokens: Histogram;
|
|
48
|
-
qualityScore: Histogram;
|
|
49
|
-
embeddingLatency: Histogram;
|
|
50
|
-
vectorSearchLatency: Histogram;
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
type Meter = {
|
|
54
|
-
createCounter: (name: string) => Counter;
|
|
55
|
-
createHistogram: (name: string) => Histogram;
|
|
56
|
-
};
|
|
57
|
-
|
|
58
|
-
let counters: Counters | null = null;
|
|
59
|
-
let histograms: Histograms | null = null;
|
|
60
|
-
|
|
61
|
-
const NOOP_COUNTER: Counter = { add: () => {} };
|
|
62
|
-
const NOOP_HISTOGRAM: Histogram = { record: () => {} };
|
|
63
|
-
|
|
64
|
-
const COUNTER_NAMES: Array<[keyof Counters, string]> = [
|
|
65
|
-
["observationsTotal", "observations.total"],
|
|
66
|
-
["compressionSuccess", "compression.success"],
|
|
67
|
-
["compressionFailure", "compression.failure"],
|
|
68
|
-
["searchTotal", "search.total"],
|
|
69
|
-
["dedupSkipped", "dedup.skipped"],
|
|
70
|
-
["evictionTotal", "eviction.total"],
|
|
71
|
-
["circuitBreakerOpen", "circuit_breaker.open"],
|
|
72
|
-
["embeddingSuccess", "embedding.success"],
|
|
73
|
-
["embeddingFailure", "embedding.failure"],
|
|
74
|
-
["vectorSearchTotal", "vector_search.total"],
|
|
75
|
-
["autoForgetTotal", "auto_forget.total"],
|
|
76
|
-
["profileGenerated", "profile.generated"],
|
|
77
|
-
["claudeBridgeSync", "claude_bridge.sync"],
|
|
78
|
-
["graphExtraction", "graph.extraction"],
|
|
79
|
-
["consolidationRun", "consolidation.run"],
|
|
80
|
-
["teamShare", "team.share"],
|
|
81
|
-
["auditLog", "audit.log"],
|
|
82
|
-
["snapshotCreate", "snapshot.create"],
|
|
83
|
-
["governanceDelete", "governance.delete"],
|
|
84
|
-
];
|
|
85
|
-
|
|
86
|
-
const HISTOGRAM_NAMES: Array<[keyof Histograms, string]> = [
|
|
87
|
-
["compressionLatency", "compression.latency_ms"],
|
|
88
|
-
["searchLatency", "search.latency_ms"],
|
|
89
|
-
["contextTokens", "context.tokens"],
|
|
90
|
-
["qualityScore", "quality.score"],
|
|
91
|
-
["embeddingLatency", "embedding.latency_ms"],
|
|
92
|
-
["vectorSearchLatency", "vector_search.latency_ms"],
|
|
93
|
-
];
|
|
94
|
-
|
|
95
|
-
export function initMetrics(getMeter?: (name: string) => Meter): {
|
|
96
|
-
counters: Counters;
|
|
97
|
-
histograms: Histograms;
|
|
98
|
-
} {
|
|
99
|
-
const meter = getMeter?.("agentmemory");
|
|
100
|
-
|
|
101
|
-
counters = Object.fromEntries(
|
|
102
|
-
COUNTER_NAMES.map(([key, name]) => [
|
|
103
|
-
key,
|
|
104
|
-
meter ? meter.createCounter(name) : NOOP_COUNTER,
|
|
105
|
-
]),
|
|
106
|
-
) as unknown as Counters;
|
|
107
|
-
|
|
108
|
-
histograms = Object.fromEntries(
|
|
109
|
-
HISTOGRAM_NAMES.map(([key, name]) => [
|
|
110
|
-
key,
|
|
111
|
-
meter ? meter.createHistogram(name) : NOOP_HISTOGRAM,
|
|
112
|
-
]),
|
|
113
|
-
) as unknown as Histograms;
|
|
114
|
-
|
|
115
|
-
return { counters, histograms };
|
|
116
|
-
}
|