@agentmemory/agentmemory 0.7.0

package/plugin/scripts/pre-compact.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+//#region src/hooks/pre-compact.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const sessionId = data.session_id || "unknown";
+	const project = data.cwd || process.cwd();
+	if (process.env["CLAUDE_MEMORY_BRIDGE"] === "true") try {
+		await fetch(`${REST_URL}/agentmemory/claude-bridge/sync`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({}),
+			signal: AbortSignal.timeout(5e3)
+		});
+	} catch {}
+	try {
+		const res = await fetch(`${REST_URL}/agentmemory/context`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({
+				sessionId,
+				project,
+				budget: 1500
+			}),
+			signal: AbortSignal.timeout(5e3)
+		});
+		if (res.ok) {
+			const result = await res.json();
+			if (result.context) process.stdout.write(result.context);
+		}
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=pre-compact.mjs.map

package/plugin/scripts/pre-tool-use.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+//#region src/hooks/pre-tool-use.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const toolName = data.tool_name;
+	if (!toolName) return;
+	if (![
+		"Edit",
+		"Write",
+		"Read",
+		"Glob",
+		"Grep"
+	].includes(toolName)) return;
+	const toolInput = data.tool_input || {};
+	const files = [];
+	const fileKeys = toolName === "Grep" ? ["path", "file"] : [
+		"file_path",
+		"path",
+		"file",
+		"pattern"
+	];
+	for (const key of fileKeys) {
+		const val = toolInput[key];
+		if (typeof val === "string" && val.length > 0) files.push(val);
+	}
+	if (files.length === 0) return;
+	const terms = [];
+	if (toolName === "Grep" || toolName === "Glob") {
+		const pattern = toolInput["pattern"];
+		if (typeof pattern === "string" && pattern.length > 0) terms.push(pattern);
+	}
+	const sessionId = data.session_id || "unknown";
+	try {
+		const res = await fetch(`${REST_URL}/agentmemory/enrich`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({
+				sessionId,
+				files,
+				terms,
+				toolName
+			}),
+			signal: AbortSignal.timeout(2e3)
+		});
+		if (res.ok) {
+			const result = await res.json();
+			if (result.context) process.stdout.write(result.context);
+		}
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=pre-tool-use.mjs.map

package/plugin/scripts/prompt-submit.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+//#region src/hooks/prompt-submit.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const sessionId = data.session_id || "unknown";
+	try {
+		await fetch(`${REST_URL}/agentmemory/observe`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({
+				hookType: "prompt_submit",
+				sessionId,
+				project: data.cwd || process.cwd(),
+				cwd: data.cwd || process.cwd(),
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				data: { prompt: data.prompt }
+			}),
+			signal: AbortSignal.timeout(3e3)
+		});
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=prompt-submit.mjs.map

package/plugin/scripts/session-end.mjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+//#region src/hooks/session-end.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const sessionId = data.session_id || "unknown";
+	try {
+		await fetch(`${REST_URL}/agentmemory/session/end`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({ sessionId }),
+			signal: AbortSignal.timeout(5e3)
+		});
+	} catch {}
+	if (process.env["CONSOLIDATION_ENABLED"] === "true") {
+		try {
+			await fetch(`${REST_URL}/agentmemory/crystals/auto`, {
+				method: "POST",
+				headers: authHeaders(),
+				body: JSON.stringify({ olderThanDays: 0 }),
+				signal: AbortSignal.timeout(15e3)
+			});
+		} catch {}
+		try {
+			await fetch(`${REST_URL}/agentmemory/consolidate-pipeline`, {
+				method: "POST",
+				headers: authHeaders(),
+				body: JSON.stringify({
+					tier: "all",
+					force: true
+				}),
+				signal: AbortSignal.timeout(3e4)
+			});
+		} catch {}
+	}
+	if (process.env["CLAUDE_MEMORY_BRIDGE"] === "true") try {
+		await fetch(`${REST_URL}/agentmemory/claude-bridge/sync`, {
+			method: "POST",
+			headers: authHeaders(),
+			signal: AbortSignal.timeout(5e3)
+		});
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=session-end.mjs.map

package/plugin/scripts/session-start.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+//#region src/hooks/session-start.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const sessionId = data.session_id || `ses_${Date.now().toString(36)}`;
+	const project = data.cwd || process.cwd();
+	try {
+		const res = await fetch(`${REST_URL}/agentmemory/session/start`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({
+				sessionId,
+				project,
+				cwd: project
+			}),
+			signal: AbortSignal.timeout(5e3)
+		});
+		if (res.ok) {
+			const result = await res.json();
+			if (result.context) process.stdout.write(result.context);
+		}
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=session-start.mjs.map

package/plugin/scripts/stop.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+//#region src/hooks/stop.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const sessionId = data.session_id || "unknown";
+	try {
+		await fetch(`${REST_URL}/agentmemory/summarize`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({ sessionId }),
+			signal: AbortSignal.timeout(3e4)
+		});
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=stop.mjs.map

package/plugin/scripts/subagent-start.mjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+//#region src/hooks/subagent-start.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const sessionId = data.session_id || "unknown";
+	try {
+		await fetch(`${REST_URL}/agentmemory/observe`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({
+				hookType: "subagent_start",
+				sessionId,
+				project: data.cwd || process.cwd(),
+				cwd: data.cwd || process.cwd(),
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				data: {
+					agent_id: data.agent_id,
+					agent_type: data.agent_type
+				}
+			}),
+			signal: AbortSignal.timeout(2e3)
+		});
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=subagent-start.mjs.map

package/plugin/scripts/subagent-stop.mjs

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+//#region src/hooks/subagent-stop.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const sessionId = data.session_id || "unknown";
+	const lastMsg = typeof data.last_assistant_message === "string" ? data.last_assistant_message.slice(0, 4e3) : "";
+	try {
+		await fetch(`${REST_URL}/agentmemory/observe`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({
+				hookType: "subagent_stop",
+				sessionId,
+				project: data.cwd || process.cwd(),
+				cwd: data.cwd || process.cwd(),
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				data: {
+					agent_id: data.agent_id,
+					agent_type: data.agent_type,
+					last_message: lastMsg
+				}
+			}),
+			signal: AbortSignal.timeout(2e3)
+		});
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=subagent-stop.mjs.map

package/plugin/scripts/task-completed.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+//#region src/hooks/task-completed.ts
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data;
+	try {
+		data = JSON.parse(input);
+	} catch {
+		return;
+	}
+	const sessionId = data.session_id || "unknown";
+	try {
+		await fetch(`${REST_URL}/agentmemory/observe`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify({
+				hookType: "task_completed",
+				sessionId,
+				project: data.cwd || process.cwd(),
+				cwd: data.cwd || process.cwd(),
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				data: {
+					task_id: data.task_id,
+					task_subject: data.task_subject,
+					task_description: typeof data.task_description === "string" ? data.task_description.slice(0, 2e3) : "",
+					teammate_name: data.teammate_name,
+					team_name: data.team_name
+				}
+			}),
+			signal: AbortSignal.timeout(2e3)
+		});
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=task-completed.mjs.map

package/plugin/skills/forget/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: forget
+description: Delete specific observations or sessions from agentmemory. Use when user says "forget this", "delete memory", or wants to remove specific data for privacy.
+argument-hint: "[what to forget - session ID, file path, or search term]"
+user-invocable: true
+---
+
+The user wants to remove data from agentmemory: $ARGUMENTS
+
+**IMPORTANT**: This is a destructive operation. Always confirm with the user before deleting.
+
+Steps:
+1. First, search for matching observations:
+   ```bash
+   curl -s -H "Content-Type: application/json" \
+     -H "Authorization: Bearer ${AGENTMEMORY_SECRET:-}" \
+     -X POST "http://${AGENTMEMORY_URL:-localhost:3111}/agentmemory/search" \
+     -d '{"query": "<SEARCH_TERM>", "limit": 20}'
+   ```
+
+2. Show the user what was found and ask for confirmation
+3. If confirmed, delete via:
+   ```bash
+   curl -s -H "Content-Type: application/json" \
+     -H "Authorization: Bearer ${AGENTMEMORY_SECRET:-}" \
+     -X POST "http://${AGENTMEMORY_URL:-localhost:3111}/agentmemory/forget" \
+     -d '{"sessionId": "<ID>"}' # or {"observationIds": ["id1", "id2"]}
+   ```
+
+4. Confirm deletion to the user
+
+Never delete without explicit user confirmation.

package/plugin/skills/recall/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: recall
+description: Search agentmemory for past observations, sessions, and learnings about a topic. Use when the user says "recall", "remember", "what did we do", or needs context from past sessions.
+argument-hint: "[search query]"
+user-invocable: true
+---
+
+Search agentmemory for observations matching: $ARGUMENTS
+
+!`QUERY=$(echo "$ARGUMENTS" | sed 's/\\/\\\\/g; s/"/\\"/g') && curl -s -H "Content-Type: application/json" -H "Authorization: Bearer ${AGENTMEMORY_SECRET:-}" -X POST http://${AGENTMEMORY_URL:-localhost:3111}/agentmemory/search -d "{\"query\": \"${QUERY}\", \"limit\": 10}" 2>/dev/null || echo '{"results":[]}'`
+
+Present the search results to the user in a readable format:
+- Group by session
+- Show observation type, title, and narrative
+- Highlight the most important observations (importance >= 7)
+- If no results found, suggest alternative search terms
+
+Do NOT make up or hallucinate results. Only present what was returned from the search.

package/plugin/skills/remember/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: remember
+description: Explicitly save an insight, decision, or learning to agentmemory's long-term storage. Use when the user says "remember this", "save this", or wants to preserve knowledge for future sessions.
+argument-hint: "[what to remember]"
+user-invocable: true
+---
+
+The user wants to save this to long-term memory: $ARGUMENTS
+
+To save this, make a POST request using the Bash tool:
+
+```bash
+curl -s -H "Content-Type: application/json" \
+  -H "Authorization: Bearer ${AGENTMEMORY_SECRET:-}" \
+  -X POST "http://${AGENTMEMORY_URL:-localhost:3111}/agentmemory/remember" \
+  -d '{"content": "<ESCAPED_CONTENT>", "concepts": [<CONCEPTS>], "files": [<FILES>]}'
+```
+
+Steps:
+1. Analyze what the user wants to remember
+2. Extract key concepts (2-5 searchable terms)
+3. Extract relevant file paths if any
+4. Make the API call with the properly escaped content
+5. Confirm to the user that the memory was saved
+6. Show what concepts were tagged for future recall

package/plugin/skills/session-history/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: session-history
+description: Show what happened in recent past sessions on this project. Use when user asks "what did we do last time", "session history", "past sessions", or wants an overview of previous work.
+user-invocable: true
+---
+
+Fetch recent session history from agentmemory:
+
+!`curl -s -H "Authorization: Bearer ${AGENTMEMORY_SECRET:-}" "http://${AGENTMEMORY_URL:-localhost:3111}/agentmemory/sessions" 2>/dev/null || echo '{"sessions":[]}'`
+
+Present the sessions in reverse chronological order:
+- Show session ID (first 8 chars), project, start time, status
+- For each session with observations, show the key highlights
+- Note total observation count per session
+- If summaries exist, show the session title and key decisions
+
+Format as a clean timeline. Do NOT make up sessions -- only show what was returned.

package/src/auth.ts

@@ -0,0 +1,12 @@
+import { timingSafeEqual, createHmac, randomBytes } from "node:crypto";
+
+const hmacKey = randomBytes(32);
+
+export function timingSafeCompare(a: string, b: string): boolean {
+  const hmacA = createHmac("sha256", hmacKey).update(a).digest();
+  const hmacB = createHmac("sha256", hmacKey).update(b).digest();
+  return timingSafeEqual(hmacA, hmacB);
+}
+
+export const VIEWER_CSP =
+  "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; connect-src 'self' ws://localhost:* wss://localhost:*; img-src 'self'; font-src 'self'";