@agentmemory/agentmemory 0.9.17 → 0.9.19

package/plugin/scripts/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/plugin/scripts/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/plugin/skills/commit-context/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: commit-context
+description: Trace a file, function, or line back to the agent session that produced its current commit. Use when the user asks "why is this code here", "what was the agent doing when this changed", or wants context on a specific location in the codebase.
+argument-hint: "[file, function, or line]"
+user-invocable: true
+---
+
+The user wants commit context for: $ARGUMENTS
+
+Run `git blame` (or `git log -L`) on the target file, function, or line in $ARGUMENTS to extract the most recent commit SHA that touched it. Use `git blame -L <start>,<end> <file>` when a line range is given, `git log -L :<function>:<file>` when a function name is given, and `git log -n 1 -- <file>` when only a path is given.
+
+With the SHA in hand, look up the linked agent session via the `memory_commit_lookup` MCP tool with `sha: "<full-sha>"`. If the MCP tool is unavailable, fall back to HTTP: `GET $AGENTMEMORY_URL/agentmemory/session/by-commit?sha=<sha>` with `Authorization: Bearer $AGENTMEMORY_SECRET` when the secret is set.
+
+Present the result as:
+- The commit SHA, short SHA, branch, author, message
+- The linked session(s): id, project, started/ended timestamps, observation count, summary if any
+- A short list of the most important observations from that session (importance >= 7) when available via `memory_recall`
+
+Do not fabricate intent. If the commit has no linked session, say so plainly and surface only what `git show` reveals. If `memory_commit_lookup` returns an empty `commit: null` body, that means the commit predates session linking — do not invent a session.

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

@@ -0,0 +1,20 @@
+---
+name: commit-history
+description: List recent git commits that are linked to agent sessions, optionally filtered by branch or repo. Use when the user asks "show agent commits", "what has the agent shipped", or wants a list of commits with their session context.
+argument-hint: "[branch=... repo=... limit=...]"
+user-invocable: true
+---
+
+The user wants a list of agent-linked commits. Filter args: $ARGUMENTS
+
+Parse `$ARGUMENTS` for optional `branch=<name>`, `repo=<url-or-fragment>`, and `limit=<n>` tokens. A bare numeric token becomes the limit. Defaults: no branch filter, no repo filter, limit 100, max 500.
+
+Call the `memory_commits` MCP tool with the parsed filters. If the MCP tool is unavailable, fall back to HTTP: build `GET $AGENTMEMORY_URL/agentmemory/commits` and append each filter as a URL-encoded query parameter (use `URLSearchParams` or `encodeURIComponent` on `branch`, `repo`, and `limit`) so values containing `?`, `&`, or `#` cannot corrupt the request. Include `Authorization: Bearer $AGENTMEMORY_SECRET` when set.
+
+Render the result as a reverse-chronological list:
+- Short SHA, branch, authored timestamp
+- Commit message first line
+- Linked session id(s) (first 8 chars each) and observation counts where present
+- File count when `files` is provided
+
+If the result is empty, tell the user the filter matched no commits and suggest dropping the branch/repo filter. Do not invent commits.

package/plugin/skills/handoff/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: handoff
+description: Resume the most recent agent session for the current working directory. Use when the user says "where were we", "resume", "handoff", "pick up where I left off", or starts a session with no fresh context.
+argument-hint: "[optional cwd override]"
+user-invocable: true
+---
+
+The user wants to resume work. Optional cwd override: $ARGUMENTS
+
+Determine the current project path: if `$ARGUMENTS` is provided, resolve it to an absolute, normalized path (accept relative inputs, e.g. `path.resolve(process.cwd(), $ARGUMENTS)`); otherwise use the current working directory.
+
+Call the `memory_sessions` MCP tool. From the result, pick the most recent session whose normalized `cwd` matches the project path with a directory-boundary check — equality OR `session.cwd.startsWith(projectPath + path.sep)` OR `projectPath.startsWith(session.cwd + path.sep)`. Do NOT use a raw string prefix match: it produces false positives across unrelated repos that share a path prefix (e.g. `/repo-a` vs `/repo-a-staging`). Prefer sessions with status `completed` over `abandoned`. If nothing matches, fall back to the single most recent session overall.
+
+Once a session is selected:
+1. If the session ended on an unanswered user-facing question, surface that question FIRST as the lead. Look for it in `summary` or in the last few observations (type `conversation` with `narrative` ending in `?`).
+2. Then summarize the session: title/summary, key files touched, key decisions or errors. Use `memory_recall` with a query derived from the session's top concepts to fetch supporting observations, limit 10.
+3. End with a short "next step?" pointer the user can act on.
+
+If neither MCP tool is available, fall back to HTTP: `GET $AGENTMEMORY_URL/agentmemory/sessions` and `POST $AGENTMEMORY_URL/agentmemory/recall` with `Authorization: Bearer $AGENTMEMORY_SECRET` when set.
+
+Do not invent observations. If the most recent session has zero observations, say so and offer to start fresh.

package/plugin/skills/recap/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: recap
+description: Summarize the last N agent sessions for the current project, grouped by date. Use when the user asks "recap", "what have we been doing", "this week", "today", or wants a rollup of recent work.
+argument-hint: "[last N | today | this week]"
+user-invocable: true
+---
+
+The user wants a recap. Time window args: $ARGUMENTS
+
+Parse `$ARGUMENTS` to determine the window:
+- `today` -> sessions started on the current local date
+- `this week` -> sessions started in the last 7 days
+- `last <n>` -> the most recent N sessions
+- bare numeric -> treat as `last <n>`
+- empty -> default to `last 10`
+
+Call the `memory_sessions` MCP tool, then filter to the current project (match by `cwd` against the working directory). Apply the time window. Sort by `startedAt` descending.
+
+Group the surviving sessions by their local calendar date (YYYY-MM-DD). For each date:
+- List each session: id (first 8 chars), title or first prompt, observation count, status
+- Indent two or three highlight observations per session (importance >= 7) drawn from `memory_recall` with a per-session query, limit 3
+
+End with a one-line total: "N sessions across M days, K observations."
+
+If MCP tools are unavailable, fall back to HTTP: `GET $AGENTMEMORY_URL/agentmemory/sessions` and `POST $AGENTMEMORY_URL/agentmemory/recall` with `Authorization: Bearer $AGENTMEMORY_SECRET` when set. Do not invent sessions; if the window is empty, say so.