@agentmemory/agentmemory 0.9.18 → 0.9.20

package/dist/hooks/post-commit.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/hooks/post-commit.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+//#region src/hooks/post-commit.ts
+const exec = promisify(execFile);
+function isSdkChildContext(payload) {
+	if (process.env["AGENTMEMORY_SDK_CHILD"] === "1") return true;
+	if (!payload || typeof payload !== "object") return false;
+	return payload.entrypoint === "sdk-ts";
+}
+const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
+const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
+const TIMEOUT_MS = 1500;
+function authHeaders() {
+	const h = { "Content-Type": "application/json" };
+	if (SECRET) h["Authorization"] = `Bearer ${SECRET}`;
+	return h;
+}
+async function git(args, cwd) {
+	try {
+		const { stdout } = await exec("git", args, {
+			cwd,
+			timeout: 1500
+		});
+		return stdout.trim();
+	} catch {
+		return null;
+	}
+}
+async function main() {
+	let input = "";
+	for await (const chunk of process.stdin) input += chunk;
+	let data = {};
+	if (input.trim()) try {
+		data = JSON.parse(input);
+	} catch {}
+	if (isSdkChildContext(data)) return;
+	const cwd = data.cwd || process.env["AGENTMEMORY_CWD"] || process.cwd();
+	const sessionId = data.session_id || process.env["AGENTMEMORY_SESSION_ID"] || void 0;
+	const sha = process.env["AGENTMEMORY_COMMIT_SHA"] || await git(["rev-parse", "HEAD"], cwd);
+	if (!sha) return;
+	const branch = await git([
+		"rev-parse",
+		"--abbrev-ref",
+		"HEAD"
+	], cwd);
+	const repo = await git([
+		"config",
+		"--get",
+		"remote.origin.url"
+	], cwd);
+	const message = await git([
+		"log",
+		"-1",
+		"--pretty=%B",
+		sha
+	], cwd);
+	const author = await git([
+		"log",
+		"-1",
+		"--pretty=%an <%ae>",
+		sha
+	], cwd);
+	const authoredAt = await git([
+		"log",
+		"-1",
+		"--pretty=%aI",
+		sha
+	], cwd);
+	const filesRaw = await git([
+		"diff-tree",
+		"--no-commit-id",
+		"--name-only",
+		"-r",
+		sha
+	], cwd);
+	const files = filesRaw ? filesRaw.split("\n").filter(Boolean) : void 0;
+	const body = {
+		sessionId,
+		sha,
+		branch: branch || void 0,
+		repo: repo || void 0,
+		message: message || void 0,
+		author: author || void 0,
+		authoredAt: authoredAt || void 0,
+		files
+	};
+	try {
+		await fetch(`${REST_URL}/agentmemory/session/commit`, {
+			method: "POST",
+			headers: authHeaders(),
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(TIMEOUT_MS)
+		});
+	} catch {}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=post-commit.mjs.map

package/dist/hooks/post-commit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-commit.mjs","names":[],"sources":["../../src/hooks/post-commit.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\n\nconst exec = promisify(execFile);\n\nfunction isSdkChildContext(payload: unknown): boolean {\n  if (process.env[\"AGENTMEMORY_SDK_CHILD\"] === \"1\") return true;\n  if (!payload || typeof payload !== \"object\") return false;\n  return (payload as { entrypoint?: unknown }).entrypoint === \"sdk-ts\";\n}\n\nconst REST_URL = process.env[\"AGENTMEMORY_URL\"] || \"http://localhost:3111\";\nconst SECRET = process.env[\"AGENTMEMORY_SECRET\"] || \"\";\nconst TIMEOUT_MS = 1500;\n\nfunction authHeaders(): Record<string, string> {\n  const h: Record<string, string> = { \"Content-Type\": \"application/json\" };\n  if (SECRET) h[\"Authorization\"] = `Bearer ${SECRET}`;\n  return h;\n}\n\nasync function git(args: string[], cwd: string): Promise<string | null> {\n  try {\n    const { stdout } = await exec(\"git\", args, { cwd, timeout: 1500 });\n    return stdout.trim();\n  } catch {\n    return null;\n  }\n}\n\nasync function main() {\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown> = {};\n  if (input.trim()) {\n    try {\n      data = JSON.parse(input);\n    } catch {\n      // Direct invocation from .git/hooks/post-commit may pass no stdin.\n    }\n  }\n\n  if (isSdkChildContext(data)) return;\n\n  const cwd =\n    (data.cwd as string) ||\n    process.env[\"AGENTMEMORY_CWD\"] ||\n    process.cwd();\n  const sessionId =\n    (data.session_id as string) ||\n    process.env[\"AGENTMEMORY_SESSION_ID\"] ||\n    undefined;\n\n  const sha =\n    process.env[\"AGENTMEMORY_COMMIT_SHA\"] ||\n    (await git([\"rev-parse\", \"HEAD\"], cwd));\n  if (!sha) return;\n\n  const branch = await git([\"rev-parse\", \"--abbrev-ref\", \"HEAD\"], cwd);\n  const repo = await git([\"config\", \"--get\", \"remote.origin.url\"], cwd);\n  const message = await git([\"log\", \"-1\", \"--pretty=%B\", sha], cwd);\n  const author = await git([\"log\", \"-1\", \"--pretty=%an <%ae>\", sha], cwd);\n  const authoredAt = await git([\"log\", \"-1\", \"--pretty=%aI\", sha], cwd);\n  const filesRaw = await git(\n    [\"diff-tree\", \"--no-commit-id\", \"--name-only\", \"-r\", sha],\n    cwd,\n  );\n  const files = filesRaw ? filesRaw.split(\"\\n\").filter(Boolean) : undefined;\n\n  const body = {\n    sessionId,\n    sha,\n    branch: branch || undefined,\n    repo: repo || undefined,\n    message: message || undefined,\n    author: author || undefined,\n    authoredAt: authoredAt || undefined,\n    files,\n  };\n\n  try {\n    await fetch(`${REST_URL}/agentmemory/session/commit`, {\n      method: \"POST\",\n      headers: authHeaders(),\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(TIMEOUT_MS),\n    });\n  } catch {\n    // best-effort\n  }\n}\n\nmain();\n"],"mappings":";;;;;AAKA,MAAM,OAAO,UAAU,SAAS;AAEhC,SAAS,kBAAkB,SAA2B;AACpD,KAAI,QAAQ,IAAI,6BAA6B,IAAK,QAAO;AACzD,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AACpD,QAAQ,QAAqC,eAAe;;AAG9D,MAAM,WAAW,QAAQ,IAAI,sBAAsB;AACnD,MAAM,SAAS,QAAQ,IAAI,yBAAyB;AACpD,MAAM,aAAa;AAEnB,SAAS,cAAsC;CAC7C,MAAM,IAA4B,EAAE,gBAAgB,oBAAoB;AACxE,KAAI,OAAQ,GAAE,mBAAmB,UAAU;AAC3C,QAAO;;AAGT,eAAe,IAAI,MAAgB,KAAqC;AACtE,KAAI;EACF,MAAM,EAAE,WAAW,MAAM,KAAK,OAAO,MAAM;GAAE;GAAK,SAAS;GAAM,CAAC;AAClE,SAAO,OAAO,MAAM;SACd;AACN,SAAO;;;AAIX,eAAe,OAAO;CACpB,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI,OAAgC,EAAE;AACtC,KAAI,MAAM,MAAM,CACd,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AAKV,KAAI,kBAAkB,KAAK,CAAE;CAE7B,MAAM,MACH,KAAK,OACN,QAAQ,IAAI,sBACZ,QAAQ,KAAK;CACf,MAAM,YACH,KAAK,cACN,QAAQ,IAAI,6BACZ;CAEF,MAAM,MACJ,QAAQ,IAAI,6BACX,MAAM,IAAI,CAAC,aAAa,OAAO,EAAE,IAAI;AACxC,KAAI,CAAC,IAAK;CAEV,MAAM,SAAS,MAAM,IAAI;EAAC;EAAa;EAAgB;EAAO,EAAE,IAAI;CACpE,MAAM,OAAO,MAAM,IAAI;EAAC;EAAU;EAAS;EAAoB,EAAE,IAAI;CACrE,MAAM,UAAU,MAAM,IAAI;EAAC;EAAO;EAAM;EAAe;EAAI,EAAE,IAAI;CACjE,MAAM,SAAS,MAAM,IAAI;EAAC;EAAO;EAAM;EAAsB;EAAI,EAAE,IAAI;CACvE,MAAM,aAAa,MAAM,IAAI;EAAC;EAAO;EAAM;EAAgB;EAAI,EAAE,IAAI;CACrE,MAAM,WAAW,MAAM,IACrB;EAAC;EAAa;EAAkB;EAAe;EAAM;EAAI,EACzD,IACD;CACD,MAAM,QAAQ,WAAW,SAAS,MAAM,KAAK,CAAC,OAAO,QAAQ,GAAG;CAEhE,MAAM,OAAO;EACX;EACA;EACA,QAAQ,UAAU;EAClB,MAAM,QAAQ;EACd,SAAS,WAAW;EACpB,QAAQ,UAAU;EAClB,YAAY,cAAc;EAC1B;EACD;AAED,KAAI;AACF,QAAM,MAAM,GAAG,SAAS,8BAA8B;GACpD,QAAQ;GACR,SAAS,aAAa;GACtB,MAAM,KAAK,UAAU,KAAK;GAC1B,QAAQ,YAAY,QAAQ,WAAW;GACxC,CAAC;SACI;;AAKV,MAAM"}

package/dist/index.mjs

@@ -418,11 +418,63 @@ var NoopProvider = class {
 	}
 };
 
+//#endregion
+//#region src/providers/_openai-shared.ts
+const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com";
+const DEFAULT_AZURE_API_VERSION = "2024-08-01-preview";
+function detectAzure(baseUrl) {
+	try {
+		return new URL(baseUrl).hostname.endsWith(".openai.azure.com");
+	} catch {
+		return false;
+	}
+}
+function azureStyleOf(baseUrl) {
+	try {
+		const u = new URL(baseUrl);
+		if (/\/openai\/deployments\//.test(u.pathname)) return "legacy";
+		return "v1";
+	} catch {
+		return "v1";
+	}
+}
+function legacyAzureUrl(baseUrl, path, apiVersion) {
+	const url = new URL(baseUrl);
+	url.pathname = `${url.pathname.replace(/\/+$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+	url.searchParams.set("api-version", apiVersion);
+	return url.toString();
+}
+function v1AzureUrl(baseUrl, path) {
+	const url = new URL(baseUrl);
+	const route = path.startsWith("/") ? path.slice(1) : path;
+	url.pathname = `${url.pathname.replace(/\/?openai(?:\/v1)?\/?$/, "").replace(/\/+$/, "")}/openai/v1/${route}`;
+	return url.toString();
+}
+function buildChatUrl(baseUrl, isAzure, azureApiVersion) {
+	if (isAzure) return azureStyleOf(baseUrl) === "legacy" ? legacyAzureUrl(baseUrl, "/chat/completions", azureApiVersion) : v1AzureUrl(baseUrl, "/chat/completions");
+	return `${baseUrl}/v1/chat/completions`;
+}
+function buildEmbeddingUrl(baseUrl, isAzure, azureApiVersion) {
+	if (isAzure) return azureStyleOf(baseUrl) === "legacy" ? legacyAzureUrl(baseUrl, "/embeddings", azureApiVersion) : v1AzureUrl(baseUrl, "/embeddings");
+	return `${baseUrl}/v1/embeddings`;
+}
+function buildAuthHeaders(apiKey, isAzure) {
+	if (isAzure) return {
+		"Content-Type": "application/json",
+		"api-key": apiKey
+	};
+	return {
+		"Content-Type": "application/json",
+		Authorization: `Bearer ${apiKey}`
+	};
+}
+function normalizeBaseUrl(raw) {
+	return (raw || DEFAULT_OPENAI_BASE_URL).replace(/\/+$/, "");
+}
+
 //#endregion
 //#region src/providers/openai.ts
-const DEFAULT_BASE_URL$1 = "https://api.openai.com";
 const DEFAULT_TIMEOUT_MS = 6e4;
-const DEFAULT_AZURE_API_VERSION = "2024-08-01-preview";
 /**
 * OpenAI-compatible LLM provider.
 *
@@ -469,7 +521,7 @@ var OpenAIProvider = class {
 		this.apiKey = apiKey;
 		this.model = model;
 		this.maxTokens = maxTokens;
-		this.baseUrl = (baseURL || getEnvVar("OPENAI_BASE_URL") || DEFAULT_BASE_URL$1).replace(/\/+$/, "");
+		this.baseUrl = normalizeBaseUrl(baseURL || getEnvVar("OPENAI_BASE_URL"));
 		this.reasoningEffort = getEnvVar("OPENAI_REASONING_EFFORT") || void 0;
 		this.timeoutMs = resolveTimeout();
 		this.azureApiVersion = getEnvVar("OPENAI_API_VERSION") || DEFAULT_AZURE_API_VERSION;
@@ -481,25 +533,8 @@ var OpenAIProvider = class {
 	async summarize(systemPrompt, userPrompt) {
 		return this.call(systemPrompt, userPrompt);
 	}
-	buildUrl() {
-		if (this.isAzure) {
-			const sep = this.baseUrl.includes("?") ? "&" : "?";
-			return `${this.baseUrl}/chat/completions${sep}api-version=${encodeURIComponent(this.azureApiVersion)}`;
-		}
-		return `${this.baseUrl}/v1/chat/completions`;
-	}
-	buildHeaders() {
-		if (this.isAzure) return {
-			"Content-Type": "application/json",
-			"api-key": this.apiKey
-		};
-		return {
-			"Content-Type": "application/json",
-			Authorization: `Bearer ${this.apiKey}`
-		};
-	}
 	async call(systemPrompt, userPrompt) {
-		const url = this.buildUrl();
+		const url = buildChatUrl(this.baseUrl, this.isAzure, this.azureApiVersion);
 		const body = {
 			model: this.model,
 			max_tokens: this.maxTokens,
@@ -516,7 +551,7 @@ var OpenAIProvider = class {
 		try {
 			response = await fetchWithTimeout(url, {
 				method: "POST",
-				headers: this.buildHeaders(),
+				headers: buildAuthHeaders(this.apiKey, this.isAzure),
 				body: JSON.stringify(body)
 			}, this.timeoutMs);
 		} catch (err) {
@@ -550,13 +585,6 @@ function parsePositiveInt(raw) {
 	const n = Number(trimmed);
 	return Number.isFinite(n) && n > 0 ? n : void 0;
 }
-function detectAzure(baseUrl) {
-	try {
-		return new URL(baseUrl).hostname.endsWith(".openai.azure.com");
-	} catch {
-		return false;
-	}
-}
 
 //#endregion
 //#region src/providers/openrouter.ts
@@ -786,7 +814,6 @@ function l2Normalize(vec) {
 
 //#endregion
 //#region src/providers/embedding/openai.ts
-const DEFAULT_BASE_URL = "https://api.openai.com";
 const DEFAULT_MODEL$1 = "text-embedding-3-small";
 /**
 * Known OpenAI embedding model dimensions. Extend as new models ship.
@@ -810,11 +837,20 @@ function resolveDimensions(model, override) {
 /**
 * OpenAI-compatible embedding provider.
 *
+* Shares transport (URL builder, auth header, Azure detection) with
+* the OpenAI LLM provider via `_openai-shared` (#371). Same env knobs
+* pick up automatically: when `OPENAI_BASE_URL` points at an Azure
+* resource (`.openai.azure.com` hostname) the embedding request uses
+* Azure's `/embeddings` path with the `api-version` query param and
+* `api-key` header instead of `Authorization: Bearer`.
+*
 * Required env vars:
 *   OPENAI_API_KEY            — API key
 *
 * Optional:
-*   OPENAI_BASE_URL           — base URL without path (default: https://api.openai.com)
+*   OPENAI_BASE_URL           — base URL without path (default: https://api.openai.com).
+*                               Azure: https://<resource>.openai.azure.com/openai/deployments/<deployment>
+*   OPENAI_API_VERSION        — Azure api-version query param (default: 2024-08-01-preview)
 *   OPENAI_EMBEDDING_MODEL    — model name (default: text-embedding-3-small)
 *   OPENAI_EMBEDDING_DIMENSIONS — override reported dimensions (required for
 *                                 custom / self-hosted models not in the
@@ -826,24 +862,25 @@ var OpenAIEmbeddingProvider = class {
 	apiKey;
 	baseUrl;
 	model;
+	isAzure;
+	azureApiVersion;
 	constructor(apiKey) {
 		this.apiKey = apiKey || getEnvVar("OPENAI_API_KEY") || "";
 		if (!this.apiKey) throw new Error("OPENAI_API_KEY is required");
-		this.baseUrl = getEnvVar("OPENAI_BASE_URL") || DEFAULT_BASE_URL;
+		this.baseUrl = normalizeBaseUrl(getEnvVar("OPENAI_BASE_URL"));
 		this.model = getEnvVar("OPENAI_EMBEDDING_MODEL") || DEFAULT_MODEL$1;
 		this.dimensions = resolveDimensions(this.model, getEnvVar("OPENAI_EMBEDDING_DIMENSIONS"));
+		this.isAzure = detectAzure(this.baseUrl);
+		this.azureApiVersion = getEnvVar("OPENAI_API_VERSION") || DEFAULT_AZURE_API_VERSION;
 	}
 	async embed(text) {
 		const [result] = await this.embedBatch([text]);
 		return result;
 	}
 	async embedBatch(texts) {
-		const response = await fetchWithTimeout(`${this.baseUrl}/v1/embeddings`, {
+		const response = await fetchWithTimeout(buildEmbeddingUrl(this.baseUrl, this.isAzure, this.azureApiVersion), {
 			method: "POST",
-			headers: {
-				Authorization: `Bearer ${this.apiKey}`,
-				"Content-Type": "application/json"
-			},
+			headers: buildAuthHeaders(this.apiKey, this.isAzure),
 			body: JSON.stringify({
 				model: this.model,
 				input: texts
@@ -1250,7 +1287,8 @@ const KV = {
 	imageEmbeddings: "mem:image-embeddings",
 	slots: "mem:slots",
 	globalSlots: "mem:slots:global",
-	state: "mem:state"
+	state: "mem:state",
+	commits: "mem:commits"
 };
 const STREAM = {
 	name: "mem-live",
@@ -1444,7 +1482,7 @@ var GraphRetrieval = class {
 		const results = [];
 		const visitedObs = /* @__PURE__ */ new Set();
 		for (const startNode of matchingNodes) {
-			const paths = this.bfsTraversal(startNode, allNodes, allEdges, maxDepth);
+			const paths = this.dijkstraTraversal(startNode, allNodes, allEdges, maxDepth);
 			for (const path of paths) {
 				const lastNode = path[path.length - 1].node;
 				for (const obsId of lastNode.sourceObservationIds) {
@@ -1484,7 +1522,7 @@ var GraphRetrieval = class {
 		const results = [];
 		const visitedObs = new Set(obsIds);
 		for (const node of linkedNodes) {
-			const paths = this.bfsTraversal(node, allNodes, allEdges, maxDepth);
+			const paths = this.dijkstraTraversal(node, allNodes, allEdges, maxDepth);
 			for (const path of paths) {
 				const lastNode = path[path.length - 1].node;
 				for (const obsId of lastNode.sourceObservationIds) {
@@ -1556,37 +1594,104 @@ var GraphRetrieval = class {
 		}
 		return latest;
 	}
-	bfsTraversal(startNode, allNodes, allEdges, maxDepth) {
-		const paths = [];
-		const visited = /* @__PURE__ */ new Set();
-		const queue = [{
+	dijkstraTraversal(startNode, allNodes, allEdges, maxDepth) {
+		const nodeIndex = /* @__PURE__ */ new Map();
+		for (const n of allNodes) nodeIndex.set(n.id, n);
+		const adjacency = /* @__PURE__ */ new Map();
+		for (const edge of allEdges) {
+			const a = edge.sourceNodeId;
+			const b = edge.targetNodeId;
+			if (!adjacency.has(a)) adjacency.set(a, []);
+			if (!adjacency.has(b)) adjacency.set(b, []);
+			adjacency.get(a).push({
+				neighborId: b,
+				edge
+			});
+			adjacency.get(b).push({
+				neighborId: a,
+				edge
+			});
+		}
+		const dist = /* @__PURE__ */ new Map();
+		const pathTo = /* @__PURE__ */ new Map();
+		dist.set(startNode.id, 0);
+		pathTo.set(startNode.id, [{ node: startNode }]);
+		const heap = new MinHeap((a, b) => a.cost - b.cost);
+		heap.push({
 			nodeId: startNode.id,
 			depth: 0,
-			path: [{ node: startNode }]
-		}];
-		visited.add(startNode.id);
-		while (queue.length > 0) {
-			const { nodeId, depth, path } = queue.shift();
-			paths.push(path);
+			cost: 0
+		});
+		while (heap.size() > 0) {
+			const { nodeId, depth, cost } = heap.pop();
+			if (cost > (dist.get(nodeId) ?? Infinity)) continue;
 			if (depth >= maxDepth) continue;
-			const neighborEdges = allEdges.filter((e) => e.sourceNodeId === nodeId || e.targetNodeId === nodeId);
-			for (const edge of neighborEdges) {
-				const nextId = edge.sourceNodeId === nodeId ? edge.targetNodeId : edge.sourceNodeId;
-				if (visited.has(nextId)) continue;
-				visited.add(nextId);
-				const nextNode = allNodes.find((n) => n.id === nextId);
+			const neighbors = adjacency.get(nodeId) ?? [];
+			for (const { neighborId, edge } of neighbors) {
+				const nextNode = nodeIndex.get(neighborId);
 				if (!nextNode) continue;
-				queue.push({
-					nodeId: nextId,
-					depth: depth + 1,
-					path: [...path, {
+				const newCost = cost + 1 / Math.max(edge.weight, .01);
+				if (newCost < (dist.get(neighborId) ?? Infinity)) {
+					dist.set(neighborId, newCost);
+					pathTo.set(neighborId, [...pathTo.get(nodeId), {
 						node: nextNode,
 						edge
-					}]
-				});
+					}]);
+					heap.push({
+						nodeId: neighborId,
+						depth: depth + 1,
+						cost: newCost
+					});
+				}
 			}
 		}
-		return paths;
+		pathTo.delete(startNode.id);
+		return Array.from(pathTo.values());
+	}
+};
+var MinHeap = class {
+	heap = [];
+	constructor(compare) {
+		this.compare = compare;
+	}
+	size() {
+		return this.heap.length;
+	}
+	push(value) {
+		this.heap.push(value);
+		this.bubbleUp(this.heap.length - 1);
+	}
+	pop() {
+		if (this.heap.length === 0) return void 0;
+		const top = this.heap[0];
+		const last = this.heap.pop();
+		if (this.heap.length > 0) {
+			this.heap[0] = last;
+			this.sinkDown(0);
+		}
+		return top;
+	}
+	bubbleUp(i) {
+		while (i > 0) {
+			const parent = i - 1 >> 1;
+			if (this.compare(this.heap[i], this.heap[parent]) < 0) {
+				[this.heap[i], this.heap[parent]] = [this.heap[parent], this.heap[i]];
+				i = parent;
+			} else break;
+		}
+	}
+	sinkDown(i) {
+		const n = this.heap.length;
+		while (true) {
+			const left = 2 * i + 1;
+			const right = 2 * i + 2;
+			let smallest = i;
+			if (left < n && this.compare(this.heap[left], this.heap[smallest]) < 0) smallest = left;
+			if (right < n && this.compare(this.heap[right], this.heap[smallest]) < 0) smallest = right;
+			if (smallest === i) break;
+			[this.heap[i], this.heap[smallest]] = [this.heap[smallest], this.heap[i]];
+			i = smallest;
+		}
 	}
 };
 
@@ -6212,7 +6317,7 @@ function registerAutoForgetFunction(sdk, kv) {
 
 //#endregion
 //#region src/version.ts
-const VERSION = "0.9.18";
+const VERSION = "0.9.20";
 
 //#endregion
 //#region src/functions/export-import.ts
@@ -6348,7 +6453,9 @@ function registerExportImportFunction(sdk, kv) {
 			"0.9.15",
 			"0.9.16",
 			"0.9.17",
-			"0.9.18"
+			"0.9.18",
+			"0.9.19",
+			"0.9.20"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -14176,6 +14283,112 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			middleware_function_ids: ["middleware::api-auth"]
 		}
 	});
+	sdk.registerFunction("api::session::commit", async (req) => {
+		const body = req.body ?? {};
+		const sha = asNonEmptyString$1(body.sha);
+		if (!sha) return {
+			status_code: 400,
+			body: { error: "sha is required and must be a non-empty string" }
+		};
+		const sessionId = asNonEmptyString$1(body.sessionId) ?? void 0;
+		const branch = asNonEmptyString$1(body.branch) ?? void 0;
+		const repo = asNonEmptyString$1(body.repo) ?? void 0;
+		const message = asNonEmptyString$1(body.message) ?? void 0;
+		const author = asNonEmptyString$1(body.author) ?? void 0;
+		const authoredAt = asNonEmptyString$1(body.authoredAt) ?? void 0;
+		const files = Array.isArray(body.files) ? body.files.filter((f) => typeof f === "string" && f.length > 0) : void 0;
+		const link = await withKeyedLock(`commit:${sha}`, async () => {
+			const existing = await kv.get(KV.commits, sha);
+			const sessionSet = new Set(existing?.sessionIds ?? []);
+			if (sessionId) sessionSet.add(sessionId);
+			const merged = {
+				sha,
+				shortSha: existing?.shortSha ?? sha.slice(0, 7),
+				branch: branch ?? existing?.branch,
+				repo: repo ?? existing?.repo,
+				message: message ?? existing?.message,
+				author: author ?? existing?.author,
+				authoredAt: authoredAt ?? existing?.authoredAt,
+				files: files ?? existing?.files,
+				sessionIds: Array.from(sessionSet),
+				linkedAt: existing?.linkedAt ?? (/* @__PURE__ */ new Date()).toISOString()
+			};
+			await kv.set(KV.commits, sha, merged);
+			return merged;
+		});
+		if (sessionId) await withKeyedLock(`session:${sessionId}`, async () => {
+			const session = await kv.get(KV.sessions, sessionId);
+			if (!session) return;
+			const shaSet = new Set(session.commitShas ?? []);
+			shaSet.add(sha);
+			session.commitShas = Array.from(shaSet);
+			await kv.set(KV.sessions, sessionId, session);
+		});
+		return {
+			status_code: 200,
+			body: { commit: link }
+		};
+	});
+	sdk.registerTrigger({
+		type: "http",
+		function_id: "api::session::commit",
+		config: {
+			api_path: "/agentmemory/session/commit",
+			http_method: "POST",
+			middleware_function_ids: ["middleware::api-auth"]
+		}
+	});
+	sdk.registerFunction("api::session::by-commit", async (req) => {
+		const authErr = checkAuth(req, secret);
+		if (authErr) return authErr;
+		const sha = asNonEmptyString$1(req.query_params?.["sha"]);
+		if (!sha) return {
+			status_code: 400,
+			body: { error: "sha is required and must be a non-empty string" }
+		};
+		const link = await kv.get(KV.commits, sha);
+		if (!link) return {
+			status_code: 404,
+			body: { error: "no sessions linked to this commit" }
+		};
+		return {
+			status_code: 200,
+			body: {
+				commit: link,
+				sessions: (await Promise.all((link.sessionIds ?? []).map((sid) => kv.get(KV.sessions, sid)))).filter((s) => s !== null)
+			}
+		};
+	});
+	sdk.registerTrigger({
+		type: "http",
+		function_id: "api::session::by-commit",
+		config: {
+			api_path: "/agentmemory/session/by-commit",
+			http_method: "GET",
+			middleware_function_ids: ["middleware::api-auth"]
+		}
+	});
+	sdk.registerFunction("api::commits", async (req) => {
+		const authErr = checkAuth(req, secret);
+		if (authErr) return authErr;
+		const branch = asNonEmptyString$1(req.query_params?.["branch"]);
+		const repo = asNonEmptyString$1(req.query_params?.["repo"]);
+		const rawLimit = parseOptionalInt(req.query_params?.["limit"]);
+		const limit = Math.max(1, Math.min(500, rawLimit ?? 100));
+		return {
+			status_code: 200,
+			body: { commits: (await kv.list(KV.commits)).filter((c) => !branch || c.branch === branch).filter((c) => !repo || c.repo === repo).sort((a, b) => (a.linkedAt ?? "") < (b.linkedAt ?? "") ? 1 : -1).slice(0, limit) }
+		};
+	});
+	sdk.registerTrigger({
+		type: "http",
+		function_id: "api::commits",
+		config: {
+			api_path: "/agentmemory/commits",
+			http_method: "GET",
+			middleware_function_ids: ["middleware::api-auth"]
+		}
+	});
 	sdk.registerFunction("api::sessions", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
@@ -17176,6 +17389,39 @@ const CORE_TOOLS = [
 			},
 			required: ["memoryId"]
 		}
+	},
+	{
+		name: "memory_commit_lookup",
+		description: "Look up the agent session(s) that produced a specific git commit, given its SHA. Returns the commit metadata and linked sessions.",
+		inputSchema: {
+			type: "object",
+			properties: { sha: {
+				type: "string",
+				description: "Full git commit SHA"
+			} },
+			required: ["sha"]
+		}
+	},
+	{
+		name: "memory_commits",
+		description: "List recent commits linked to agent sessions, optionally filtered by branch or repo.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				branch: {
+					type: "string",
+					description: "Filter by branch name"
+				},
+				repo: {
+					type: "string",
+					description: "Filter by remote URL"
+				},
+				limit: {
+					type: "number",
+					description: "Max results (default 100, max 500)"
+				}
+			}
+		}
 	}
 ];
 const V040_TOOLS = [
@@ -19230,6 +19476,49 @@ function registerMcpEndpoints(sdk, kv, secret) {
 						}] }
 					};
 				}
+				case "memory_commit_lookup": {
+					const sha = asNonEmptyString(args.sha);
+					if (!sha) return {
+						status_code: 400,
+						body: { error: "sha required" }
+					};
+					const link = await kv.get(KV.commits, sha);
+					if (!link) return {
+						status_code: 200,
+						body: { content: [{
+							type: "text",
+							text: JSON.stringify({
+								commit: null,
+								sessions: []
+							}, null, 2)
+						}] }
+					};
+					const linkRecord = link;
+					const sessions = (await Promise.all((linkRecord.sessionIds ?? []).map((sid) => kv.get(KV.sessions, sid)))).filter((s) => s !== null);
+					return {
+						status_code: 200,
+						body: { content: [{
+							type: "text",
+							text: JSON.stringify({
+								commit: link,
+								sessions
+							}, null, 2)
+						}] }
+					};
+				}
+				case "memory_commits": {
+					const branch = typeof args.branch === "string" ? args.branch : void 0;
+					const repo = typeof args.repo === "string" ? args.repo : void 0;
+					const limit = Math.max(1, Math.min(500, asNumber(args.limit, 100) ?? 100));
+					const filtered = (await kv.list(KV.commits)).filter((c) => !branch || c.branch === branch).filter((c) => !repo || c.repo === repo).sort((a, b) => (a.linkedAt ?? "") < (b.linkedAt ?? "") ? 1 : -1).slice(0, limit);
+					return {
+						status_code: 200,
+						body: { content: [{
+							type: "text",
+							text: JSON.stringify({ commits: filtered }, null, 2)
+						}] }
+					};
+				}
 				default: return {
 					status_code: 400,
 					body: { error: `Unknown tool: ${name}` }
@@ -20142,7 +20431,7 @@ async function main() {
 		console.warn(`[agentmemory] Failed to backfill memories into BM25:`, err);
 	}
 	bootLog(`Ready. ${embeddingProvider ? "Triple-stream (BM25+Vector+Graph)" : "BM25+Graph"} search active.`);
-	bootLog(`REST API: 121 endpoints at http://localhost:${config.restPort}/agentmemory/*`);
+	bootLog(`REST API: 124 endpoints at http://localhost:${config.restPort}/agentmemory/*`);
 	bootLog(`MCP surface (opt-in via \`npx @agentmemory/mcp\`): ${getAllTools().length} tools · 6 resources · 3 prompts`);
 	const viewerServer = startViewerServer(config.restPort + 2, kv, sdk, secret, config.restPort);
 	const autoForgetIntervalMs = parseInt(process.env.AUTO_FORGET_INTERVAL_MS || "3600000", 10);