@codemem/mcp 0.31.4 → 0.32.0

package/dist/server-Djvf0Yik.js

@@ -0,0 +1,488 @@
+import { VERSION as e, dedupeOrderedIds as t, projectMatchesFilter as n, resolveProject as r, storeVectors as i, toJson as a } from "@codemem/core";
+import { McpServer as o } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z as s } from "zod";
+//#region src/project-scope.ts
+function c(e) {
+	return e?.trim() || null;
+}
+function l() {
+	return c(process.env.CODEMEM_PROJECT) ?? r(process.cwd());
+}
+function u(e) {
+	return c(e.project) ?? c(e.envProject) ?? null;
+}
+function d(e, t = l()) {
+	let n = {}, r = !1, i = (typeof e.project == "string" ? c(e.project) : void 0) || c(t) || void 0;
+	i && (n.project = i, r = !0);
+	for (let t of [
+		"kind",
+		"visibility",
+		"scope_id",
+		"include_scope_ids",
+		"exclude_scope_ids",
+		"include_visibility",
+		"exclude_visibility",
+		"include_workspace_ids",
+		"exclude_workspace_ids",
+		"include_workspace_kinds",
+		"exclude_workspace_kinds",
+		"include_actor_ids",
+		"exclude_actor_ids",
+		"include_trust_states",
+		"exclude_trust_states",
+		"ownership_scope",
+		"personal_first",
+		"trust_bias",
+		"widen_shared_when_weak",
+		"widen_shared_min_personal_results",
+		"widen_shared_min_personal_score"
+	]) {
+		let i = e[t];
+		i != null && (n[t] = i, r = !0);
+	}
+	return r ? n : void 0;
+}
+//#endregion
+//#region src/content.ts
+function f(e) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(e)
+	}] };
+}
+function p(e) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify({ error: e })
+	}] };
+}
+//#endregion
+//#region src/memory-access.ts
+function m(e, t, n) {
+	return e.timeline(null, t, 0, 0, n ?? null).find((e) => e.id === t) ?? null;
+}
+function h(e, t, n) {
+	if (t.length === 0) return [];
+	let r = [];
+	for (let i of t) {
+		let t = m(e, i, n);
+		t && r.push(t);
+	}
+	return r;
+}
+function g(e, t, n) {
+	return m(e, t, n) ? (e.forget(t), !0) : !1;
+}
+function _(e, t, n = {}) {
+	return e.db.transaction(() => {
+		let r = n.now?.() ?? (/* @__PURE__ */ new Date()).toISOString(), i = n.user ?? process.env.USER ?? "unknown", o = n.cwd ?? process.cwd(), s = u({
+			project: t.project,
+			envProject: n.envProject
+		}), c = e.db.prepare("INSERT INTO sessions(started_at, ended_at, cwd, project, user, tool_version, metadata_json)\n				 VALUES (?, ?, ?, ?, ?, ?, ?)").run(r, r, o, s, i, "mcp-ts", a({ mcp: !0 })), l = Number(c.lastInsertRowid), d = e.remember(l, t.kind, t.title, t.body, t.confidence);
+		if (!m(e, d)) throw Error("unauthorized_scope");
+		return e.db.prepare("UPDATE sessions SET ended_at = ?, metadata_json = ? WHERE id = ?").run(n.now?.() ?? (/* @__PURE__ */ new Date()).toISOString(), a({ mcp: !0 }), l), {
+			memId: d,
+			title: t.title,
+			body: t.body
+		};
+	})();
+}
+//#endregion
+//#region src/schemas.ts
+var v = {
+	scope_id: s.string().optional().describe("Filter by a single sharing domain scope_id"),
+	include_scope_ids: s.array(s.string()).optional().describe("Sharing domain scope_ids to include"),
+	exclude_scope_ids: s.array(s.string()).optional().describe("Sharing domain scope_ids to exclude")
+}, y = {
+	kind: s.string().optional().describe("Filter by memory kind"),
+	project: s.string().optional().describe("Filter by project scope (matches sessions.project)"),
+	...v,
+	visibility: s.array(s.string()).optional(),
+	include_visibility: s.array(s.string()).optional(),
+	exclude_visibility: s.array(s.string()).optional(),
+	include_workspace_ids: s.array(s.string()).optional(),
+	exclude_workspace_ids: s.array(s.string()).optional(),
+	include_workspace_kinds: s.array(s.string()).optional(),
+	exclude_workspace_kinds: s.array(s.string()).optional(),
+	include_actor_ids: s.array(s.string()).optional(),
+	exclude_actor_ids: s.array(s.string()).optional(),
+	include_trust_states: s.array(s.string()).optional(),
+	exclude_trust_states: s.array(s.string()).optional(),
+	ownership_scope: s.string().optional(),
+	personal_first: s.union([s.boolean(), s.string()]).optional(),
+	trust_bias: s.string().optional(),
+	widen_shared_when_weak: s.union([s.boolean(), s.string()]).optional(),
+	widen_shared_min_personal_results: s.number().int().optional(),
+	widen_shared_min_personal_score: s.number().optional()
+}, b = s.enum([
+	"discovery",
+	"change",
+	"feature",
+	"bugfix",
+	"refactor",
+	"decision",
+	"exploration"
+]), x = Object.keys(y).toSorted();
+//#endregion
+//#region src/tools/items.ts
+function S(e, t) {
+	let { envProject: n, store: r } = t;
+	e.tool("memory_get", "Fetch a single memory item by ID.", {
+		memory_id: s.number().int().describe("Memory ID"),
+		...y
+	}, async (e) => {
+		try {
+			let t = m(r, e.memory_id, d(e, null));
+			return t ? f(t) : p("not_found");
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	}), e.tool("memory_get_observations", "Fetch multiple memory items by their IDs.", {
+		ids: s.array(s.number().int()).max(200).describe("Memory IDs to fetch"),
+		...y
+	}, async (e) => {
+		try {
+			return f({ items: h(r, e.ids, d(e, null)) });
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	}), e.tool("memory_remember", "Create a new memory. Use for milestones, decisions, and notable facts.", {
+		kind: b.describe("Memory kind"),
+		title: s.string().describe("Short title"),
+		body: s.string().describe("Body text (high-signal content)"),
+		confidence: s.number().min(0).max(1).default(.5).describe("Confidence 0-1"),
+		project: s.string().optional().describe("Project identifier")
+	}, async (e) => {
+		try {
+			let t = _(r, e, { envProject: n() });
+			try {
+				await i(r.db, t.memId, t.title, t.body);
+			} catch {}
+			return f({ id: t.memId });
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	}), e.tool("memory_forget", "Soft-delete a memory item. Use for incorrect or sensitive data.", {
+		memory_id: s.number().int().describe("Memory ID to forget"),
+		...y
+	}, async (e) => {
+		try {
+			return g(r, e.memory_id, d(e, null)) ? f({ status: "ok" }) : p("not_found");
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	});
+}
+//#endregion
+//#region src/tools/learn.ts
+function C(e) {
+	e.tool("memory_learn", "Learn how to use codemem memory tools. Call this first if unfamiliar.", {}, async () => f({
+		intro: "Use this tool when you're new to codemem or unsure when to recall/persist.",
+		client_hint: "If you are unfamiliar with codemem, call memory.learn first.",
+		recall: {
+			when: ["Start of a task or when the user references prior work.", "When you need background context, decisions, or recent changes."],
+			how: [
+				"Use memory.search_index to get compact candidates.",
+				"Use memory.timeline to expand around a promising memory.",
+				"Use memory.get_observations for full details only when needed.",
+				"Use memory.pack for quick one-shot context blocks.",
+				"Use the project filter unless the user requests cross-project context."
+			],
+			examples: [
+				"memory.search_index(\"billing cache bug\", limit=5)",
+				"memory.timeline(memory_id=123)",
+				"memory.get_observations([123, 456])"
+			]
+		},
+		persistence: {
+			when: ["Milestones (task done, key decision, new facts learned).", "Notable regressions or follow-ups that should be remembered."],
+			how: [
+				"Use memory.remember with kind decision/discovery/change/exploration.",
+				"Keep titles short and bodies high-signal.",
+				"ALWAYS pass the project parameter if known."
+			],
+			examples: ["memory.remember(kind=\"decision\", title=\"Switch to async cache\", body=\"...why...\", project=\"my-service\")", "memory.remember(kind=\"change\", title=\"Fixed retry loop\", body=\"...impact...\", project=\"my-service\")"]
+		},
+		forget: {
+			when: ["Accidental or sensitive data stored in memory items.", "Obsolete or incorrect items that should no longer surface."],
+			how: ["Call memory.forget(id) to mark the item inactive.", "Prefer forgetting over overwriting to preserve auditability."],
+			examples: ["memory.forget(123)"]
+		},
+		prompt_hint: "At task start: call memory.search_index; during work: memory.timeline + memory.get_observations; at milestones: memory.remember.",
+		recommended_system_prompt: [
+			"Trigger policy (1-liner): If the user references prior work or starts a task,",
+			"immediately call memory.search_index; then use memory.timeline + memory.get_observations;",
+			"at milestones, call memory.remember; use memory.forget for incorrect/sensitive items.",
+			"",
+			"System prompt:",
+			"You have access to codemem MCP tools. If unfamiliar, call memory.learn first.",
+			"",
+			"Recall:",
+			"- Start of any task: call memory.search_index with a concise task query.",
+			"- If prior work is referenced (\"as before\", \"last time\", \"we already did…\", \"regression\"),",
+			"  call memory.search_index or memory.timeline.",
+			"- Use memory.get_observations only after filtering IDs.",
+			"- Prefer project-scoped queries unless the user asks for cross-project.",
+			"",
+			"Persistence:",
+			"- On milestones (task done, key decision, new facts learned), call memory.remember.",
+			"- Use kind=decision for tradeoffs, kind=change for outcomes, kind=discovery/exploration for useful findings.",
+			"- Keep titles short and bodies high-signal.",
+			"- ALWAYS pass the project parameter if known.",
+			"",
+			"Safety:",
+			"- Use memory.forget(id) for incorrect or sensitive items.",
+			"",
+			"Examples:",
+			"- memory.search_index(\"billing cache bug\")",
+			"- memory.timeline(memory_id=123)",
+			"- memory.get_observations([123, 456])",
+			"- memory.remember(kind=\"decision\", title=\"Use async cache\", body=\"Chose async cache to avoid lock contention in X.\", project=\"my-service\")",
+			"- memory.remember(kind=\"change\", title=\"Fixed retry loop\", body=\"Root cause was Y; added guard in Z.\", project=\"my-service\")",
+			"- memory.forget(123)"
+		].join("\n")
+	}));
+}
+//#endregion
+//#region src/memory-kinds.ts
+var w = {
+	discovery: "Something learned about the codebase, architecture, or tools",
+	change: "A code change that was made",
+	feature: "A new feature that was implemented",
+	bugfix: "A bug that was found and fixed",
+	refactor: "Code that was refactored or restructured",
+	decision: "A design or architecture decision",
+	exploration: "An experiment or investigation (may not have shipped)"
+};
+//#endregion
+//#region src/tools/schema.ts
+function T(e) {
+	e.tool("memory_schema", "Return the memory schema — kinds, fields, and available filters.", {}, async () => f({
+		kinds: Object.keys(w),
+		kind_descriptions: w,
+		fields: {
+			title: "short text",
+			body: "long text",
+			subtitle: "short text",
+			facts: "list<string>",
+			narrative: "long text",
+			concepts: "list<string>",
+			files_read: "list<string>",
+			files_modified: "list<string>",
+			prompt_number: "int"
+		},
+		filters: x
+	}));
+}
+//#endregion
+//#region src/tools/search.ts
+function E(e, t) {
+	let { defaultProject: n, store: r } = t;
+	e.tool("memory_search", "Search memories by text query. Returns full body text for each match.", {
+		query: s.string().describe("Search query"),
+		limit: s.number().int().min(1).max(50).default(5).describe("Max results"),
+		...y
+	}, async (e) => {
+		try {
+			let t = d(e, n());
+			return f({ items: r.search(e.query, e.limit, t).map((e) => ({
+				id: e.id,
+				title: e.title,
+				kind: e.kind,
+				body: e.body_text,
+				confidence: e.confidence,
+				score: e.score,
+				session_id: e.session_id,
+				metadata: e.metadata
+			})) });
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	}), e.tool("memory_search_index", "Search memories by text query. Returns compact index entries (no body) for browsing.", {
+		query: s.string().describe("Search query"),
+		limit: s.number().int().min(1).max(50).default(8).describe("Max results"),
+		...y
+	}, async (e) => {
+		try {
+			let t = d(e, n());
+			return f({ items: r.search(e.query, e.limit, t).map((e) => ({
+				id: e.id,
+				kind: e.kind,
+				title: e.title,
+				score: e.score,
+				created_at: e.created_at,
+				session_id: e.session_id,
+				metadata: e.metadata
+			})) });
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	}), e.tool("memory_explain", "Explain search results with detailed scoring breakdown.", {
+		query: s.string().optional().describe("Search query"),
+		ids: s.array(s.number().int()).max(200).optional().describe("Specific memory IDs to explain"),
+		limit: s.number().int().min(1).max(50).default(10).describe("Max results"),
+		include_pack_context: s.boolean().default(!1).describe("Include formatted pack context"),
+		...y
+	}, async (e) => {
+		try {
+			let t = d(e, n());
+			return f(r.explain(e.query ?? null, e.ids ?? null, e.limit, t, { includePackContext: e.include_pack_context }));
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	}), e.tool("memory_recent", "Return recent memories, newest first.", {
+		limit: s.number().int().min(1).max(100).default(8).describe("Max results"),
+		...y
+	}, async (e) => {
+		try {
+			let t = d(e, n());
+			return f({ items: r.recent(e.limit, t) });
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	}), e.tool("memory_pack", "Build a formatted memory pack from search results — quick one-shot context block.", {
+		context: s.string().describe("Context description to search for"),
+		limit: s.number().int().min(1).max(50).optional().describe("Max items to include"),
+		compact: s.boolean().optional().describe("When true, render a scannable index of all items with full detail only for the top N (default 3). Saves tokens when broad overview matters more than per-item detail."),
+		compact_detail_count: s.number().int().min(0).max(50).optional().describe("Number of items to show in full detail in compact mode (default 3)"),
+		compression_mode: s.enum([
+			"off",
+			"compact",
+			"ids"
+		]).optional().describe("Near-related compression mode: off disables it, compact applies only to compact rendering, ids applies in all modes. Defaults to CODEMEM_PACK_COMPRESSION or compact."),
+		...y
+	}, async (e) => {
+		try {
+			let t = d(e, n()), i = e.compact || e.compact_detail_count != null || e.compression_mode != null ? {
+				compact: e.compact ?? (e.compact_detail_count == null ? void 0 : !0),
+				compactDetailCount: e.compact_detail_count,
+				compressionMode: e.compression_mode
+			} : void 0;
+			return f(await r.buildMemoryPackAsync(e.context, e.limit ?? void 0, null, t, i));
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	});
+}
+//#endregion
+//#region src/tools/timeline.ts
+function D(e, r) {
+	let { defaultProject: i, store: a } = r;
+	e.tool("memory_timeline", "Get a chronological window of memories around an anchor (by ID or query).", {
+		query: s.string().optional().describe("Search query to find anchor"),
+		memory_id: s.number().int().optional().describe("Anchor memory ID"),
+		depth_before: s.number().int().min(0).default(3).describe("Items before anchor"),
+		depth_after: s.number().int().min(0).default(3).describe("Items after anchor"),
+		...y
+	}, async (e) => {
+		try {
+			let t = d(e, i());
+			return f({ items: a.timeline(e.query ?? null, e.memory_id ?? null, e.depth_before, e.depth_after, t) });
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	}), e.tool("memory_expand", "Fetch memories by ID with surrounding timeline context.", {
+		ids: s.array(s.union([s.number(), s.string()])).max(200).describe("Memory IDs to expand"),
+		depth_before: s.number().int().min(0).default(3).describe("Timeline items before"),
+		depth_after: s.number().int().min(0).default(3).describe("Timeline items after"),
+		include_observations: s.boolean().default(!1).describe("Include full observation details"),
+		...y
+	}, async (e) => {
+		try {
+			let r = d(e, e.project !== void 0 && !e.project.trim() ? null : i()), o = r?.project ?? null, { ordered: s, invalid: c } = t(e.ids), l = [];
+			c.length > 0 && l.push({
+				code: "INVALID_ARGUMENT",
+				field: "ids",
+				message: "some ids are not valid integers",
+				ids: c
+			});
+			let u = [], p = [], m = [], g = [], _ = [], v = /* @__PURE__ */ new Set(), y = /* @__PURE__ */ new Map();
+			for (let t of s) {
+				let i = a.get(t);
+				if (!i?.active) {
+					u.push(t);
+					continue;
+				}
+				let s = i.session_id;
+				if (o && s > 0) {
+					if (!y.has(s)) {
+						let e = a.db.prepare("SELECT project FROM sessions WHERE id = ? LIMIT 1").get(s);
+						y.set(s, typeof e?.project == "string" ? e.project : null);
+					}
+					if (!n(o, y.get(s) ?? null)) {
+						p.push(t);
+						continue;
+					}
+				} else if (o && s <= 0) {
+					p.push(t);
+					continue;
+				}
+				let c = a.timeline(null, t, e.depth_before, e.depth_after, r), l = c.find((e) => e.id === t);
+				if (!l) {
+					m.push(t);
+					continue;
+				}
+				g.push(l);
+				for (let e of c) {
+					let t = e.id;
+					t <= 0 || v.has(t) || (v.add(t), _.push(e));
+				}
+			}
+			u.length > 0 && l.push({
+				code: "NOT_FOUND",
+				field: "ids",
+				message: "some requested ids were not found",
+				ids: u
+			}), p.length > 0 && l.push({
+				code: "PROJECT_MISMATCH",
+				field: "project",
+				message: "some requested ids are outside the requested project scope",
+				ids: p
+			}), m.length > 0 && l.push({
+				code: "FILTER_MISMATCH",
+				field: "filters",
+				message: "some requested ids are outside the requested filters",
+				ids: m
+			});
+			let b = [];
+			if (e.include_observations) {
+				let e = /* @__PURE__ */ new Set(), t = [];
+				for (let n of [...g, ..._]) n.id > 0 && !e.has(n.id) && (e.add(n.id), t.push(n.id));
+				b = h(a, t, r);
+			}
+			return f({
+				anchors: g,
+				timeline: _,
+				observations: b,
+				missing_ids: s.filter((e) => u.includes(e) || p.includes(e) || m.includes(e)),
+				errors: l,
+				metadata: {
+					project: o,
+					requested_ids_count: s.length,
+					returned_anchor_count: g.length,
+					timeline_count: _.length,
+					include_observations: e.include_observations
+				}
+			});
+		} catch (e) {
+			return p(e instanceof Error ? e.message : String(e));
+		}
+	});
+}
+//#endregion
+//#region src/server.ts
+function O(t, n = {}) {
+	let r = new o({
+		name: "codemem",
+		version: e
+	}), i = {
+		store: t,
+		defaultProject: () => n.resolveDefaultProject ? n.resolveDefaultProject() : n.defaultProject === void 0 ? l() : n.defaultProject,
+		envProject: () => n.envProject === void 0 ? process.env.CODEMEM_PROJECT ?? null : n.envProject
+	};
+	return E(r, i), D(r, i), S(r, i), T(r), C(r), r;
+}
+//#endregion
+export { O as t };
+
+//# sourceMappingURL=server-Djvf0Yik.js.map

package/dist/server-Djvf0Yik.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-Djvf0Yik.js","names":[],"sources":["../src/project-scope.ts","../src/content.ts","../src/memory-access.ts","../src/schemas.ts","../src/tools/items.ts","../src/tools/learn.ts","../src/memory-kinds.ts","../src/tools/schema.ts","../src/tools/search.ts","../src/tools/timeline.ts","../src/server.ts"],"sourcesContent":["import { type MemoryFilters, resolveProject } from \"@codemem/core\";\n\nfunction cleanProject(value: string | null | undefined): string | null {\n\tconst trimmed = value?.trim();\n\treturn trimmed ? trimmed : null;\n}\n\nexport function resolveDefaultProject(): string | null {\n\treturn cleanProject(process.env.CODEMEM_PROJECT) ?? resolveProject(process.cwd());\n}\n\nexport function resolveWriteProject(input: {\n\tproject?: string | null;\n\tenvProject?: string | null;\n}): string | null {\n\treturn cleanProject(input.project) ?? cleanProject(input.envProject) ?? null;\n}\n\nexport function buildFilters(\n\traw: Record<string, unknown>,\n\tdefaultProject = resolveDefaultProject(),\n): MemoryFilters | undefined {\n\tconst filters: MemoryFilters = {};\n\tlet hasAny = false;\n\n\tconst explicitProject = typeof raw.project === \"string\" ? cleanProject(raw.project) : undefined;\n\tconst resolvedProject = explicitProject || cleanProject(defaultProject) || undefined;\n\tif (resolvedProject) {\n\t\tfilters.project = resolvedProject;\n\t\thasAny = true;\n\t}\n\n\tfor (const key of [\n\t\t\"kind\",\n\t\t\"visibility\",\n\t\t\"scope_id\",\n\t\t\"include_scope_ids\",\n\t\t\"exclude_scope_ids\",\n\t\t\"include_visibility\",\n\t\t\"exclude_visibility\",\n\t\t\"include_workspace_ids\",\n\t\t\"exclude_workspace_ids\",\n\t\t\"include_workspace_kinds\",\n\t\t\"exclude_workspace_kinds\",\n\t\t\"include_actor_ids\",\n\t\t\"exclude_actor_ids\",\n\t\t\"include_trust_states\",\n\t\t\"exclude_trust_states\",\n\t\t\"ownership_scope\",\n\t\t\"personal_first\",\n\t\t\"trust_bias\",\n\t\t\"widen_shared_when_weak\",\n\t\t\"widen_shared_min_personal_results\",\n\t\t\"widen_shared_min_personal_score\",\n\t] as const) {\n\t\tconst val = raw[key];\n\t\tif (val !== undefined && val !== null) {\n\t\t\t(filters as Record<string, unknown>)[key] = val;\n\t\t\thasAny = true;\n\t\t}\n\t}\n\n\treturn hasAny ? filters : undefined;\n}\n","export function jsonContent(data: unknown) {\n\treturn { content: [{ type: \"text\" as const, text: JSON.stringify(data) }] };\n}\n\nexport function errorContent(message: string) {\n\treturn { content: [{ type: \"text\" as const, text: JSON.stringify({ error: message }) }] };\n}\n","import {\n\ttype MemoryFilters,\n\ttype MemoryItemResponse,\n\ttype MemoryStore,\n\ttoJson,\n} from \"@codemem/core\";\nimport { resolveWriteProject } from \"./project-scope.js\";\n\nexport function getMemoryForMcp(\n\tstore: MemoryStore,\n\tmemoryId: number,\n\tfilters?: MemoryFilters,\n): MemoryItemResponse | null {\n\tconst rows = store.timeline(null, memoryId, 0, 0, filters ?? null);\n\treturn rows.find((row) => row.id === memoryId) ?? null;\n}\n\nexport function getManyForMcp(\n\tstore: MemoryStore,\n\tids: number[],\n\tfilters?: MemoryFilters,\n): MemoryItemResponse[] {\n\tif (ids.length === 0) return [];\n\tconst results: MemoryItemResponse[] = [];\n\tfor (const id of ids) {\n\t\tconst item = getMemoryForMcp(store, id, filters);\n\t\tif (item) results.push(item);\n\t}\n\treturn results;\n}\n\nexport function forgetMemoryForMcp(\n\tstore: MemoryStore,\n\tmemoryId: number,\n\tfilters?: MemoryFilters,\n): boolean {\n\tconst item = getMemoryForMcp(store, memoryId, filters);\n\tif (!item) return false;\n\tstore.forget(memoryId);\n\treturn true;\n}\n\nexport interface RememberMemoryForMcpInput {\n\tkind: string;\n\ttitle: string;\n\tbody: string;\n\tconfidence: number;\n\tproject?: string | null;\n}\n\nexport interface RememberMemoryForMcpContext {\n\tcwd?: string;\n\tuser?: string;\n\tenvProject?: string | null;\n\tnow?: () => string;\n}\n\nexport function rememberMemoryForMcp(\n\tstore: MemoryStore,\n\tinput: RememberMemoryForMcpInput,\n\tcontext: RememberMemoryForMcpContext = {},\n): { memId: number; title: string; body: string } {\n\treturn store.db.transaction(() => {\n\t\tconst now = context.now?.() ?? new Date().toISOString();\n\t\tconst user = context.user ?? process.env.USER ?? \"unknown\";\n\t\tconst cwd = context.cwd ?? process.cwd();\n\t\tconst project = resolveWriteProject({\n\t\t\tproject: input.project,\n\t\t\tenvProject: context.envProject,\n\t\t});\n\n\t\tconst sessionInfo = store.db\n\t\t\t.prepare(\n\t\t\t\t`INSERT INTO sessions(started_at, ended_at, cwd, project, user, tool_version, metadata_json)\n\t\t\t\t VALUES (?, ?, ?, ?, ?, ?, ?)`,\n\t\t\t)\n\t\t\t.run(now, now, cwd, project, user, \"mcp-ts\", toJson({ mcp: true }));\n\t\tconst sessionId = Number(sessionInfo.lastInsertRowid);\n\n\t\tconst memId = store.remember(sessionId, input.kind, input.title, input.body, input.confidence);\n\t\tif (!getMemoryForMcp(store, memId)) {\n\t\t\tthrow new Error(\"unauthorized_scope\");\n\t\t}\n\n\t\tstore.db\n\t\t\t.prepare(\"UPDATE sessions SET ended_at = ?, metadata_json = ? WHERE id = ?\")\n\t\t\t.run(context.now?.() ?? new Date().toISOString(), toJson({ mcp: true }), sessionId);\n\n\t\treturn { memId, title: input.title, body: input.body };\n\t})();\n}\n","import { z } from \"zod\";\n\nconst scopeFilterSchema = {\n\tscope_id: z.string().optional().describe(\"Filter by a single sharing domain scope_id\"),\n\tinclude_scope_ids: z.array(z.string()).optional().describe(\"Sharing domain scope_ids to include\"),\n\texclude_scope_ids: z.array(z.string()).optional().describe(\"Sharing domain scope_ids to exclude\"),\n};\n\nexport const filterSchema = {\n\tkind: z.string().optional().describe(\"Filter by memory kind\"),\n\tproject: z.string().optional().describe(\"Filter by project scope (matches sessions.project)\"),\n\t...scopeFilterSchema,\n\tvisibility: z.array(z.string()).optional(),\n\tinclude_visibility: z.array(z.string()).optional(),\n\texclude_visibility: z.array(z.string()).optional(),\n\tinclude_workspace_ids: z.array(z.string()).optional(),\n\texclude_workspace_ids: z.array(z.string()).optional(),\n\tinclude_workspace_kinds: z.array(z.string()).optional(),\n\texclude_workspace_kinds: z.array(z.string()).optional(),\n\tinclude_actor_ids: z.array(z.string()).optional(),\n\texclude_actor_ids: z.array(z.string()).optional(),\n\tinclude_trust_states: z.array(z.string()).optional(),\n\texclude_trust_states: z.array(z.string()).optional(),\n\townership_scope: z.string().optional(),\n\tpersonal_first: z.union([z.boolean(), z.string()]).optional(),\n\ttrust_bias: z.string().optional(),\n\twiden_shared_when_weak: z.union([z.boolean(), z.string()]).optional(),\n\twiden_shared_min_personal_results: z.number().int().optional(),\n\twiden_shared_min_personal_score: z.number().optional(),\n};\n\nexport const memoryKindSchema = z.enum([\n\t\"discovery\",\n\t\"change\",\n\t\"feature\",\n\t\"bugfix\",\n\t\"refactor\",\n\t\"decision\",\n\t\"exploration\",\n]);\n\nexport const filterNames = Object.keys(filterSchema).toSorted();\n","import { storeVectors } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport {\n\tforgetMemoryForMcp,\n\tgetManyForMcp,\n\tgetMemoryForMcp,\n\trememberMemoryForMcp,\n} from \"../memory-access.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema, memoryKindSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerItemTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { envProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_get\",\n\t\t\"Fetch a single memory item by ID.\",\n\t\t{\n\t\t\tmemory_id: z.number().int().describe(\"Memory ID\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Direct-ID ops do not inherit the server default project. Callers already\n\t\t\t\t// have an exact ID; cwd/env should not silently scope the lookup.\n\t\t\t\tconst item = getMemoryForMcp(store, args.memory_id, buildFilters(args, null));\n\t\t\t\tif (!item) return errorContent(\"not_found\");\n\t\t\t\treturn jsonContent(item);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_get_observations\",\n\t\t\"Fetch multiple memory items by their IDs.\",\n\t\t{\n\t\t\tids: z.array(z.number().int()).max(200).describe(\"Memory IDs to fetch\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst items = getManyForMcp(store, args.ids, buildFilters(args, null));\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_remember\",\n\t\t\"Create a new memory. Use for milestones, decisions, and notable facts.\",\n\t\t{\n\t\t\tkind: memoryKindSchema.describe(\"Memory kind\"),\n\t\t\ttitle: z.string().describe(\"Short title\"),\n\t\t\tbody: z.string().describe(\"Body text (high-signal content)\"),\n\t\t\tconfidence: z.number().min(0).max(1).default(0.5).describe(\"Confidence 0-1\"),\n\t\t\tproject: z.string().optional().describe(\"Project identifier\"),\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Writes never inherit the server default project. They only honor an\n\t\t\t\t// explicit `project` input or CODEMEM_PROJECT; otherwise project stays null.\n\t\t\t\tconst result = rememberMemoryForMcp(store, args, {\n\t\t\t\t\tenvProject: envProject(),\n\t\t\t\t});\n\n\t\t\t\ttry {\n\t\t\t\t\tawait storeVectors(store.db, result.memId, result.title, result.body);\n\t\t\t\t} catch {\n\t\t\t\t\t// Memory writes should succeed even if embeddings are unavailable.\n\t\t\t\t}\n\n\t\t\t\treturn jsonContent({ id: result.memId });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_forget\",\n\t\t\"Soft-delete a memory item. Use for incorrect or sensitive data.\",\n\t\t{\n\t\t\tmemory_id: z.number().int().describe(\"Memory ID to forget\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tif (!forgetMemoryForMcp(store, args.memory_id, buildFilters(args, null))) {\n\t\t\t\t\treturn errorContent(\"not_found\");\n\t\t\t\t}\n\t\t\t\treturn jsonContent({ status: \"ok\" });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { jsonContent } from \"../content.js\";\n\nexport function registerLearnTools(server: McpServer): void {\n\tserver.tool(\n\t\t\"memory_learn\",\n\t\t\"Learn how to use codemem memory tools. Call this first if unfamiliar.\",\n\t\t{},\n\t\tasync () => {\n\t\t\treturn jsonContent({\n\t\t\t\tintro: \"Use this tool when you're new to codemem or unsure when to recall/persist.\",\n\t\t\t\tclient_hint: \"If you are unfamiliar with codemem, call memory.learn first.\",\n\t\t\t\trecall: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Start of a task or when the user references prior work.\",\n\t\t\t\t\t\t\"When you need background context, decisions, or recent changes.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Use memory.search_index to get compact candidates.\",\n\t\t\t\t\t\t\"Use memory.timeline to expand around a promising memory.\",\n\t\t\t\t\t\t\"Use memory.get_observations for full details only when needed.\",\n\t\t\t\t\t\t\"Use memory.pack for quick one-shot context blocks.\",\n\t\t\t\t\t\t\"Use the project filter unless the user requests cross-project context.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\n\t\t\t\t\t\t'memory.search_index(\"billing cache bug\", limit=5)',\n\t\t\t\t\t\t\"memory.timeline(memory_id=123)\",\n\t\t\t\t\t\t\"memory.get_observations([123, 456])\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tpersistence: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Milestones (task done, key decision, new facts learned).\",\n\t\t\t\t\t\t\"Notable regressions or follow-ups that should be remembered.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Use memory.remember with kind decision/discovery/change/exploration.\",\n\t\t\t\t\t\t\"Keep titles short and bodies high-signal.\",\n\t\t\t\t\t\t\"ALWAYS pass the project parameter if known.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\n\t\t\t\t\t\t'memory.remember(kind=\"decision\", title=\"Switch to async cache\", body=\"...why...\", project=\"my-service\")',\n\t\t\t\t\t\t'memory.remember(kind=\"change\", title=\"Fixed retry loop\", body=\"...impact...\", project=\"my-service\")',\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tforget: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Accidental or sensitive data stored in memory items.\",\n\t\t\t\t\t\t\"Obsolete or incorrect items that should no longer surface.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Call memory.forget(id) to mark the item inactive.\",\n\t\t\t\t\t\t\"Prefer forgetting over overwriting to preserve auditability.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\"memory.forget(123)\"],\n\t\t\t\t},\n\t\t\t\tprompt_hint:\n\t\t\t\t\t\"At task start: call memory.search_index; during work: memory.timeline + memory.get_observations; at milestones: memory.remember.\",\n\t\t\t\trecommended_system_prompt: [\n\t\t\t\t\t\"Trigger policy (1-liner): If the user references prior work or starts a task,\",\n\t\t\t\t\t\"immediately call memory.search_index; then use memory.timeline + memory.get_observations;\",\n\t\t\t\t\t\"at milestones, call memory.remember; use memory.forget for incorrect/sensitive items.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"System prompt:\",\n\t\t\t\t\t\"You have access to codemem MCP tools. If unfamiliar, call memory.learn first.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Recall:\",\n\t\t\t\t\t\"- Start of any task: call memory.search_index with a concise task query.\",\n\t\t\t\t\t'- If prior work is referenced (\"as before\", \"last time\", \"we already did…\", \"regression\"),',\n\t\t\t\t\t\"  call memory.search_index or memory.timeline.\",\n\t\t\t\t\t\"- Use memory.get_observations only after filtering IDs.\",\n\t\t\t\t\t\"- Prefer project-scoped queries unless the user asks for cross-project.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Persistence:\",\n\t\t\t\t\t\"- On milestones (task done, key decision, new facts learned), call memory.remember.\",\n\t\t\t\t\t\"- Use kind=decision for tradeoffs, kind=change for outcomes, kind=discovery/exploration for useful findings.\",\n\t\t\t\t\t\"- Keep titles short and bodies high-signal.\",\n\t\t\t\t\t\"- ALWAYS pass the project parameter if known.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Safety:\",\n\t\t\t\t\t\"- Use memory.forget(id) for incorrect or sensitive items.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Examples:\",\n\t\t\t\t\t'- memory.search_index(\"billing cache bug\")',\n\t\t\t\t\t\"- memory.timeline(memory_id=123)\",\n\t\t\t\t\t\"- memory.get_observations([123, 456])\",\n\t\t\t\t\t'- memory.remember(kind=\"decision\", title=\"Use async cache\", body=\"Chose async cache to avoid lock contention in X.\", project=\"my-service\")',\n\t\t\t\t\t'- memory.remember(kind=\"change\", title=\"Fixed retry loop\", body=\"Root cause was Y; added guard in Z.\", project=\"my-service\")',\n\t\t\t\t\t\"- memory.forget(123)\",\n\t\t\t\t].join(\"\\n\"),\n\t\t\t});\n\t\t},\n\t);\n}\n","export const MEMORY_KINDS: Record<string, string> = {\n\tdiscovery: \"Something learned about the codebase, architecture, or tools\",\n\tchange: \"A code change that was made\",\n\tfeature: \"A new feature that was implemented\",\n\tbugfix: \"A bug that was found and fixed\",\n\trefactor: \"Code that was refactored or restructured\",\n\tdecision: \"A design or architecture decision\",\n\texploration: \"An experiment or investigation (may not have shipped)\",\n};\n","import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { jsonContent } from \"../content.js\";\nimport { MEMORY_KINDS } from \"../memory-kinds.js\";\nimport { filterNames } from \"../schemas.js\";\n\nexport function registerSchemaTools(server: McpServer): void {\n\tserver.tool(\n\t\t\"memory_schema\",\n\t\t\"Return the memory schema — kinds, fields, and available filters.\",\n\t\t{},\n\t\tasync () => {\n\t\t\treturn jsonContent({\n\t\t\t\tkinds: Object.keys(MEMORY_KINDS),\n\t\t\t\tkind_descriptions: MEMORY_KINDS,\n\t\t\t\tfields: {\n\t\t\t\t\ttitle: \"short text\",\n\t\t\t\t\tbody: \"long text\",\n\t\t\t\t\tsubtitle: \"short text\",\n\t\t\t\t\tfacts: \"list<string>\",\n\t\t\t\t\tnarrative: \"long text\",\n\t\t\t\t\tconcepts: \"list<string>\",\n\t\t\t\t\tfiles_read: \"list<string>\",\n\t\t\t\t\tfiles_modified: \"list<string>\",\n\t\t\t\t\tprompt_number: \"int\",\n\t\t\t\t},\n\t\t\t\tfilters: filterNames,\n\t\t\t});\n\t\t},\n\t);\n}\n","import type { MemoryResult } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerSearchTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { defaultProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_search\",\n\t\t\"Search memories by text query. Returns full body text for each match.\",\n\t\t{\n\t\t\tquery: z.string().describe(\"Search query\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(5).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.search(args.query, args.limit, filters);\n\t\t\t\treturn jsonContent({\n\t\t\t\t\titems: items.map((m: MemoryResult) => ({\n\t\t\t\t\t\tid: m.id,\n\t\t\t\t\t\ttitle: m.title,\n\t\t\t\t\t\tkind: m.kind,\n\t\t\t\t\t\tbody: m.body_text,\n\t\t\t\t\t\tconfidence: m.confidence,\n\t\t\t\t\t\tscore: m.score,\n\t\t\t\t\t\tsession_id: m.session_id,\n\t\t\t\t\t\tmetadata: m.metadata,\n\t\t\t\t\t})),\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_search_index\",\n\t\t\"Search memories by text query. Returns compact index entries (no body) for browsing.\",\n\t\t{\n\t\t\tquery: z.string().describe(\"Search query\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(8).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.search(args.query, args.limit, filters);\n\t\t\t\treturn jsonContent({\n\t\t\t\t\titems: items.map((m: MemoryResult) => ({\n\t\t\t\t\t\tid: m.id,\n\t\t\t\t\t\tkind: m.kind,\n\t\t\t\t\t\ttitle: m.title,\n\t\t\t\t\t\tscore: m.score,\n\t\t\t\t\t\tcreated_at: m.created_at,\n\t\t\t\t\t\tsession_id: m.session_id,\n\t\t\t\t\t\tmetadata: m.metadata,\n\t\t\t\t\t})),\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_explain\",\n\t\t\"Explain search results with detailed scoring breakdown.\",\n\t\t{\n\t\t\tquery: z.string().optional().describe(\"Search query\"),\n\t\t\tids: z.array(z.number().int()).max(200).optional().describe(\"Specific memory IDs to explain\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(10).describe(\"Max results\"),\n\t\t\tinclude_pack_context: z.boolean().default(false).describe(\"Include formatted pack context\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst result = store.explain(args.query ?? null, args.ids ?? null, args.limit, filters, {\n\t\t\t\t\tincludePackContext: args.include_pack_context,\n\t\t\t\t});\n\t\t\t\treturn jsonContent(result);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_recent\",\n\t\t\"Return recent memories, newest first.\",\n\t\t{\n\t\t\tlimit: z.number().int().min(1).max(100).default(8).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.recent(args.limit, filters);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_pack\",\n\t\t\"Build a formatted memory pack from search results — quick one-shot context block.\",\n\t\t{\n\t\t\tcontext: z.string().describe(\"Context description to search for\"),\n\t\t\tlimit: z.number().int().min(1).max(50).optional().describe(\"Max items to include\"),\n\t\t\tcompact: z\n\t\t\t\t.boolean()\n\t\t\t\t.optional()\n\t\t\t\t.describe(\n\t\t\t\t\t\"When true, render a scannable index of all items with full detail only for the top N (default 3). Saves tokens when broad overview matters more than per-item detail.\",\n\t\t\t\t),\n\t\t\tcompact_detail_count: z\n\t\t\t\t.number()\n\t\t\t\t.int()\n\t\t\t\t.min(0)\n\t\t\t\t.max(50)\n\t\t\t\t.optional()\n\t\t\t\t.describe(\"Number of items to show in full detail in compact mode (default 3)\"),\n\t\t\tcompression_mode: z\n\t\t\t\t.enum([\"off\", \"compact\", \"ids\"])\n\t\t\t\t.optional()\n\t\t\t\t.describe(\n\t\t\t\t\t\"Near-related compression mode: off disables it, compact applies only to compact rendering, ids applies in all modes. Defaults to CODEMEM_PACK_COMPRESSION or compact.\",\n\t\t\t\t),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst renderOptions =\n\t\t\t\t\targs.compact || args.compact_detail_count != null || args.compression_mode != null\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tcompact: args.compact ?? (args.compact_detail_count != null ? true : undefined),\n\t\t\t\t\t\t\t\tcompactDetailCount: args.compact_detail_count,\n\t\t\t\t\t\t\t\tcompressionMode: args.compression_mode,\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: undefined;\n\t\t\t\tconst result = await store.buildMemoryPackAsync(\n\t\t\t\t\targs.context,\n\t\t\t\t\targs.limit ?? undefined,\n\t\t\t\t\tnull,\n\t\t\t\t\tfilters,\n\t\t\t\t\trenderOptions,\n\t\t\t\t);\n\t\t\t\treturn jsonContent(result);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import { dedupeOrderedIds, type MemoryItemResponse, projectMatchesFilter } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport { getManyForMcp } from \"../memory-access.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerTimelineTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { defaultProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_timeline\",\n\t\t\"Get a chronological window of memories around an anchor (by ID or query).\",\n\t\t{\n\t\t\tquery: z.string().optional().describe(\"Search query to find anchor\"),\n\t\t\tmemory_id: z.number().int().optional().describe(\"Anchor memory ID\"),\n\t\t\tdepth_before: z.number().int().min(0).default(3).describe(\"Items before anchor\"),\n\t\t\tdepth_after: z.number().int().min(0).default(3).describe(\"Items after anchor\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.timeline(\n\t\t\t\t\targs.query ?? null,\n\t\t\t\t\targs.memory_id ?? null,\n\t\t\t\t\targs.depth_before,\n\t\t\t\t\targs.depth_after,\n\t\t\t\t\tfilters,\n\t\t\t\t);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_expand\",\n\t\t\"Fetch memories by ID with surrounding timeline context.\",\n\t\t{\n\t\t\tids: z\n\t\t\t\t.array(z.union([z.number(), z.string()]))\n\t\t\t\t.max(200)\n\t\t\t\t.describe(\"Memory IDs to expand\"),\n\t\t\tdepth_before: z.number().int().min(0).default(3).describe(\"Timeline items before\"),\n\t\t\tdepth_after: z.number().int().min(0).default(3).describe(\"Timeline items after\"),\n\t\t\tinclude_observations: z.boolean().default(false).describe(\"Include full observation details\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Explicit blank `project` clears scoping for cross-project expansion.\n\t\t\t\t// Only fall back to the server default when `project` is omitted entirely.\n\t\t\t\tconst filterDefaultProject =\n\t\t\t\t\targs.project !== undefined && !args.project.trim() ? null : defaultProject();\n\t\t\t\tconst filters = buildFilters(args, filterDefaultProject);\n\t\t\t\tconst resolvedProject = filters?.project ?? null;\n\t\t\t\tconst { ordered: orderedIds, invalid: invalidIds } = dedupeOrderedIds(args.ids);\n\t\t\t\tconst errors: Array<Record<string, unknown>> = [];\n\n\t\t\t\tif (invalidIds.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"INVALID_ARGUMENT\",\n\t\t\t\t\t\tfield: \"ids\",\n\t\t\t\t\t\tmessage: \"some ids are not valid integers\",\n\t\t\t\t\t\tids: invalidIds,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tconst missingNotFound: number[] = [];\n\t\t\t\tconst missingProjectMismatch: number[] = [];\n\t\t\t\tconst missingFilterMismatch: number[] = [];\n\t\t\t\tconst anchors: MemoryItemResponse[] = [];\n\t\t\t\tconst timelineItems: MemoryItemResponse[] = [];\n\t\t\t\tconst timelineSeen = new Set<number>();\n\t\t\t\tconst sessionProjects = new Map<number, string | null>();\n\n\t\t\t\tfor (const memoryId of orderedIds) {\n\t\t\t\t\tconst item = store.get(memoryId);\n\t\t\t\t\tif (!item?.active) {\n\t\t\t\t\t\tmissingNotFound.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst sessionId = item.session_id;\n\t\t\t\t\tif (resolvedProject && sessionId > 0) {\n\t\t\t\t\t\tif (!sessionProjects.has(sessionId)) {\n\t\t\t\t\t\t\tconst row = store.db\n\t\t\t\t\t\t\t\t.prepare(\"SELECT project FROM sessions WHERE id = ? LIMIT 1\")\n\t\t\t\t\t\t\t\t.get(sessionId) as { project: string | null } | undefined;\n\t\t\t\t\t\t\tsessionProjects.set(sessionId, typeof row?.project === \"string\" ? row.project : null);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (!projectMatchesFilter(resolvedProject, sessionProjects.get(sessionId) ?? null)) {\n\t\t\t\t\t\t\tmissingProjectMismatch.push(memoryId);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (resolvedProject && sessionId <= 0) {\n\t\t\t\t\t\tmissingProjectMismatch.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst expanded = store.timeline(\n\t\t\t\t\t\tnull,\n\t\t\t\t\t\tmemoryId,\n\t\t\t\t\t\targs.depth_before,\n\t\t\t\t\t\targs.depth_after,\n\t\t\t\t\t\tfilters,\n\t\t\t\t\t);\n\t\t\t\t\tconst anchor = expanded.find((expandedItem) => expandedItem.id === memoryId);\n\t\t\t\t\tif (!anchor) {\n\t\t\t\t\t\tmissingFilterMismatch.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tanchors.push(anchor);\n\t\t\t\t\tfor (const expandedItem of expanded) {\n\t\t\t\t\t\tconst expandedId = expandedItem.id;\n\t\t\t\t\t\tif (expandedId <= 0 || timelineSeen.has(expandedId)) continue;\n\t\t\t\t\t\ttimelineSeen.add(expandedId);\n\t\t\t\t\t\ttimelineItems.push(expandedItem);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (missingNotFound.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"NOT_FOUND\",\n\t\t\t\t\t\tfield: \"ids\",\n\t\t\t\t\t\tmessage: \"some requested ids were not found\",\n\t\t\t\t\t\tids: missingNotFound,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (missingProjectMismatch.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"PROJECT_MISMATCH\",\n\t\t\t\t\t\tfield: \"project\",\n\t\t\t\t\t\tmessage: \"some requested ids are outside the requested project scope\",\n\t\t\t\t\t\tids: missingProjectMismatch,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (missingFilterMismatch.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"FILTER_MISMATCH\",\n\t\t\t\t\t\tfield: \"filters\",\n\t\t\t\t\t\tmessage: \"some requested ids are outside the requested filters\",\n\t\t\t\t\t\tids: missingFilterMismatch,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tlet observations: MemoryItemResponse[] = [];\n\t\t\t\tif (args.include_observations) {\n\t\t\t\t\tconst observationSeen = new Set<number>();\n\t\t\t\t\tconst observationIds: number[] = [];\n\t\t\t\t\tfor (const item of [...anchors, ...timelineItems]) {\n\t\t\t\t\t\tif (item.id > 0 && !observationSeen.has(item.id)) {\n\t\t\t\t\t\t\tobservationSeen.add(item.id);\n\t\t\t\t\t\t\tobservationIds.push(item.id);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tobservations = getManyForMcp(store, observationIds, filters);\n\t\t\t\t}\n\n\t\t\t\treturn jsonContent({\n\t\t\t\t\tanchors,\n\t\t\t\t\ttimeline: timelineItems,\n\t\t\t\t\tobservations,\n\t\t\t\t\tmissing_ids: orderedIds.filter(\n\t\t\t\t\t\t(memoryId: number) =>\n\t\t\t\t\t\t\tmissingNotFound.includes(memoryId) ||\n\t\t\t\t\t\t\tmissingProjectMismatch.includes(memoryId) ||\n\t\t\t\t\t\t\tmissingFilterMismatch.includes(memoryId),\n\t\t\t\t\t),\n\t\t\t\t\terrors,\n\t\t\t\t\tmetadata: {\n\t\t\t\t\t\tproject: resolvedProject,\n\t\t\t\t\t\trequested_ids_count: orderedIds.length,\n\t\t\t\t\t\treturned_anchor_count: anchors.length,\n\t\t\t\t\t\ttimeline_count: timelineItems.length,\n\t\t\t\t\t\tinclude_observations: args.include_observations,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import { type MemoryStore, VERSION } from \"@codemem/core\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { resolveDefaultProject } from \"./project-scope.js\";\nimport type { CodememMcpServerOptions, ToolRegistrationContext } from \"./tool-context.js\";\nimport { registerItemTools } from \"./tools/items.js\";\nimport { registerLearnTools } from \"./tools/learn.js\";\nimport { registerSchemaTools } from \"./tools/schema.js\";\nimport { registerSearchTools } from \"./tools/search.js\";\nimport { registerTimelineTools } from \"./tools/timeline.js\";\n\nexport function createCodememMcpServer(\n\tstore: MemoryStore,\n\toptions: CodememMcpServerOptions = {},\n): McpServer {\n\tconst server = new McpServer({ name: \"codemem\", version: VERSION });\n\tconst context: ToolRegistrationContext = {\n\t\tstore,\n\t\t// Resolve lazily per call so long-running servers pick up the current\n\t\t// CODEMEM_PROJECT / process.cwd() rather than the value at construction.\n\t\tdefaultProject: () => {\n\t\t\tif (options.resolveDefaultProject) return options.resolveDefaultProject();\n\t\t\tif (options.defaultProject !== undefined) return options.defaultProject;\n\t\t\treturn resolveDefaultProject();\n\t\t},\n\t\tenvProject: () =>\n\t\t\toptions.envProject !== undefined ? options.envProject : (process.env.CODEMEM_PROJECT ?? null),\n\t};\n\n\tregisterSearchTools(server, context);\n\tregisterTimelineTools(server, context);\n\tregisterItemTools(server, context);\n\tregisterSchemaTools(server);\n\tregisterLearnTools(server);\n\n\treturn server;\n}\n"],"mappings":";;;;AAEA,SAAS,EAAa,GAAiD;AAEtE,QADgB,GAAO,MAAM,IACF;;AAG5B,SAAgB,IAAuC;AACtD,QAAO,EAAa,QAAQ,IAAI,gBAAgB,IAAI,EAAe,QAAQ,KAAK,CAAC;;AAGlF,SAAgB,EAAoB,GAGlB;AACjB,QAAO,EAAa,EAAM,QAAQ,IAAI,EAAa,EAAM,WAAW,IAAI;;AAGzE,SAAgB,EACf,GACA,IAAiB,GAAuB,EACZ;CAC5B,IAAM,IAAyB,EAAE,EAC7B,IAAS,IAGP,KADkB,OAAO,EAAI,WAAY,WAAW,EAAa,EAAI,QAAQ,GAAG,KAAA,MAC3C,EAAa,EAAe,IAAI,KAAA;AAC3E,CAAI,MACH,EAAQ,UAAU,GAClB,IAAS;AAGV,MAAK,IAAM,KAAO;EACjB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,EAAW;EACX,IAAM,IAAM,EAAI;AAChB,EAAI,KAA6B,SAC/B,EAAoC,KAAO,GAC5C,IAAS;;AAIX,QAAO,IAAS,IAAU,KAAA;;;;AC9D3B,SAAgB,EAAY,GAAe;AAC1C,QAAO,EAAE,SAAS,CAAC;EAAE,MAAM;EAAiB,MAAM,KAAK,UAAU,EAAK;EAAE,CAAC,EAAE;;AAG5E,SAAgB,EAAa,GAAiB;AAC7C,QAAO,EAAE,SAAS,CAAC;EAAE,MAAM;EAAiB,MAAM,KAAK,UAAU,EAAE,OAAO,GAAS,CAAC;EAAE,CAAC,EAAE;;;;ACG1F,SAAgB,EACf,GACA,GACA,GAC4B;AAE5B,QADa,EAAM,SAAS,MAAM,GAAU,GAAG,GAAG,KAAW,KACtD,CAAK,MAAM,MAAQ,EAAI,OAAO,EAAS,IAAI;;AAGnD,SAAgB,EACf,GACA,GACA,GACuB;AACvB,KAAI,EAAI,WAAW,EAAG,QAAO,EAAE;CAC/B,IAAM,IAAgC,EAAE;AACxC,MAAK,IAAM,KAAM,GAAK;EACrB,IAAM,IAAO,EAAgB,GAAO,GAAI,EAAQ;AAChD,EAAI,KAAM,EAAQ,KAAK,EAAK;;AAE7B,QAAO;;AAGR,SAAgB,EACf,GACA,GACA,GACU;AAIV,QAHa,EAAgB,GAAO,GAAU,EACzC,IACL,EAAM,OAAO,EAAS,EACf,MAFW;;AAoBnB,SAAgB,EACf,GACA,GACA,IAAuC,EAAE,EACQ;AACjD,QAAO,EAAM,GAAG,kBAAkB;EACjC,IAAM,IAAM,EAAQ,OAAO,qBAAI,IAAI,MAAM,EAAC,aAAa,EACjD,IAAO,EAAQ,QAAQ,QAAQ,IAAI,QAAQ,WAC3C,IAAM,EAAQ,OAAO,QAAQ,KAAK,EAClC,IAAU,EAAoB;GACnC,SAAS,EAAM;GACf,YAAY,EAAQ;GACpB,CAAC,EAEI,IAAc,EAAM,GACxB,QACA,iIAEA,CACA,IAAI,GAAK,GAAK,GAAK,GAAS,GAAM,UAAU,EAAO,EAAE,KAAK,IAAM,CAAC,CAAC,EAC9D,IAAY,OAAO,EAAY,gBAAgB,EAE/C,IAAQ,EAAM,SAAS,GAAW,EAAM,MAAM,EAAM,OAAO,EAAM,MAAM,EAAM,WAAW;AAC9F,MAAI,CAAC,EAAgB,GAAO,EAAM,CACjC,OAAU,MAAM,qBAAqB;AAOtC,SAJA,EAAM,GACJ,QAAQ,mEAAmE,CAC3E,IAAI,EAAQ,OAAO,qBAAI,IAAI,MAAM,EAAC,aAAa,EAAE,EAAO,EAAE,KAAK,IAAM,CAAC,EAAE,EAAU,EAE7E;GAAE;GAAO,OAAO,EAAM;GAAO,MAAM,EAAM;GAAM;GACrD,EAAE;;;;ACvFL,IAAM,IAAoB;CACzB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,6CAA6C;CACtF,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,SAAS,sCAAsC;CACjG,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,SAAS,sCAAsC;CACjG,EAEY,IAAe;CAC3B,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,wBAAwB;CAC7D,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,qDAAqD;CAC7F,GAAG;CACH,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAC1C,oBAAoB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAClD,oBAAoB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAClD,uBAAuB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACrD,uBAAuB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACrD,yBAAyB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACvD,yBAAyB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACvD,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACjD,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACjD,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACpD,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACpD,iBAAiB,EAAE,QAAQ,CAAC,UAAU;CACtC,gBAAgB,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU;CAC7D,YAAY,EAAE,QAAQ,CAAC,UAAU;CACjC,wBAAwB,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU;CACrE,mCAAmC,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU;CAC9D,iCAAiC,EAAE,QAAQ,CAAC,UAAU;CACtD,EAEY,IAAmB,EAAE,KAAK;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC,EAEW,IAAc,OAAO,KAAK,EAAa,CAAC,UAAU;;;AC3B/D,SAAgB,EAAkB,GAAmB,GAAwC;CAC5F,IAAM,EAAE,eAAY,aAAU;AAsE9B,CApEA,EAAO,KACN,cACA,qCACA;EACC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,SAAS,YAAY;EACjD,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GAGH,IAAM,IAAO,EAAgB,GAAO,EAAK,WAAW,EAAa,GAAM,KAAK,CAAC;AAE7E,UADK,IACE,EAAY,EAAK,GADN,EAAa,YAAY;WAEnC,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,2BACA,6CACA;EACC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,sBAAsB;EACvE,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;AAEH,UAAO,EAAY,EAAE,OADP,EAAc,GAAO,EAAK,KAAK,EAAa,GAAM,KAAK,CAChD,EAAO,CAAC;WACrB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,mBACA,0EACA;EACC,MAAM,EAAiB,SAAS,cAAc;EAC9C,OAAO,EAAE,QAAQ,CAAC,SAAS,cAAc;EACzC,MAAM,EAAE,QAAQ,CAAC,SAAS,kCAAkC;EAC5D,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,GAAI,CAAC,SAAS,iBAAiB;EAC5E,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,qBAAqB;EAC7D,EACD,OAAO,MAAS;AACf,MAAI;GAGH,IAAM,IAAS,EAAqB,GAAO,GAAM,EAChD,YAAY,GAAY,EACxB,CAAC;AAEF,OAAI;AACH,UAAM,EAAa,EAAM,IAAI,EAAO,OAAO,EAAO,OAAO,EAAO,KAAK;WAC9D;AAIR,UAAO,EAAY,EAAE,IAAI,EAAO,OAAO,CAAC;WAChC,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,iBACA,mEACA;EACC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,SAAS,sBAAsB;EAC3D,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;AAIH,UAHK,EAAmB,GAAO,EAAK,WAAW,EAAa,GAAM,KAAK,CAAC,GAGjE,EAAY,EAAE,QAAQ,MAAM,CAAC,GAF5B,EAAa,YAAY;WAGzB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE;;;;ACnGF,SAAgB,EAAmB,GAAyB;AAC3D,GAAO,KACN,gBACA,yEACA,EAAE,EACF,YACQ,EAAY;EAClB,OAAO;EACP,aAAa;EACb,QAAQ;GACP,MAAM,CACL,2DACA,kEACA;GACD,KAAK;IACJ;IACA;IACA;IACA;IACA;IACA;GACD,UAAU;IACT;IACA;IACA;IACA;GACD;EACD,aAAa;GACZ,MAAM,CACL,4DACA,+DACA;GACD,KAAK;IACJ;IACA;IACA;IACA;GACD,UAAU,CACT,mHACA,8GACA;GACD;EACD,QAAQ;GACP,MAAM,CACL,wDACA,6DACA;GACD,KAAK,CACJ,qDACA,+DACA;GACD,UAAU,CAAC,qBAAqB;GAChC;EACD,aACC;EACD,2BAA2B;GAC1B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,CAAC,KAAK,KAAK;EACZ,CAAC,CAEH;;;;AC5FF,IAAa,IAAuC;CACnD,WAAW;CACX,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,UAAU;CACV,UAAU;CACV,aAAa;CACb;;;ACHD,SAAgB,EAAoB,GAAyB;AAC5D,GAAO,KACN,iBACA,oEACA,EAAE,EACF,YACQ,EAAY;EAClB,OAAO,OAAO,KAAK,EAAa;EAChC,mBAAmB;EACnB,QAAQ;GACP,OAAO;GACP,MAAM;GACN,UAAU;GACV,OAAO;GACP,WAAW;GACX,UAAU;GACV,YAAY;GACZ,gBAAgB;GAChB,eAAe;GACf;EACD,SAAS;EACT,CAAC,CAEH;;;;ACpBF,SAAgB,EAAoB,GAAmB,GAAwC;CAC9F,IAAM,EAAE,mBAAgB,aAAU;AAsGlC,CApGA,EAAO,KACN,iBACA,yEACA;EACC,OAAO,EAAE,QAAQ,CAAC,SAAS,eAAe;EAC1C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,cAAc;EACzE,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAEpD,UAAO,EAAY,EAClB,OAFa,EAAM,OAAO,EAAK,OAAO,EAAK,OAAO,EAE3C,CAAM,KAAK,OAAqB;IACtC,IAAI,EAAE;IACN,OAAO,EAAE;IACT,MAAM,EAAE;IACR,MAAM,EAAE;IACR,YAAY,EAAE;IACd,OAAO,EAAE;IACT,YAAY,EAAE;IACd,UAAU,EAAE;IACZ,EAAE,EACH,CAAC;WACM,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,uBACA,wFACA;EACC,OAAO,EAAE,QAAQ,CAAC,SAAS,eAAe;EAC1C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,cAAc;EACzE,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAEpD,UAAO,EAAY,EAClB,OAFa,EAAM,OAAO,EAAK,OAAO,EAAK,OAAO,EAE3C,CAAM,KAAK,OAAqB;IACtC,IAAI,EAAE;IACN,MAAM,EAAE;IACR,OAAO,EAAE;IACT,OAAO,EAAE;IACT,YAAY,EAAE;IACd,YAAY,EAAE;IACd,UAAU,EAAE;IACZ,EAAE,EACH,CAAC;WACM,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,kBACA,2DACA;EACC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,eAAe;EACrD,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,iCAAiC;EAC7F,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC,SAAS,cAAc;EAC1E,sBAAsB,EAAE,SAAS,CAAC,QAAQ,GAAM,CAAC,SAAS,iCAAiC;EAC3F,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAIpD,UAAO,EAHQ,EAAM,QAAQ,EAAK,SAAS,MAAM,EAAK,OAAO,MAAM,EAAK,OAAO,GAAS,EACvF,oBAAoB,EAAK,sBACzB,CACkB,CAAO;WAClB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,iBACA,yCACA;EACC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,SAAS,cAAc;EAC1E,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAEpD,UAAO,EAAY,EAAE,OADP,EAAM,OAAO,EAAK,OAAO,EAClB,EAAO,CAAC;WACrB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,eACA,qFACA;EACC,SAAS,EAAE,QAAQ,CAAC,SAAS,oCAAoC;EACjE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,uBAAuB;EAClF,SAAS,EACP,SAAS,CACT,UAAU,CACV,SACA,wKACA;EACF,sBAAsB,EACpB,QAAQ,CACR,KAAK,CACL,IAAI,EAAE,CACN,IAAI,GAAG,CACP,UAAU,CACV,SAAS,qEAAqE;EAChF,kBAAkB,EAChB,KAAK;GAAC;GAAO;GAAW;GAAM,CAAC,CAC/B,UAAU,CACV,SACA,wKACA;EACF,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC,EAC9C,IACL,EAAK,WAAW,EAAK,wBAAwB,QAAQ,EAAK,oBAAoB,OAC3E;IACA,SAAS,EAAK,YAAY,EAAK,wBAAwB,OAAc,KAAA,IAAP;IAC9D,oBAAoB,EAAK;IACzB,iBAAiB,EAAK;IACtB,GACA,KAAA;AAQJ,UAAO,EAAY,MAPE,EAAM,qBAC1B,EAAK,SACL,EAAK,SAAS,KAAA,GACd,MACA,GACA,EACA,CACyB;WAClB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE;;;;ACxJF,SAAgB,EAAsB,GAAmB,GAAwC;CAChG,IAAM,EAAE,mBAAgB,aAAU;AA6BlC,CA3BA,EAAO,KACN,mBACA,6EACA;EACC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,8BAA8B;EACpE,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,mBAAmB;EACnE,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,sBAAsB;EAChF,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,qBAAqB;EAC9E,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAQpD,UAAO,EAAY,EAAE,OAPP,EAAM,SACnB,EAAK,SAAS,MACd,EAAK,aAAa,MAClB,EAAK,cACL,EAAK,aACL,EAEoB,EAAO,CAAC;WACrB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,iBACA,2DACA;EACC,KAAK,EACH,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CACxC,IAAI,IAAI,CACR,SAAS,uBAAuB;EAClC,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,wBAAwB;EAClF,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,uBAAuB;EAChF,sBAAsB,EAAE,SAAS,CAAC,QAAQ,GAAM,CAAC,SAAS,mCAAmC;EAC7F,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GAKH,IAAM,IAAU,EAAa,GAD5B,EAAK,YAAY,KAAA,KAAa,CAAC,EAAK,QAAQ,MAAM,GAAG,OAAO,GAAgB,CACrB,EAClD,IAAkB,GAAS,WAAW,MACtC,EAAE,SAAS,GAAY,SAAS,MAAe,EAAiB,EAAK,IAAI,EACzE,IAAyC,EAAE;AAEjD,GAAI,EAAW,SAAS,KACvB,EAAO,KAAK;IACX,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,CAAC;GAGH,IAAM,IAA4B,EAAE,EAC9B,IAAmC,EAAE,EACrC,IAAkC,EAAE,EACpC,IAAgC,EAAE,EAClC,IAAsC,EAAE,EACxC,oBAAe,IAAI,KAAa,EAChC,oBAAkB,IAAI,KAA4B;AAExD,QAAK,IAAM,KAAY,GAAY;IAClC,IAAM,IAAO,EAAM,IAAI,EAAS;AAChC,QAAI,CAAC,GAAM,QAAQ;AAClB,OAAgB,KAAK,EAAS;AAC9B;;IAGD,IAAM,IAAY,EAAK;AACvB,QAAI,KAAmB,IAAY,GAAG;AACrC,SAAI,CAAC,EAAgB,IAAI,EAAU,EAAE;MACpC,IAAM,IAAM,EAAM,GAChB,QAAQ,oDAAoD,CAC5D,IAAI,EAAU;AAChB,QAAgB,IAAI,GAAW,OAAO,GAAK,WAAY,WAAW,EAAI,UAAU,KAAK;;AAEtF,SAAI,CAAC,EAAqB,GAAiB,EAAgB,IAAI,EAAU,IAAI,KAAK,EAAE;AACnF,QAAuB,KAAK,EAAS;AACrC;;eAES,KAAmB,KAAa,GAAG;AAC7C,OAAuB,KAAK,EAAS;AACrC;;IAGD,IAAM,IAAW,EAAM,SACtB,MACA,GACA,EAAK,cACL,EAAK,aACL,EACA,EACK,IAAS,EAAS,MAAM,MAAiB,EAAa,OAAO,EAAS;AAC5E,QAAI,CAAC,GAAQ;AACZ,OAAsB,KAAK,EAAS;AACpC;;AAGD,MAAQ,KAAK,EAAO;AACpB,SAAK,IAAM,KAAgB,GAAU;KACpC,IAAM,IAAa,EAAa;AAC5B,UAAc,KAAK,EAAa,IAAI,EAAW,KACnD,EAAa,IAAI,EAAW,EAC5B,EAAc,KAAK,EAAa;;;AAoBlC,GAhBI,EAAgB,SAAS,KAC5B,EAAO,KAAK;IACX,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,CAAC,EAEC,EAAuB,SAAS,KACnC,EAAO,KAAK;IACX,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,CAAC,EAEC,EAAsB,SAAS,KAClC,EAAO,KAAK;IACX,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,CAAC;GAGH,IAAI,IAAqC,EAAE;AAC3C,OAAI,EAAK,sBAAsB;IAC9B,IAAM,oBAAkB,IAAI,KAAa,EACnC,IAA2B,EAAE;AACnC,SAAK,IAAM,KAAQ,CAAC,GAAG,GAAS,GAAG,EAAc,CAChD,CAAI,EAAK,KAAK,KAAK,CAAC,EAAgB,IAAI,EAAK,GAAG,KAC/C,EAAgB,IAAI,EAAK,GAAG,EAC5B,EAAe,KAAK,EAAK,GAAG;AAG9B,QAAe,EAAc,GAAO,GAAgB,EAAQ;;AAG7D,UAAO,EAAY;IAClB;IACA,UAAU;IACV;IACA,aAAa,EAAW,QACtB,MACA,EAAgB,SAAS,EAAS,IAClC,EAAuB,SAAS,EAAS,IACzC,EAAsB,SAAS,EAAS,CACzC;IACD;IACA,UAAU;KACT,SAAS;KACT,qBAAqB,EAAW;KAChC,uBAAuB,EAAQ;KAC/B,gBAAgB,EAAc;KAC9B,sBAAsB,EAAK;KAC3B;IACD,CAAC;WACM,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE;;;;ACjLF,SAAgB,EACf,GACA,IAAmC,EAAE,EACzB;CACZ,IAAM,IAAS,IAAI,EAAU;EAAE,MAAM;EAAW,SAAS;EAAS,CAAC,EAC7D,IAAmC;EACxC;EAGA,sBACK,EAAQ,wBAA8B,EAAQ,uBAAuB,GACrE,EAAQ,mBAAmB,KAAA,IACxB,GAAuB,GADmB,EAAQ;EAG1D,kBACC,EAAQ,eAAe,KAAA,IAAkC,QAAQ,IAAI,mBAAmB,OAArD,EAAQ;EAC5C;AAQD,QANA,EAAoB,GAAQ,EAAQ,EACpC,EAAsB,GAAQ,EAAQ,EACtC,EAAkB,GAAQ,EAAQ,EAClC,EAAoB,EAAO,EAC3B,EAAmB,EAAO,EAEnB"}

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+import { type MemoryStore } from "@codemem/core";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CodememMcpServerOptions } from "./tool-context.js";
+export declare function createCodememMcpServer(store: MemoryStore, options?: CodememMcpServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,uBAAuB,EAA2B,MAAM,mBAAmB,CAAC;AAO1F,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,uBAA4B,GACnC,SAAS,CAsBX"}

package/dist/stdio.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @codemem/mcp — MCP stdio server bootstrap.
+ *
+ * Runs as a separate process spawned by the host (OpenCode/Claude).
+ * Owns its own better-sqlite3 connection. Communicates via stdio JSON-RPC.
+ */
+export {};
+//# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}