@agentmemory/agentmemory 0.9.30 → 0.9.32

package/plugin/scripts/stop.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stop.mjs","names":[],"sources":["../../src/secret-store.ts","../../src/hooks/stop.ts"],"sourcesContent":["import {\n  chmodSync,\n  closeSync,\n  linkSync,\n  mkdirSync,\n  openSync,\n  readFileSync,\n  unlinkSync,\n  writeSync,\n} from \"node:fs\";\nimport { randomBytes } from \"node:crypto\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nconst SECRET_KEY = \"AGENTMEMORY_SECRET\";\n\nexport function agentmemoryHomeDir(): string {\n  return join(homedir(), \".agentmemory\");\n}\n\nexport function secretFilePath(): string {\n  return join(agentmemoryHomeDir(), \"secret\");\n}\n\nfunction usable(value: string | undefined): string {\n  if (typeof value !== \"string\") return \"\";\n  const trimmed = value.trim();\n  if (!trimmed) return \"\";\n  if (trimmed.startsWith(\"${\") && trimmed.endsWith(\"}\")) return \"\";\n  return trimmed;\n}\n\nfunction unquote(value: string): string {\n  const quote = value[0];\n  if ((quote === '\"' || quote === \"'\") && value.length > 1) {\n    const close = value.indexOf(quote, 1);\n    if (close !== -1) return value.slice(1, close);\n  }\n  const hash = value.indexOf(\" #\");\n  return hash === -1 ? value : value.slice(0, hash).trim();\n}\n\nexport function readEnvFileSecret(): string {\n  let content: unknown;\n  try {\n    content = readFileSync(join(agentmemoryHomeDir(), \".env\"), \"utf-8\");\n  } catch {\n    return \"\";\n  }\n  if (typeof content !== \"string\") return \"\";\n  let found = \"\";\n  for (const line of content.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (trimmed.startsWith(\"#\")) continue;\n    const eq = trimmed.indexOf(\"=\");\n    if (eq === -1) continue;\n    const key = trimmed.slice(0, eq).replace(/^export\\s+/, \"\").trim();\n    if (key !== SECRET_KEY) continue;\n    found = usable(unquote(trimmed.slice(eq + 1).trim()));\n  }\n  return found;\n}\n\nexport function readStoredSecret(): string {\n  try {\n    return usable(readFileSync(secretFilePath(), \"utf-8\"));\n  } catch {\n    return \"\";\n  }\n}\n\nexport function explicitSecret(env: NodeJS.ProcessEnv = process.env): string {\n  return usable(env[SECRET_KEY]) || readEnvFileSecret();\n}\n\nexport function isLoopbackUrl(url: string): boolean {\n  let hostname: string;\n  try {\n    hostname = new URL(url).hostname.toLowerCase();\n  } catch {\n    return false;\n  }\n  const bare = hostname.replace(/^\\[|\\]$/g, \"\");\n  return bare === \"localhost\" || bare === \"::1\" || /^127(?:\\.\\d{1,3}){3}$/.test(bare);\n}\n\nexport function resolveClientSecret(\n  baseUrl: string,\n  env: NodeJS.ProcessEnv = process.env,\n): string {\n  const fromEnv = usable(env[SECRET_KEY]);\n  if (fromEnv) return fromEnv;\n  if (!isLoopbackUrl(baseUrl)) return \"\";\n  return readEnvFileSecret() || readStoredSecret();\n}\n\nexport function ensureServerSecret(env: NodeJS.ProcessEnv = process.env): {\n  secret: string;\n  source: \"env\" | \"file\" | \"generated\";\n} {\n  const configured = explicitSecret(env);\n  if (configured) return { secret: configured, source: \"env\" };\n  const stored = readStoredSecret();\n  if (stored) return { secret: stored, source: \"file\" };\n  const generated = randomBytes(32).toString(\"hex\");\n  const path = secretFilePath();\n  mkdirSync(agentmemoryHomeDir(), { recursive: true, mode: 0o700 });\n  const staging = `${path}.${process.pid}.${randomBytes(4).toString(\"hex\")}.tmp`;\n  const fd = openSync(staging, \"wx\", 0o600);\n  try {\n    writeSync(fd, `${generated}\\n`);\n  } finally {\n    closeSync(fd);\n  }\n  try {\n    chmodSync(staging, 0o600);\n    linkSync(staging, path);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"EEXIST\") throw err;\n    const raced = readStoredSecret();\n    if (!raced) throw err;\n    return { secret: raced, source: \"file\" };\n  } finally {\n    try {\n      unlinkSync(staging);\n    } catch {}\n  }\n  return { secret: generated, source: \"generated\" };\n}\n\nexport function bearerHeaders(\n  baseUrl: string,\n  env: NodeJS.ProcessEnv = process.env,\n): Record<string, string> {\n  const secret = resolveClientSecret(baseUrl, env);\n  return secret ? { Authorization: `Bearer ${secret}` } : {};\n}\n","#!/usr/bin/env node\nimport { resolveClientSecret } from \"../secret-store.js\";\n\n// Inlined — see src/hooks/sdk-guard.ts for canonical version. Kept local\n// per-hook so tsdown does not emit a shared hashed chunk that would churn\n// the diff on every rebuild.\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 = resolveClientSecret(REST_URL);\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 main() {\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(input);\n  } catch {\n    return;\n  }\n\n  if (!data || typeof data !== \"object\") return;\n  if (isSdkChildContext(data)) {\n    // Do not summarize from inside a Claude Agent SDK child session;\n    // would re-enter agent-sdk provider and loop (see sdk-guard.ts).\n    return;\n  }\n\n  const sessionId = ((data.session_id || data.sessionId || data.conversation_id) as string) || \"unknown\";\n\n  fetch(`${REST_URL}/agentmemory/session/end`, {\n    method: \"POST\",\n    headers: authHeaders(),\n    body: JSON.stringify({ sessionId }),\n    signal: AbortSignal.timeout(5000),\n  }).catch(() => {});\n\n  setTimeout(() => process.exit(0), 1500).unref();\n}\n\nmain().catch(() => process.exit(0));\n"],"mappings":"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"}
+{"version":3,"file":"stop.mjs","names":[],"sources":["../../src/hooks/_project.ts","../../src/hooks/stop.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport { realpathSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\n\n// Resolution order: AGENTMEMORY_PROJECT_NAME env → git repository basename → cwd basename.\nexport function resolveProject(cwd?: string): string {\n  const explicit = process.env[\"AGENTMEMORY_PROJECT_NAME\"];\n  if (explicit && explicit.trim()) return explicit.trim();\n  const dir = cwd && cwd.trim() ? cwd : process.cwd();\n  try {\n    const [top, gitDir, commonDir] = execSync(\n      \"git rev-parse --show-toplevel --git-dir --git-common-dir\",\n      {\n        cwd: dir,\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n        timeout: 500,\n      },\n    )\n      .toString()\n      .trim()\n      .split(/\\r?\\n/);\n    if (top) return basename(repositoryRoot(dir, top, gitDir, commonDir));\n  } catch {}\n  return basename(dir);\n}\n\nfunction repositoryRoot(dir: string, top: string, gitDir?: string, commonDir?: string): string {\n  if (!gitDir || !commonDir) return top;\n  const physical = realpathSync(dir);\n  const common = resolve(physical, commonDir);\n  if (resolve(physical, gitDir) === common || basename(common) !== \".git\") return top;\n  return dirname(common);\n}\n\nexport function hookCwd(data: Record<string, unknown> | null | undefined): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  if (typeof data.cwd === \"string\" && data.cwd.trim()) return data.cwd;\n  const roots = data.workspace_roots;\n  if (Array.isArray(roots)) {\n    for (const root of roots) {\n      if (typeof root === \"string\" && root.trim()) return root;\n    }\n  }\n  const projectDir =\n    process.env[\"DEVIN_PROJECT_DIR\"] || process.env[\"CLAUDE_PROJECT_DIR\"];\n  if (projectDir && projectDir.trim()) return projectDir;\n  return undefined;\n}\n","#!/usr/bin/env node\nimport { resolveProject, hookCwd } from \"./_project.js\";\nimport { REST_URL, authHeaders, captureObservation, isDrainChild, runDrainChild, stripPrivateData, transportBlocked, withEventId } from \"./_capture.js\";\n\n// Inlined — see src/hooks/sdk-guard.ts for canonical version. Kept local\n// per-hook so tsdown does not emit a shared hashed chunk that would churn\n// the diff on every rebuild.\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 OBSERVE_TIMEOUT_MS = 2000;\nconst EXIT_CAP_MS = 3500;\nconst END_CAP_MS = 1500;\nconst REPLY_MAX_CHARS = 4000;\n\nfunction boundReply(reply: string): { text: string; bytes?: number } {\n  const safe = stripPrivateData(reply);\n  if (safe.length <= REPLY_MAX_CHARS) return { text: safe };\n  let head = Math.ceil((REPLY_MAX_CHARS - 1) / 2);\n  let tail = safe.length - (REPLY_MAX_CHARS - 1 - head);\n  if (/[\\uD800-\\uDBFF]/.test(safe[head - 1]!)) head--;\n  if (/[\\uDC00-\\uDFFF]/.test(safe[tail]!)) tail++;\n  return { text: `${safe.slice(0, head)}\\u2026${safe.slice(tail)}`, bytes: Buffer.byteLength(safe, \"utf8\") };\n}\n\nasync function main() {\n  if (isDrainChild()) return runDrainChild();\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(input);\n  } catch {\n    return;\n  }\n\n  if (!data || typeof data !== \"object\") return;\n  if (isSdkChildContext(data)) {\n    // Do not summarize from inside a Claude Agent SDK child session;\n    // would re-enter agent-sdk provider and loop (see sdk-guard.ts).\n    return;\n  }\n\n  const sessionId = ((data.session_id || data.sessionId || data.conversation_id) as string) || \"unknown\";\n  const reply = data.last_assistant_message;\n  if (typeof reply === \"string\" && reply.trim()) {\n    const capture = setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();\n    const cwd = hookCwd(data) || process.cwd();\n    const bounded = boundReply(reply);\n    const body = {\n      hookType: \"stop\",\n      sessionId,\n      project: resolveProject(cwd),\n      cwd,\n      timestamp: new Date().toISOString(),\n      data: {\n        last_assistant_message: bounded.text,\n        ...(bounded.bytes === undefined ? {} : { last_assistant_message_bytes: bounded.bytes }),\n      },\n    };\n    await captureObservation(withEventId(body, {}), OBSERVE_TIMEOUT_MS).catch(() => {});\n    clearTimeout(capture);\n  }\n\n  setTimeout(() => process.exit(0), END_CAP_MS).unref();\n  if (transportBlocked()) return;\n  fetch(`${REST_URL}/agentmemory/session/end`, {\n    method: \"POST\",\n    headers: authHeaders(),\n    body: JSON.stringify({ sessionId, final: false }),\n    signal: AbortSignal.timeout(5000),\n  }).catch(() => {});\n}\n\nmain().catch(() => process.exit(0));\n"],"mappings":"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"}

package/plugin/scripts/subagent-start.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { execSync } from "node:child_process";
-import { basename } from "node:path";
+import { realpathSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
 import { captureObservation, isDrainChild, runDrainChild, withEventId } from "./_capture.mjs";
 //#region src/hooks/_project.ts
 function resolveProject(cwd) {
@@ -8,7 +9,7 @@ function resolveProject(cwd) {
 	if (explicit && explicit.trim()) return explicit.trim();
 	const dir = cwd && cwd.trim() ? cwd : process.cwd();
 	try {
-		const top = execSync("git rev-parse --show-toplevel", {
+		const [top, gitDir, commonDir] = execSync("git rev-parse --show-toplevel --git-dir --git-common-dir", {
 			cwd: dir,
 			stdio: [
 				"ignore",
@@ -16,11 +17,18 @@ function resolveProject(cwd) {
 				"ignore"
 			],
 			timeout: 500
-		}).toString().trim();
-		if (top) return basename(top);
+		}).toString().trim().split(/\r?\n/);
+		if (top) return basename(repositoryRoot(dir, top, gitDir, commonDir));
 	} catch {}
 	return basename(dir);
 }
+function repositoryRoot(dir, top, gitDir, commonDir) {
+	if (!gitDir || !commonDir) return top;
+	const physical = realpathSync(dir);
+	const common = resolve(physical, commonDir);
+	if (resolve(physical, gitDir) === common || basename(common) !== ".git") return top;
+	return dirname(common);
+}
 function hookCwd(data) {
 	if (!data || typeof data !== "object") return void 0;
 	if (typeof data.cwd === "string" && data.cwd.trim()) return data.cwd;
@@ -66,7 +74,7 @@ async function main() {
 			agent_id: agentId,
 			agent_type: agentType
 		}
-	}, data), OBSERVE_TIMEOUT_MS);
+	}, {}, void 0, { stable: Boolean(data.agent_id) }), OBSERVE_TIMEOUT_MS);
 	setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();
 }
 main().catch(() => process.exit(0));

package/plugin/scripts/subagent-start.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-start.mjs","names":[],"sources":["../../src/hooks/_project.ts","../../src/hooks/subagent-start.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport { basename } from \"node:path\";\n\n// Resolution order: AGENTMEMORY_PROJECT_NAME env → git toplevel basename → cwd basename.\nexport function resolveProject(cwd?: string): string {\n  const explicit = process.env[\"AGENTMEMORY_PROJECT_NAME\"];\n  if (explicit && explicit.trim()) return explicit.trim();\n  const dir = cwd && cwd.trim() ? cwd : process.cwd();\n  try {\n    const top = execSync(\"git rev-parse --show-toplevel\", {\n      cwd: dir,\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n      timeout: 500,\n    })\n      .toString()\n      .trim();\n    if (top) return basename(top);\n  } catch {}\n  return basename(dir);\n}\n\nexport function hookCwd(data: Record<string, unknown> | null | undefined): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  if (typeof data.cwd === \"string\" && data.cwd.trim()) return data.cwd;\n  const roots = data.workspace_roots;\n  if (Array.isArray(roots)) {\n    for (const root of roots) {\n      if (typeof root === \"string\" && root.trim()) return root;\n    }\n  }\n  const projectDir =\n    process.env[\"DEVIN_PROJECT_DIR\"] || process.env[\"CLAUDE_PROJECT_DIR\"];\n  if (projectDir && projectDir.trim()) return projectDir;\n  return undefined;\n}\n","#!/usr/bin/env node\nimport { resolveProject, hookCwd } from \"./_project.js\";\nimport { captureObservation, isDrainChild, runDrainChild, withEventId } from \"./_capture.js\";\n\n// Inlined from ./sdk-guard so each hook bundles to a single self-contained\n// .mjs (matches the pattern used by every other hook entry in tsdown.config).\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 OBSERVE_TIMEOUT_MS = 800;\nconst EXIT_CAP_MS = 1300;\n\nasync function main() {\n  if (isDrainChild()) return runDrainChild();\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(input);\n  } catch {\n    return;\n  }\n\n  if (!data || typeof data !== \"object\") return;\n  if (isSdkChildContext(data)) return;\n\n  const sessionId = ((data.session_id || data.sessionId || data.conversation_id) as string) || \"unknown\";\n  const agentId = data.agent_id || data.agentName;\n  const agentType = data.agent_type || data.agentDisplayName || data.agentName;\n\n  const cwd = hookCwd(data) || process.cwd();\n\n  void captureObservation(\n    withEventId(\n      {\n        hookType: \"subagent_start\",\n        sessionId,\n        project: resolveProject(cwd),\n        cwd,\n        timestamp: new Date().toISOString(),\n        data: {\n          agent_id: agentId,\n          agent_type: agentType,\n        },\n      },\n      data,\n    ),\n    OBSERVE_TIMEOUT_MS,\n  );\n  setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();\n}\n\nmain().catch(() => process.exit(0));\n"],"mappings":";;;;;AAIA,SAAgB,eAAe,KAAsB;CACnD,MAAM,WAAW,QAAQ,IAAI;AAC7B,KAAI,YAAY,SAAS,MAAM,CAAE,QAAO,SAAS,MAAM;CACvD,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,MAAM,QAAQ,KAAK;AACnD,KAAI;EACF,MAAM,MAAM,SAAS,iCAAiC;GACpD,KAAK;GACL,OAAO;IAAC;IAAU;IAAQ;IAAS;GACnC,SAAS;GACV,CAAC,CACC,UAAU,CACV,MAAM;AACT,MAAI,IAAK,QAAO,SAAS,IAAI;SACvB;AACR,QAAO,SAAS,IAAI;;AAGtB,SAAgB,QAAQ,MAAsE;AAC5F,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,KAAA;AAC9C,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,KAAK;CACjE,MAAM,QAAQ,KAAK;AACnB,KAAI,MAAM,QAAQ,MAAM;OACjB,MAAM,QAAQ,MACjB,KAAI,OAAO,SAAS,YAAY,KAAK,MAAM,CAAE,QAAO;;CAGxD,MAAM,aACJ,QAAQ,IAAI,wBAAwB,QAAQ,IAAI;AAClD,KAAI,cAAc,WAAW,MAAM,CAAE,QAAO;;;;AC1B9C,SAAS,kBAAkB,SAA2B;AACpD,KAAI,QAAQ,IAAI,6BAA6B,IAAK,QAAO;AACzD,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AACpD,QAAQ,QAAqC,eAAe;;AAG9D,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AAEpB,eAAe,OAAO;AACpB,KAAI,cAAc,CAAE,QAAO,eAAe;CAC1C,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;AAGF,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AACvC,KAAI,kBAAkB,KAAK,CAAE;CAE7B,MAAM,YAAc,KAAK,cAAc,KAAK,aAAa,KAAK,mBAA+B;CAC7F,MAAM,UAAU,KAAK,YAAY,KAAK;CACtC,MAAM,YAAY,KAAK,cAAc,KAAK,oBAAoB,KAAK;CAEnE,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,KAAK;AAErC,oBACH,YACE;EACE,UAAU;EACV;EACA,SAAS,eAAe,IAAI;EAC5B;EACA,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,MAAM;GACJ,UAAU;GACV,YAAY;GACb;EACF,EACD,KACD,EACD,mBACD;AACD,kBAAiB,QAAQ,KAAK,EAAE,EAAE,YAAY,CAAC,OAAO;;AAGxD,MAAM,CAAC,YAAY,QAAQ,KAAK,EAAE,CAAC"}
+{"version":3,"file":"subagent-start.mjs","names":[],"sources":["../../src/hooks/_project.ts","../../src/hooks/subagent-start.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport { realpathSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\n\n// Resolution order: AGENTMEMORY_PROJECT_NAME env → git repository basename → cwd basename.\nexport function resolveProject(cwd?: string): string {\n  const explicit = process.env[\"AGENTMEMORY_PROJECT_NAME\"];\n  if (explicit && explicit.trim()) return explicit.trim();\n  const dir = cwd && cwd.trim() ? cwd : process.cwd();\n  try {\n    const [top, gitDir, commonDir] = execSync(\n      \"git rev-parse --show-toplevel --git-dir --git-common-dir\",\n      {\n        cwd: dir,\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n        timeout: 500,\n      },\n    )\n      .toString()\n      .trim()\n      .split(/\\r?\\n/);\n    if (top) return basename(repositoryRoot(dir, top, gitDir, commonDir));\n  } catch {}\n  return basename(dir);\n}\n\nfunction repositoryRoot(dir: string, top: string, gitDir?: string, commonDir?: string): string {\n  if (!gitDir || !commonDir) return top;\n  const physical = realpathSync(dir);\n  const common = resolve(physical, commonDir);\n  if (resolve(physical, gitDir) === common || basename(common) !== \".git\") return top;\n  return dirname(common);\n}\n\nexport function hookCwd(data: Record<string, unknown> | null | undefined): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  if (typeof data.cwd === \"string\" && data.cwd.trim()) return data.cwd;\n  const roots = data.workspace_roots;\n  if (Array.isArray(roots)) {\n    for (const root of roots) {\n      if (typeof root === \"string\" && root.trim()) return root;\n    }\n  }\n  const projectDir =\n    process.env[\"DEVIN_PROJECT_DIR\"] || process.env[\"CLAUDE_PROJECT_DIR\"];\n  if (projectDir && projectDir.trim()) return projectDir;\n  return undefined;\n}\n","#!/usr/bin/env node\nimport { resolveProject, hookCwd } from \"./_project.js\";\nimport { captureObservation, isDrainChild, runDrainChild, withEventId } from \"./_capture.js\";\n\n// Inlined from ./sdk-guard so each hook bundles to a single self-contained\n// .mjs (matches the pattern used by every other hook entry in tsdown.config).\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 OBSERVE_TIMEOUT_MS = 800;\nconst EXIT_CAP_MS = 1300;\n\nasync function main() {\n  if (isDrainChild()) return runDrainChild();\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(input);\n  } catch {\n    return;\n  }\n\n  if (!data || typeof data !== \"object\") return;\n  if (isSdkChildContext(data)) return;\n\n  const sessionId = ((data.session_id || data.sessionId || data.conversation_id) as string) || \"unknown\";\n  const agentId = data.agent_id || data.agentName;\n  const agentType = data.agent_type || data.agentDisplayName || data.agentName;\n\n  const cwd = hookCwd(data) || process.cwd();\n\n  void captureObservation(\n    withEventId(\n      {\n        hookType: \"subagent_start\",\n        sessionId,\n        project: resolveProject(cwd),\n        cwd,\n        timestamp: new Date().toISOString(),\n        data: {\n          agent_id: agentId,\n          agent_type: agentType,\n        },\n      },\n      {},\n      undefined,\n      { stable: Boolean(data.agent_id) },\n    ),\n    OBSERVE_TIMEOUT_MS,\n  );\n  setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();\n}\n\nmain().catch(() => process.exit(0));\n"],"mappings":";;;;;;AAKA,SAAgB,eAAe,KAAsB;CACnD,MAAM,WAAW,QAAQ,IAAI;AAC7B,KAAI,YAAY,SAAS,MAAM,CAAE,QAAO,SAAS,MAAM;CACvD,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,MAAM,QAAQ,KAAK;AACnD,KAAI;EACF,MAAM,CAAC,KAAK,QAAQ,aAAa,SAC/B,4DACA;GACE,KAAK;GACL,OAAO;IAAC;IAAU;IAAQ;IAAS;GACnC,SAAS;GACV,CACF,CACE,UAAU,CACV,MAAM,CACN,MAAM,QAAQ;AACjB,MAAI,IAAK,QAAO,SAAS,eAAe,KAAK,KAAK,QAAQ,UAAU,CAAC;SAC/D;AACR,QAAO,SAAS,IAAI;;AAGtB,SAAS,eAAe,KAAa,KAAa,QAAiB,WAA4B;AAC7F,KAAI,CAAC,UAAU,CAAC,UAAW,QAAO;CAClC,MAAM,WAAW,aAAa,IAAI;CAClC,MAAM,SAAS,QAAQ,UAAU,UAAU;AAC3C,KAAI,QAAQ,UAAU,OAAO,KAAK,UAAU,SAAS,OAAO,KAAK,OAAQ,QAAO;AAChF,QAAO,QAAQ,OAAO;;AAGxB,SAAgB,QAAQ,MAAsE;AAC5F,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,KAAA;AAC9C,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,KAAK;CACjE,MAAM,QAAQ,KAAK;AACnB,KAAI,MAAM,QAAQ,MAAM;OACjB,MAAM,QAAQ,MACjB,KAAI,OAAO,SAAS,YAAY,KAAK,MAAM,CAAE,QAAO;;CAGxD,MAAM,aACJ,QAAQ,IAAI,wBAAwB,QAAQ,IAAI;AAClD,KAAI,cAAc,WAAW,MAAM,CAAE,QAAO;;;;ACvC9C,SAAS,kBAAkB,SAA2B;AACpD,KAAI,QAAQ,IAAI,6BAA6B,IAAK,QAAO;AACzD,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AACpD,QAAQ,QAAqC,eAAe;;AAG9D,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AAEpB,eAAe,OAAO;AACpB,KAAI,cAAc,CAAE,QAAO,eAAe;CAC1C,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;AAGF,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AACvC,KAAI,kBAAkB,KAAK,CAAE;CAE7B,MAAM,YAAc,KAAK,cAAc,KAAK,aAAa,KAAK,mBAA+B;CAC7F,MAAM,UAAU,KAAK,YAAY,KAAK;CACtC,MAAM,YAAY,KAAK,cAAc,KAAK,oBAAoB,KAAK;CAEnE,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,KAAK;AAErC,oBACH,YACE;EACE,UAAU;EACV;EACA,SAAS,eAAe,IAAI;EAC5B;EACA,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,MAAM;GACJ,UAAU;GACV,YAAY;GACb;EACF,EACD,EAAE,EACF,KAAA,GACA,EAAE,QAAQ,QAAQ,KAAK,SAAS,EAAE,CACnC,EACD,mBACD;AACD,kBAAiB,QAAQ,KAAK,EAAE,EAAE,YAAY,CAAC,OAAO;;AAGxD,MAAM,CAAC,YAAY,QAAQ,KAAK,EAAE,CAAC"}

package/plugin/scripts/subagent-stop.mjs

@@ -1,14 +1,22 @@
 #!/usr/bin/env node
 import { execSync } from "node:child_process";
-import { basename } from "node:path";
-import { captureObservation, isDrainChild, runDrainChild, withEventId } from "./_capture.mjs";
+import { realpathSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
+import { captureObservation, isDrainChild, runDrainChild, stripPrivateData, withEventId } from "./_capture.mjs";
+//#region src/hooks/_capture-filter.ts
+function truncateText(value, max) {
+	if (value.length <= max) return value;
+	const end = /[\uD800-\uDBFF]/.test(value[max - 1] ?? "") ? max - 1 : max;
+	return value.slice(0, end);
+}
+//#endregion
 //#region src/hooks/_project.ts
 function resolveProject(cwd) {
 	const explicit = process.env["AGENTMEMORY_PROJECT_NAME"];
 	if (explicit && explicit.trim()) return explicit.trim();
 	const dir = cwd && cwd.trim() ? cwd : process.cwd();
 	try {
-		const top = execSync("git rev-parse --show-toplevel", {
+		const [top, gitDir, commonDir] = execSync("git rev-parse --show-toplevel --git-dir --git-common-dir", {
 			cwd: dir,
 			stdio: [
 				"ignore",
@@ -16,11 +24,18 @@ function resolveProject(cwd) {
 				"ignore"
 			],
 			timeout: 500
-		}).toString().trim();
-		if (top) return basename(top);
+		}).toString().trim().split(/\r?\n/);
+		if (top) return basename(repositoryRoot(dir, top, gitDir, commonDir));
 	} catch {}
 	return basename(dir);
 }
+function repositoryRoot(dir, top, gitDir, commonDir) {
+	if (!gitDir || !commonDir) return top;
+	const physical = realpathSync(dir);
+	const common = resolve(physical, commonDir);
+	if (resolve(physical, gitDir) === common || basename(common) !== ".git") return top;
+	return dirname(common);
+}
 function hookCwd(data) {
 	if (!data || typeof data !== "object") return void 0;
 	if (typeof data.cwd === "string" && data.cwd.trim()) return data.cwd;
@@ -53,11 +68,13 @@ async function main() {
 	if (!data || typeof data !== "object") return;
 	if (isSdkChildContext(data)) return;
 	const sessionId = data.session_id || data.sessionId || data.conversation_id || "unknown";
-	const agentId = data.agent_id || data.agentName;
-	const agentType = data.agent_type || data.agentDisplayName || data.agentName;
-	const lastMsg = typeof data.last_assistant_message === "string" ? data.last_assistant_message.slice(0, 4e3) : "";
+	const agentId = data.agent_id || data.agentId || data.agentName;
+	const agentType = data.agent_type || data.agentType || data.agentDisplayName || data.agentName;
+	const reply = data.last_assistant_message ?? data.response;
+	const redactedReply = typeof reply === "string" ? stripPrivateData(reply) : "";
+	const lastMsg = truncateText(redactedReply, 4e3);
 	const cwd = hookCwd(data) || process.cwd();
-	captureObservation(withEventId({
+	const body = {
 		hookType: "subagent_stop",
 		sessionId,
 		project: resolveProject(cwd),
@@ -68,7 +85,12 @@ async function main() {
 			agent_type: agentType,
 			last_message: lastMsg
 		}
-	}, data), OBSERVE_TIMEOUT_MS);
+	};
+	captureObservation(withEventId(body, {}, {
+		...body.data,
+		last_message: redactedReply,
+		stop_hook_active: data.stop_hook_active === true
+	}, { stable: Boolean(data.agent_id || data.agentId) }), OBSERVE_TIMEOUT_MS);
 	setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();
 }
 main().catch(() => process.exit(0));

package/plugin/scripts/subagent-stop.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-stop.mjs","names":[],"sources":["../../src/hooks/_project.ts","../../src/hooks/subagent-stop.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport { basename } from \"node:path\";\n\n// Resolution order: AGENTMEMORY_PROJECT_NAME env → git toplevel basename → cwd basename.\nexport function resolveProject(cwd?: string): string {\n  const explicit = process.env[\"AGENTMEMORY_PROJECT_NAME\"];\n  if (explicit && explicit.trim()) return explicit.trim();\n  const dir = cwd && cwd.trim() ? cwd : process.cwd();\n  try {\n    const top = execSync(\"git rev-parse --show-toplevel\", {\n      cwd: dir,\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n      timeout: 500,\n    })\n      .toString()\n      .trim();\n    if (top) return basename(top);\n  } catch {}\n  return basename(dir);\n}\n\nexport function hookCwd(data: Record<string, unknown> | null | undefined): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  if (typeof data.cwd === \"string\" && data.cwd.trim()) return data.cwd;\n  const roots = data.workspace_roots;\n  if (Array.isArray(roots)) {\n    for (const root of roots) {\n      if (typeof root === \"string\" && root.trim()) return root;\n    }\n  }\n  const projectDir =\n    process.env[\"DEVIN_PROJECT_DIR\"] || process.env[\"CLAUDE_PROJECT_DIR\"];\n  if (projectDir && projectDir.trim()) return projectDir;\n  return undefined;\n}\n","#!/usr/bin/env node\nimport { resolveProject, hookCwd } from \"./_project.js\";\nimport { captureObservation, isDrainChild, runDrainChild, withEventId } from \"./_capture.js\";\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 OBSERVE_TIMEOUT_MS = 2000;\nconst EXIT_CAP_MS = 2500;\n\nasync function main() {\n  if (isDrainChild()) return runDrainChild();\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(input);\n  } catch {\n    return;\n  }\n\n  if (!data || typeof data !== \"object\") return;\n  if (isSdkChildContext(data)) return;\n\n  const sessionId = ((data.session_id || data.sessionId || data.conversation_id) as string) || \"unknown\";\n  const agentId = data.agent_id || data.agentName;\n  const agentType = data.agent_type || data.agentDisplayName || data.agentName;\n  const lastMsg =\n    typeof data.last_assistant_message === \"string\"\n      ? data.last_assistant_message.slice(0, 4000)\n      : \"\";\n\n  const cwd = hookCwd(data) || process.cwd();\n\n  void captureObservation(\n    withEventId(\n      {\n        hookType: \"subagent_stop\",\n        sessionId,\n        project: resolveProject(cwd),\n        cwd,\n        timestamp: new Date().toISOString(),\n        data: {\n          agent_id: agentId,\n          agent_type: agentType,\n          last_message: lastMsg,\n        },\n      },\n      data,\n    ),\n    OBSERVE_TIMEOUT_MS,\n  );\n  setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();\n}\n\nmain().catch(() => process.exit(0));\n"],"mappings":";;;;;AAIA,SAAgB,eAAe,KAAsB;CACnD,MAAM,WAAW,QAAQ,IAAI;AAC7B,KAAI,YAAY,SAAS,MAAM,CAAE,QAAO,SAAS,MAAM;CACvD,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,MAAM,QAAQ,KAAK;AACnD,KAAI;EACF,MAAM,MAAM,SAAS,iCAAiC;GACpD,KAAK;GACL,OAAO;IAAC;IAAU;IAAQ;IAAS;GACnC,SAAS;GACV,CAAC,CACC,UAAU,CACV,MAAM;AACT,MAAI,IAAK,QAAO,SAAS,IAAI;SACvB;AACR,QAAO,SAAS,IAAI;;AAGtB,SAAgB,QAAQ,MAAsE;AAC5F,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,KAAA;AAC9C,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,KAAK;CACjE,MAAM,QAAQ,KAAK;AACnB,KAAI,MAAM,QAAQ,MAAM;OACjB,MAAM,QAAQ,MACjB,KAAI,OAAO,SAAS,YAAY,KAAK,MAAM,CAAE,QAAO;;CAGxD,MAAM,aACJ,QAAQ,IAAI,wBAAwB,QAAQ,IAAI;AAClD,KAAI,cAAc,WAAW,MAAM,CAAE,QAAO;;;;AC5B9C,SAAS,kBAAkB,SAA2B;AACpD,KAAI,QAAQ,IAAI,6BAA6B,IAAK,QAAO;AACzD,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AACpD,QAAQ,QAAqC,eAAe;;AAG9D,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AAEpB,eAAe,OAAO;AACpB,KAAI,cAAc,CAAE,QAAO,eAAe;CAC1C,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;AAGF,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AACvC,KAAI,kBAAkB,KAAK,CAAE;CAE7B,MAAM,YAAc,KAAK,cAAc,KAAK,aAAa,KAAK,mBAA+B;CAC7F,MAAM,UAAU,KAAK,YAAY,KAAK;CACtC,MAAM,YAAY,KAAK,cAAc,KAAK,oBAAoB,KAAK;CACnE,MAAM,UACJ,OAAO,KAAK,2BAA2B,WACnC,KAAK,uBAAuB,MAAM,GAAG,IAAK,GAC1C;CAEN,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,KAAK;AAErC,oBACH,YACE;EACE,UAAU;EACV;EACA,SAAS,eAAe,IAAI;EAC5B;EACA,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,MAAM;GACJ,UAAU;GACV,YAAY;GACZ,cAAc;GACf;EACF,EACD,KACD,EACD,mBACD;AACD,kBAAiB,QAAQ,KAAK,EAAE,EAAE,YAAY,CAAC,OAAO;;AAGxD,MAAM,CAAC,YAAY,QAAQ,KAAK,EAAE,CAAC"}
+{"version":3,"file":"subagent-stop.mjs","names":[],"sources":["../../src/hooks/_capture-filter.ts","../../src/hooks/_project.ts","../../src/hooks/subagent-stop.ts"],"sourcesContent":["const DEFAULT_DENY_PATTERNS = [\n  \"memory_*\",\n  \"toolsearch\",\n  \"listmcpresources\",\n  \"fetchmcpresource\",\n];\n\nfunction parseEnvList(raw: string | undefined): string[] | undefined {\n  if (!raw?.trim()) return undefined;\n  return raw\n    .split(/[,\\s]+/)\n    .map((part) => part.trim())\n    .filter(Boolean);\n}\n\nexport function bareToolName(toolName: string): string {\n  const trimmed = toolName.trim();\n  if (/^mcp__/i.test(trimmed)) {\n    const parts = trimmed.split(\"__\");\n    if (parts.length >= 3) return parts[parts.length - 1]!;\n  }\n  return trimmed;\n}\n\nfunction normalizePattern(pattern: string): string {\n  return pattern.trim().toLowerCase();\n}\n\nfunction matchesPattern(toolName: string, pattern: string): boolean {\n  const bare = bareToolName(toolName).toLowerCase();\n  const full = toolName.trim().toLowerCase();\n  const pat = normalizePattern(pattern);\n  if (!pat.includes(\"*\")) return bare === pat || full === pat;\n  const escaped = pat.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  const re = new RegExp(`^${escaped.replace(/\\*/g, \".*\")}$`);\n  return re.test(bare) || re.test(full);\n}\n\nfunction matchesAny(toolName: string, patterns: string[]): boolean {\n  return patterns.some((pattern) => matchesPattern(toolName, pattern));\n}\n\nexport function shouldCaptureTool(toolName: unknown): boolean {\n  if (typeof toolName !== \"string\" || !toolName.trim()) return true;\n\n  const allow = parseEnvList(process.env[\"AGENTMEMORY_CAPTURE_ALLOW\"]);\n  if (allow) return matchesAny(toolName, allow);\n\n  const deny = [\n    ...DEFAULT_DENY_PATTERNS,\n    ...(parseEnvList(process.env[\"AGENTMEMORY_CAPTURE_DENY\"]) ?? []),\n  ];\n  return !matchesAny(toolName, deny);\n}\n\nexport function captureOutputMax(): number {\n  const raw = process.env[\"AGENTMEMORY_CAPTURE_OUTPUT_MAX\"];\n  if (!raw?.trim()) return 8000;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 8000;\n}\n\nexport function truncateText(value: string, max: number): string {\n  if (value.length <= max) return value;\n  const end = /[\\uD800-\\uDBFF]/.test(value[max - 1] ?? \"\") ? max - 1 : max;\n  return value.slice(0, end);\n}\n\nexport function truncateCaptureOutput(value: unknown, max: number): unknown {\n  if (typeof value === \"string\" && value.length > max) {\n    const suffix = \"\\n[...truncated]\";\n    return max <= suffix.length\n      ? suffix.slice(0, max)\n      : truncateText(value, max - suffix.length) + suffix;\n  }\n  if (typeof value === \"object\" && value !== null) {\n    const str = JSON.stringify(value);\n    if (str.length > max) {\n      const suffix = \"...[truncated]\";\n      return max <= suffix.length\n        ? suffix.slice(0, max)\n        : truncateText(str, max - suffix.length) + suffix;\n    }\n    return value;\n  }\n  return value;\n}\n\nexport function preCompactBudget(): number {\n  const raw = process.env[\"AGENTMEMORY_PRE_COMPACT_BUDGET\"];\n  if (raw?.trim() === \"0\") return 0;\n  if (!raw?.trim()) return 1500;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : 1500;\n}\n","import { execSync } from \"node:child_process\";\nimport { realpathSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\n\n// Resolution order: AGENTMEMORY_PROJECT_NAME env → git repository basename → cwd basename.\nexport function resolveProject(cwd?: string): string {\n  const explicit = process.env[\"AGENTMEMORY_PROJECT_NAME\"];\n  if (explicit && explicit.trim()) return explicit.trim();\n  const dir = cwd && cwd.trim() ? cwd : process.cwd();\n  try {\n    const [top, gitDir, commonDir] = execSync(\n      \"git rev-parse --show-toplevel --git-dir --git-common-dir\",\n      {\n        cwd: dir,\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n        timeout: 500,\n      },\n    )\n      .toString()\n      .trim()\n      .split(/\\r?\\n/);\n    if (top) return basename(repositoryRoot(dir, top, gitDir, commonDir));\n  } catch {}\n  return basename(dir);\n}\n\nfunction repositoryRoot(dir: string, top: string, gitDir?: string, commonDir?: string): string {\n  if (!gitDir || !commonDir) return top;\n  const physical = realpathSync(dir);\n  const common = resolve(physical, commonDir);\n  if (resolve(physical, gitDir) === common || basename(common) !== \".git\") return top;\n  return dirname(common);\n}\n\nexport function hookCwd(data: Record<string, unknown> | null | undefined): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  if (typeof data.cwd === \"string\" && data.cwd.trim()) return data.cwd;\n  const roots = data.workspace_roots;\n  if (Array.isArray(roots)) {\n    for (const root of roots) {\n      if (typeof root === \"string\" && root.trim()) return root;\n    }\n  }\n  const projectDir =\n    process.env[\"DEVIN_PROJECT_DIR\"] || process.env[\"CLAUDE_PROJECT_DIR\"];\n  if (projectDir && projectDir.trim()) return projectDir;\n  return undefined;\n}\n","#!/usr/bin/env node\nimport { truncateText } from \"./_capture-filter.js\";\nimport { resolveProject, hookCwd } from \"./_project.js\";\nimport { captureObservation, isDrainChild, runDrainChild, stripPrivateData, withEventId } from \"./_capture.js\";\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 OBSERVE_TIMEOUT_MS = 2000;\nconst EXIT_CAP_MS = 2500;\n\nasync function main() {\n  if (isDrainChild()) return runDrainChild();\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(input);\n  } catch {\n    return;\n  }\n\n  if (!data || typeof data !== \"object\") return;\n  if (isSdkChildContext(data)) return;\n\n  const sessionId = ((data.session_id || data.sessionId || data.conversation_id) as string) || \"unknown\";\n  const agentId = data.agent_id || data.agentId || data.agentName;\n  const agentType = data.agent_type || data.agentType || data.agentDisplayName || data.agentName;\n  const reply = data.last_assistant_message ?? data.response;\n  const redactedReply = typeof reply === \"string\" ? stripPrivateData(reply) : \"\";\n  const lastMsg = truncateText(redactedReply, 4000);\n\n  const cwd = hookCwd(data) || process.cwd();\n\n  const body = {\n    hookType: \"subagent_stop\",\n    sessionId,\n    project: resolveProject(cwd),\n    cwd,\n    timestamp: new Date().toISOString(),\n    data: {\n      agent_id: agentId,\n      agent_type: agentType,\n      last_message: lastMsg,\n    },\n  };\n  void captureObservation(\n    withEventId(\n      body,\n      {},\n      { ...body.data, last_message: redactedReply, stop_hook_active: data.stop_hook_active === true },\n      { stable: Boolean(data.agent_id || data.agentId) },\n    ),\n    OBSERVE_TIMEOUT_MS,\n  );\n  setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();\n}\n\nmain().catch(() => process.exit(0));\n"],"mappings":";;;;;;AA8DA,SAAgB,aAAa,OAAe,KAAqB;AAC/D,KAAI,MAAM,UAAU,IAAK,QAAO;CAChC,MAAM,MAAM,kBAAkB,KAAK,MAAM,MAAM,MAAM,GAAG,GAAG,MAAM,IAAI;AACrE,QAAO,MAAM,MAAM,GAAG,IAAI;;;;AC5D5B,SAAgB,eAAe,KAAsB;CACnD,MAAM,WAAW,QAAQ,IAAI;AAC7B,KAAI,YAAY,SAAS,MAAM,CAAE,QAAO,SAAS,MAAM;CACvD,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,MAAM,QAAQ,KAAK;AACnD,KAAI;EACF,MAAM,CAAC,KAAK,QAAQ,aAAa,SAC/B,4DACA;GACE,KAAK;GACL,OAAO;IAAC;IAAU;IAAQ;IAAS;GACnC,SAAS;GACV,CACF,CACE,UAAU,CACV,MAAM,CACN,MAAM,QAAQ;AACjB,MAAI,IAAK,QAAO,SAAS,eAAe,KAAK,KAAK,QAAQ,UAAU,CAAC;SAC/D;AACR,QAAO,SAAS,IAAI;;AAGtB,SAAS,eAAe,KAAa,KAAa,QAAiB,WAA4B;AAC7F,KAAI,CAAC,UAAU,CAAC,UAAW,QAAO;CAClC,MAAM,WAAW,aAAa,IAAI;CAClC,MAAM,SAAS,QAAQ,UAAU,UAAU;AAC3C,KAAI,QAAQ,UAAU,OAAO,KAAK,UAAU,SAAS,OAAO,KAAK,OAAQ,QAAO;AAChF,QAAO,QAAQ,OAAO;;AAGxB,SAAgB,QAAQ,MAAsE;AAC5F,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,KAAA;AAC9C,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,KAAK;CACjE,MAAM,QAAQ,KAAK;AACnB,KAAI,MAAM,QAAQ,MAAM;OACjB,MAAM,QAAQ,MACjB,KAAI,OAAO,SAAS,YAAY,KAAK,MAAM,CAAE,QAAO;;CAGxD,MAAM,aACJ,QAAQ,IAAI,wBAAwB,QAAQ,IAAI;AAClD,KAAI,cAAc,WAAW,MAAM,CAAE,QAAO;;;;ACxC9C,SAAS,kBAAkB,SAA2B;AACpD,KAAI,QAAQ,IAAI,6BAA6B,IAAK,QAAO;AACzD,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AACpD,QAAQ,QAAqC,eAAe;;AAG9D,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AAEpB,eAAe,OAAO;AACpB,KAAI,cAAc,CAAE,QAAO,eAAe;CAC1C,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;AAGF,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AACvC,KAAI,kBAAkB,KAAK,CAAE;CAE7B,MAAM,YAAc,KAAK,cAAc,KAAK,aAAa,KAAK,mBAA+B;CAC7F,MAAM,UAAU,KAAK,YAAY,KAAK,WAAW,KAAK;CACtD,MAAM,YAAY,KAAK,cAAc,KAAK,aAAa,KAAK,oBAAoB,KAAK;CACrF,MAAM,QAAQ,KAAK,0BAA0B,KAAK;CAClD,MAAM,gBAAgB,OAAO,UAAU,WAAW,iBAAiB,MAAM,GAAG;CAC5E,MAAM,UAAU,aAAa,eAAe,IAAK;CAEjD,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,KAAK;CAE1C,MAAM,OAAO;EACX,UAAU;EACV;EACA,SAAS,eAAe,IAAI;EAC5B;EACA,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,MAAM;GACJ,UAAU;GACV,YAAY;GACZ,cAAc;GACf;EACF;AACI,oBACH,YACE,MACA,EAAE,EACF;EAAE,GAAG,KAAK;EAAM,cAAc;EAAe,kBAAkB,KAAK,qBAAqB;EAAM,EAC/F,EAAE,QAAQ,QAAQ,KAAK,YAAY,KAAK,QAAQ,EAAE,CACnD,EACD,mBACD;AACD,kBAAiB,QAAQ,KAAK,EAAE,EAAE,YAAY,CAAC,OAAO;;AAGxD,MAAM,CAAC,YAAY,QAAQ,KAAK,EAAE,CAAC"}

package/plugin/scripts/task-completed.mjs

@@ -1,14 +1,22 @@
 #!/usr/bin/env node
 import { execSync } from "node:child_process";
-import { basename } from "node:path";
+import { realpathSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
 import { captureObservation, isDrainChild, runDrainChild, withEventId } from "./_capture.mjs";
+//#region src/hooks/_capture-filter.ts
+function truncateText(value, max) {
+	if (value.length <= max) return value;
+	const end = /[\uD800-\uDBFF]/.test(value[max - 1] ?? "") ? max - 1 : max;
+	return value.slice(0, end);
+}
+//#endregion
 //#region src/hooks/_project.ts
 function resolveProject(cwd) {
 	const explicit = process.env["AGENTMEMORY_PROJECT_NAME"];
 	if (explicit && explicit.trim()) return explicit.trim();
 	const dir = cwd && cwd.trim() ? cwd : process.cwd();
 	try {
-		const top = execSync("git rev-parse --show-toplevel", {
+		const [top, gitDir, commonDir] = execSync("git rev-parse --show-toplevel --git-dir --git-common-dir", {
 			cwd: dir,
 			stdio: [
 				"ignore",
@@ -16,11 +24,18 @@ function resolveProject(cwd) {
 				"ignore"
 			],
 			timeout: 500
-		}).toString().trim();
-		if (top) return basename(top);
+		}).toString().trim().split(/\r?\n/);
+		if (top) return basename(repositoryRoot(dir, top, gitDir, commonDir));
 	} catch {}
 	return basename(dir);
 }
+function repositoryRoot(dir, top, gitDir, commonDir) {
+	if (!gitDir || !commonDir) return top;
+	const physical = realpathSync(dir);
+	const common = resolve(physical, commonDir);
+	if (resolve(physical, gitDir) === common || basename(common) !== ".git") return top;
+	return dirname(common);
+}
 function hookCwd(data) {
 	if (!data || typeof data !== "object") return void 0;
 	if (typeof data.cwd === "string" && data.cwd.trim()) return data.cwd;
@@ -63,11 +78,11 @@ async function main() {
 		data: {
 			task_id: data.task_id,
 			task_subject: data.task_subject,
-			task_description: typeof data.task_description === "string" ? data.task_description.slice(0, 2e3) : "",
+			task_description: typeof data.task_description === "string" ? truncateText(data.task_description, 2e3) : "",
 			teammate_name: data.teammate_name,
 			team_name: data.team_name
 		}
-	}, data), OBSERVE_TIMEOUT_MS);
+	}, {}, void 0, { stable: Boolean(data.task_id) }), OBSERVE_TIMEOUT_MS);
 	setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();
 }
 main().catch(() => process.exit(0));

package/plugin/scripts/task-completed.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"task-completed.mjs","names":[],"sources":["../../src/hooks/_project.ts","../../src/hooks/task-completed.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport { basename } from \"node:path\";\n\n// Resolution order: AGENTMEMORY_PROJECT_NAME env → git toplevel basename → cwd basename.\nexport function resolveProject(cwd?: string): string {\n  const explicit = process.env[\"AGENTMEMORY_PROJECT_NAME\"];\n  if (explicit && explicit.trim()) return explicit.trim();\n  const dir = cwd && cwd.trim() ? cwd : process.cwd();\n  try {\n    const top = execSync(\"git rev-parse --show-toplevel\", {\n      cwd: dir,\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n      timeout: 500,\n    })\n      .toString()\n      .trim();\n    if (top) return basename(top);\n  } catch {}\n  return basename(dir);\n}\n\nexport function hookCwd(data: Record<string, unknown> | null | undefined): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  if (typeof data.cwd === \"string\" && data.cwd.trim()) return data.cwd;\n  const roots = data.workspace_roots;\n  if (Array.isArray(roots)) {\n    for (const root of roots) {\n      if (typeof root === \"string\" && root.trim()) return root;\n    }\n  }\n  const projectDir =\n    process.env[\"DEVIN_PROJECT_DIR\"] || process.env[\"CLAUDE_PROJECT_DIR\"];\n  if (projectDir && projectDir.trim()) return projectDir;\n  return undefined;\n}\n","#!/usr/bin/env node\nimport { resolveProject, hookCwd } from \"./_project.js\";\nimport { captureObservation, isDrainChild, runDrainChild, withEventId } from \"./_capture.js\";\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 OBSERVE_TIMEOUT_MS = 2000;\nconst EXIT_CAP_MS = 2500;\n\nasync function main() {\n  if (isDrainChild()) return runDrainChild();\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(input);\n  } catch {\n    return;\n  }\n\n  if (!data || typeof data !== \"object\") return;\n  if (isSdkChildContext(data)) return;\n\n  const sessionId = ((data.session_id || data.sessionId || data.conversation_id) as string) || \"unknown\";\n\n  const cwd = hookCwd(data) || process.cwd();\n\n  void captureObservation(\n    withEventId(\n      {\n        hookType: \"task_completed\",\n        sessionId,\n        project: resolveProject(cwd),\n        cwd,\n        timestamp: new Date().toISOString(),\n        data: {\n          task_id: data.task_id,\n          task_subject: data.task_subject,\n          task_description: typeof data.task_description === \"string\"\n            ? data.task_description.slice(0, 2000)\n            : \"\",\n          teammate_name: data.teammate_name,\n          team_name: data.team_name,\n        },\n      },\n      data,\n    ),\n    OBSERVE_TIMEOUT_MS,\n  );\n  setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();\n}\n\nmain().catch(() => process.exit(0));\n"],"mappings":";;;;;AAIA,SAAgB,eAAe,KAAsB;CACnD,MAAM,WAAW,QAAQ,IAAI;AAC7B,KAAI,YAAY,SAAS,MAAM,CAAE,QAAO,SAAS,MAAM;CACvD,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,MAAM,QAAQ,KAAK;AACnD,KAAI;EACF,MAAM,MAAM,SAAS,iCAAiC;GACpD,KAAK;GACL,OAAO;IAAC;IAAU;IAAQ;IAAS;GACnC,SAAS;GACV,CAAC,CACC,UAAU,CACV,MAAM;AACT,MAAI,IAAK,QAAO,SAAS,IAAI;SACvB;AACR,QAAO,SAAS,IAAI;;AAGtB,SAAgB,QAAQ,MAAsE;AAC5F,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,KAAA;AAC9C,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,KAAK;CACjE,MAAM,QAAQ,KAAK;AACnB,KAAI,MAAM,QAAQ,MAAM;OACjB,MAAM,QAAQ,MACjB,KAAI,OAAO,SAAS,YAAY,KAAK,MAAM,CAAE,QAAO;;CAGxD,MAAM,aACJ,QAAQ,IAAI,wBAAwB,QAAQ,IAAI;AAClD,KAAI,cAAc,WAAW,MAAM,CAAE,QAAO;;;;AC5B9C,SAAS,kBAAkB,SAA2B;AACpD,KAAI,QAAQ,IAAI,6BAA6B,IAAK,QAAO;AACzD,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AACpD,QAAQ,QAAqC,eAAe;;AAG9D,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AAEpB,eAAe,OAAO;AACpB,KAAI,cAAc,CAAE,QAAO,eAAe;CAC1C,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;AAGF,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AACvC,KAAI,kBAAkB,KAAK,CAAE;CAE7B,MAAM,YAAc,KAAK,cAAc,KAAK,aAAa,KAAK,mBAA+B;CAE7F,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,KAAK;AAErC,oBACH,YACE;EACE,UAAU;EACV;EACA,SAAS,eAAe,IAAI;EAC5B;EACA,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,MAAM;GACJ,SAAS,KAAK;GACd,cAAc,KAAK;GACnB,kBAAkB,OAAO,KAAK,qBAAqB,WAC/C,KAAK,iBAAiB,MAAM,GAAG,IAAK,GACpC;GACJ,eAAe,KAAK;GACpB,WAAW,KAAK;GACjB;EACF,EACD,KACD,EACD,mBACD;AACD,kBAAiB,QAAQ,KAAK,EAAE,EAAE,YAAY,CAAC,OAAO;;AAGxD,MAAM,CAAC,YAAY,QAAQ,KAAK,EAAE,CAAC"}
+{"version":3,"file":"task-completed.mjs","names":[],"sources":["../../src/hooks/_capture-filter.ts","../../src/hooks/_project.ts","../../src/hooks/task-completed.ts"],"sourcesContent":["const DEFAULT_DENY_PATTERNS = [\n  \"memory_*\",\n  \"toolsearch\",\n  \"listmcpresources\",\n  \"fetchmcpresource\",\n];\n\nfunction parseEnvList(raw: string | undefined): string[] | undefined {\n  if (!raw?.trim()) return undefined;\n  return raw\n    .split(/[,\\s]+/)\n    .map((part) => part.trim())\n    .filter(Boolean);\n}\n\nexport function bareToolName(toolName: string): string {\n  const trimmed = toolName.trim();\n  if (/^mcp__/i.test(trimmed)) {\n    const parts = trimmed.split(\"__\");\n    if (parts.length >= 3) return parts[parts.length - 1]!;\n  }\n  return trimmed;\n}\n\nfunction normalizePattern(pattern: string): string {\n  return pattern.trim().toLowerCase();\n}\n\nfunction matchesPattern(toolName: string, pattern: string): boolean {\n  const bare = bareToolName(toolName).toLowerCase();\n  const full = toolName.trim().toLowerCase();\n  const pat = normalizePattern(pattern);\n  if (!pat.includes(\"*\")) return bare === pat || full === pat;\n  const escaped = pat.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  const re = new RegExp(`^${escaped.replace(/\\*/g, \".*\")}$`);\n  return re.test(bare) || re.test(full);\n}\n\nfunction matchesAny(toolName: string, patterns: string[]): boolean {\n  return patterns.some((pattern) => matchesPattern(toolName, pattern));\n}\n\nexport function shouldCaptureTool(toolName: unknown): boolean {\n  if (typeof toolName !== \"string\" || !toolName.trim()) return true;\n\n  const allow = parseEnvList(process.env[\"AGENTMEMORY_CAPTURE_ALLOW\"]);\n  if (allow) return matchesAny(toolName, allow);\n\n  const deny = [\n    ...DEFAULT_DENY_PATTERNS,\n    ...(parseEnvList(process.env[\"AGENTMEMORY_CAPTURE_DENY\"]) ?? []),\n  ];\n  return !matchesAny(toolName, deny);\n}\n\nexport function captureOutputMax(): number {\n  const raw = process.env[\"AGENTMEMORY_CAPTURE_OUTPUT_MAX\"];\n  if (!raw?.trim()) return 8000;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : 8000;\n}\n\nexport function truncateText(value: string, max: number): string {\n  if (value.length <= max) return value;\n  const end = /[\\uD800-\\uDBFF]/.test(value[max - 1] ?? \"\") ? max - 1 : max;\n  return value.slice(0, end);\n}\n\nexport function truncateCaptureOutput(value: unknown, max: number): unknown {\n  if (typeof value === \"string\" && value.length > max) {\n    const suffix = \"\\n[...truncated]\";\n    return max <= suffix.length\n      ? suffix.slice(0, max)\n      : truncateText(value, max - suffix.length) + suffix;\n  }\n  if (typeof value === \"object\" && value !== null) {\n    const str = JSON.stringify(value);\n    if (str.length > max) {\n      const suffix = \"...[truncated]\";\n      return max <= suffix.length\n        ? suffix.slice(0, max)\n        : truncateText(str, max - suffix.length) + suffix;\n    }\n    return value;\n  }\n  return value;\n}\n\nexport function preCompactBudget(): number {\n  const raw = process.env[\"AGENTMEMORY_PRE_COMPACT_BUDGET\"];\n  if (raw?.trim() === \"0\") return 0;\n  if (!raw?.trim()) return 1500;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : 1500;\n}\n","import { execSync } from \"node:child_process\";\nimport { realpathSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\n\n// Resolution order: AGENTMEMORY_PROJECT_NAME env → git repository basename → cwd basename.\nexport function resolveProject(cwd?: string): string {\n  const explicit = process.env[\"AGENTMEMORY_PROJECT_NAME\"];\n  if (explicit && explicit.trim()) return explicit.trim();\n  const dir = cwd && cwd.trim() ? cwd : process.cwd();\n  try {\n    const [top, gitDir, commonDir] = execSync(\n      \"git rev-parse --show-toplevel --git-dir --git-common-dir\",\n      {\n        cwd: dir,\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n        timeout: 500,\n      },\n    )\n      .toString()\n      .trim()\n      .split(/\\r?\\n/);\n    if (top) return basename(repositoryRoot(dir, top, gitDir, commonDir));\n  } catch {}\n  return basename(dir);\n}\n\nfunction repositoryRoot(dir: string, top: string, gitDir?: string, commonDir?: string): string {\n  if (!gitDir || !commonDir) return top;\n  const physical = realpathSync(dir);\n  const common = resolve(physical, commonDir);\n  if (resolve(physical, gitDir) === common || basename(common) !== \".git\") return top;\n  return dirname(common);\n}\n\nexport function hookCwd(data: Record<string, unknown> | null | undefined): string | undefined {\n  if (!data || typeof data !== \"object\") return undefined;\n  if (typeof data.cwd === \"string\" && data.cwd.trim()) return data.cwd;\n  const roots = data.workspace_roots;\n  if (Array.isArray(roots)) {\n    for (const root of roots) {\n      if (typeof root === \"string\" && root.trim()) return root;\n    }\n  }\n  const projectDir =\n    process.env[\"DEVIN_PROJECT_DIR\"] || process.env[\"CLAUDE_PROJECT_DIR\"];\n  if (projectDir && projectDir.trim()) return projectDir;\n  return undefined;\n}\n","#!/usr/bin/env node\nimport { truncateText } from \"./_capture-filter.js\";\nimport { resolveProject, hookCwd } from \"./_project.js\";\nimport { captureObservation, isDrainChild, runDrainChild, withEventId } from \"./_capture.js\";\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 OBSERVE_TIMEOUT_MS = 2000;\nconst EXIT_CAP_MS = 2500;\n\nasync function main() {\n  if (isDrainChild()) return runDrainChild();\n  let input = \"\";\n  for await (const chunk of process.stdin) {\n    input += chunk;\n  }\n\n  let data: Record<string, unknown>;\n  try {\n    data = JSON.parse(input);\n  } catch {\n    return;\n  }\n\n  if (!data || typeof data !== \"object\") return;\n  if (isSdkChildContext(data)) return;\n\n  const sessionId = ((data.session_id || data.sessionId || data.conversation_id) as string) || \"unknown\";\n\n  const cwd = hookCwd(data) || process.cwd();\n\n  void captureObservation(\n    withEventId(\n      {\n        hookType: \"task_completed\",\n        sessionId,\n        project: resolveProject(cwd),\n        cwd,\n        timestamp: new Date().toISOString(),\n        data: {\n          task_id: data.task_id,\n          task_subject: data.task_subject,\n          task_description: typeof data.task_description === \"string\"\n            ? truncateText(data.task_description, 2000)\n            : \"\",\n          teammate_name: data.teammate_name,\n          team_name: data.team_name,\n        },\n      },\n      {},\n      undefined,\n      { stable: Boolean(data.task_id) },\n    ),\n    OBSERVE_TIMEOUT_MS,\n  );\n  setTimeout(() => process.exit(0), EXIT_CAP_MS).unref();\n}\n\nmain().catch(() => process.exit(0));\n"],"mappings":";;;;;;AA8DA,SAAgB,aAAa,OAAe,KAAqB;AAC/D,KAAI,MAAM,UAAU,IAAK,QAAO;CAChC,MAAM,MAAM,kBAAkB,KAAK,MAAM,MAAM,MAAM,GAAG,GAAG,MAAM,IAAI;AACrE,QAAO,MAAM,MAAM,GAAG,IAAI;;;;AC5D5B,SAAgB,eAAe,KAAsB;CACnD,MAAM,WAAW,QAAQ,IAAI;AAC7B,KAAI,YAAY,SAAS,MAAM,CAAE,QAAO,SAAS,MAAM;CACvD,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,MAAM,QAAQ,KAAK;AACnD,KAAI;EACF,MAAM,CAAC,KAAK,QAAQ,aAAa,SAC/B,4DACA;GACE,KAAK;GACL,OAAO;IAAC;IAAU;IAAQ;IAAS;GACnC,SAAS;GACV,CACF,CACE,UAAU,CACV,MAAM,CACN,MAAM,QAAQ;AACjB,MAAI,IAAK,QAAO,SAAS,eAAe,KAAK,KAAK,QAAQ,UAAU,CAAC;SAC/D;AACR,QAAO,SAAS,IAAI;;AAGtB,SAAS,eAAe,KAAa,KAAa,QAAiB,WAA4B;AAC7F,KAAI,CAAC,UAAU,CAAC,UAAW,QAAO;CAClC,MAAM,WAAW,aAAa,IAAI;CAClC,MAAM,SAAS,QAAQ,UAAU,UAAU;AAC3C,KAAI,QAAQ,UAAU,OAAO,KAAK,UAAU,SAAS,OAAO,KAAK,OAAQ,QAAO;AAChF,QAAO,QAAQ,OAAO;;AAGxB,SAAgB,QAAQ,MAAsE;AAC5F,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,KAAA;AAC9C,KAAI,OAAO,KAAK,QAAQ,YAAY,KAAK,IAAI,MAAM,CAAE,QAAO,KAAK;CACjE,MAAM,QAAQ,KAAK;AACnB,KAAI,MAAM,QAAQ,MAAM;OACjB,MAAM,QAAQ,MACjB,KAAI,OAAO,SAAS,YAAY,KAAK,MAAM,CAAE,QAAO;;CAGxD,MAAM,aACJ,QAAQ,IAAI,wBAAwB,QAAQ,IAAI;AAClD,KAAI,cAAc,WAAW,MAAM,CAAE,QAAO;;;;ACxC9C,SAAS,kBAAkB,SAA2B;AACpD,KAAI,QAAQ,IAAI,6BAA6B,IAAK,QAAO;AACzD,KAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AACpD,QAAQ,QAAqC,eAAe;;AAG9D,MAAM,qBAAqB;AAC3B,MAAM,cAAc;AAEpB,eAAe,OAAO;AACpB,KAAI,cAAc,CAAE,QAAO,eAAe;CAC1C,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;AAGF,KAAI,CAAC,QAAQ,OAAO,SAAS,SAAU;AACvC,KAAI,kBAAkB,KAAK,CAAE;CAE7B,MAAM,YAAc,KAAK,cAAc,KAAK,aAAa,KAAK,mBAA+B;CAE7F,MAAM,MAAM,QAAQ,KAAK,IAAI,QAAQ,KAAK;AAErC,oBACH,YACE;EACE,UAAU;EACV;EACA,SAAS,eAAe,IAAI;EAC5B;EACA,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,MAAM;GACJ,SAAS,KAAK;GACd,cAAc,KAAK;GACnB,kBAAkB,OAAO,KAAK,qBAAqB,WAC/C,aAAa,KAAK,kBAAkB,IAAK,GACzC;GACJ,eAAe,KAAK;GACpB,WAAW,KAAK;GACjB;EACF,EACD,EAAE,EACF,KAAA,GACA,EAAE,QAAQ,QAAQ,KAAK,QAAQ,EAAE,CAClC,EACD,mBACD;AACD,kBAAiB,QAAQ,KAAK,EAAE,EAAE,YAAY,CAAC,OAAO;;AAGxD,MAAM,CAAC,YAAY,QAAQ,KAAK,EAAE,CAAC"}

package/plugin/skills/_shared/TROUBLESHOOTING.md

@@ -1,17 +1,23 @@
 # Troubleshooting agentmemory skills
 
-Shared recovery steps for all user-invocable agentmemory skills. Each skill's
-Troubleshooting section points here instead of duplicating the block.
+Recovery steps for separately installed skills. This document is generated into
+each skill directory so native skill readers can open it without parent traversal.
 
 ## "MCP tool not available"
 
 Missing tools can mean a stopped MCP process, a disconnected daemon, or an
 explicitly reduced tool surface. Walk these in order:
 
-1. Run `/plugin list` in the host and confirm `agentmemory` shows as enabled.
-2. Restart the host. The plugin's `.mcp.json` is only read on startup, so a
-   freshly installed or re-enabled plugin will not register tools mid-session.
-3. Check `/mcp` and confirm the `agentmemory` server shows a live connection.
+1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.
+   In Hermes, inspect the configured memory provider and `mcp_servers` separately.
+   In OpenClaw, validate the host configuration and inspect its MCP servers and
+   native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the
+   MCP inventory separately; native save/search does not prove the broader tools
+   are connected. Do not run another host's setup commands.
+2. Restart or reload the affected host connection after configuration changes.
+3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invoke
+   the actual advertised names and schemas. A native memory provider is not
+   proof that every MCP tool or shared skill is available.
 4. Check `agentmemory status` and the daemon's `AGENTMEMORY_TOOLS` setting.
    Codex's bundled bridge lists the daemon's enabled tools. The standalone shim
    used by other hosts can fall back to seven basic tools with a separate store.
@@ -19,6 +25,12 @@ explicitly reduced tool surface. Walk these in order:
 5. If `agentmemory connect codex` and the Codex plugin are both enabled, choose
    one MCP connection. Check `/hooks` before adding global hook fallbacks.
 
+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts
+may install them separately. Check the host's skill inventory and open this file
+from the installed skill directory. Test automatic capture with a real turn and
+a recorded observation; tool connectivity alone does not establish lifecycle
+capture.
+
 An outage or timeout is not an empty search result. Report the failure. A write
 may have committed before the response was lost; inspect state before retrying.
 
@@ -32,9 +44,11 @@ API directly:
    `AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in
    `~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locally
    without displaying it. Never send a local-file secret to a remote URL.
+   If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential
+   and do not read local credential files.
    Authenticated REST fallback requests require HTTPS for non-loopback
    URLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).
-   Do not print or save the secret.
+   Reject redirects on authenticated requests. Do not print or save the secret.
 
 Endpoint map by skill:
 

package/plugin/skills/agentmemory-agents/REFERENCE.md

@@ -3,28 +3,29 @@
 Generated from `src/cli/connect/index.ts`. Do not edit the block below by hand; run `npm run skills:gen` after adding or removing an adapter.
 
 <!-- AUTOGEN:agents START - generated by scripts/skills/generate.ts, do not edit by hand -->
-`agentmemory connect <agent>` wires the memory server into a host agent. 21 adapters:
+`agentmemory connect <agent>` wires the memory server into a host agent. 22 adapters:
 
 | Agent | Name | Protocol |
 | --- | --- | --- |
 | Antigravity | `antigravity` | Using MCP via ~/.gemini/config/mcp_config.json, shared by current Antigravity surfaces. Pass --with-hooks for capture through ~/.gemini/config/hooks.json. |
 | Antigravity CLI (agy) | `antigravity-cli` | Using MCP via ~/.gemini/config/mcp_config.json, shared with current Antigravity IDE versions. The `/mcp` slash command inside agy lists configured servers. Pass --with-hooks to also install the native ~/.gemini/config/hooks.json auto-capture hooks. |
 | Claude Code | `claude-code` | Using MCP. Hooks are also available, see https://github.com/rohitg00/agentmemory#claude-code-one-block-paste-it. |
-| Cline | `cline` | Using MCP via ~/.cline/mcp.json (CLI). VS Code users: add the same block via Cline Settings → MCP Servers → Edit JSON. |
+| Cline | `cline` | Using MCP via ~/.cline/data/settings/cline_mcp_settings.json (CLI), or CLINE_MCP_SETTINGS_PATH when set. VS Code users: add the same block via Cline Settings → MCP Servers → Edit JSON. |
 | Codex CLI | `codex` | Using MCP. Hooks ship via the Codex plugin; on Codex Desktop, also pass --with-hooks to install the global hooks.json workaround. |
 | Continue | `continue` | Using MCP via ~/.continue/config.yaml (preferred) or config.json (legacy, only when no yaml). |
 | GitHub Copilot CLI | `copilot-cli` | Using MCP. Install the plugin too for full hooks/skills coverage. |
-| Cursor | `cursor` | Using MCP (the only protocol Cursor speaks). Memory bridge runs at :3111 underneath. |
+| Cursor | `cursor` | Using MCP. Lifecycle hooks ship in the Cursor plugin: Settings → Plugins → Add marketplace → this repo, then enable agentmemory. |
 | Devin CLI | `devin` | Using MCP via the user config. Devin CLI migrates mcpServers into mcp_config.json on newer builds. Pass --with-hooks for native auto-capture. |
 | Droid (Factory.ai) | `droid` | Using MCP via ~/.factory/mcp.json. The `/mcp` slash command inside droid lists configured servers. Pass --with-hooks to also install the native ~/.factory/hooks.json auto-capture hooks. |
-| DeepSeek Harness | `dsh` | Using MCP via $DSH_HOME/cordis.patch.yml (the home-level patch layer every profile loads). Tools appear as mcp__agentmemory__*. Pass --with-hooks to also wire auto-capture through Harness's Claude Code hook bridge. |
+| DeepSeek Harness | `dsh` | Using MCP via $DSH_HOME/cordis.patch.yml (the home-level patch layer every profile loads). Tools appear as mcp__agentmemory__*. Pass --with-hooks to also wire auto-capture with the bundled native DSH plugin. |
 | Gemini CLI | `gemini-cli` | Using MCP (the only protocol Gemini CLI speaks). Memory bridge runs at :3111 underneath. |
-| Hermes Agent | `hermes` | Using MCP. Hooks are also available, see https://github.com/rohitg00/agentmemory/tree/main/integrations/hermes. |
+| Hermes Agent | `hermes` | Installs the native memory provider and bundled skills into the active Hermes profile. Credentials stay managed by Hermes. |
 | Kiro | `kiro` | Using MCP via ~/.kiro/settings/mcp.json (user-level). Workspace overrides live in .kiro/settings/mcp.json. |
-| OpenClaw | `openclaw` | Using MCP. Hooks are also available, see https://github.com/rohitg00/agentmemory/tree/main/integrations/openclaw. |
+| Oh My Pi | `omp` | Installs native recall, capture and skills. Add --with-mcp for the full memory toolset. |
+| OpenClaw | `openclaw` | Installs native recall/capture and bundled skills into the active OpenClaw state directory. MCP tools are opt-in with --with-mcp. |
 | OpenCode | `opencode` | Using MCP via ~/.config/opencode/opencode.json (top-level `mcp` key). For full auto-capture, also install the bundled plugin in plugin/opencode/. |
 | OpenHuman | `openhuman` | Using native hooks (REST API at :3111). MCP not required. |
-| pi | `pi` | Using native lifecycle hooks against the REST API at :3111 (recall on agent start, capture on agent end, memory tools). MCP not required. |
+| Pi | `pi` | Installs native recall, capture and skills. Add --with-mcp for the full memory toolset. |
 | Qwen Code | `qwen` | Using MCP via ~/.qwen/settings.json. Qwen Code's hook system can also be wired separately, see docs. |
 | Warp | `warp` | Using MCP via ~/.warp/.mcp.json. Skills auto-discover from .claude/skills/ if the Claude Code plugin is also installed. |
 | Zed | `zed` | Using MCP via ~/.config/zed/settings.json (key: context_servers). |

package/plugin/skills/agentmemory-agents/SKILL.md

@@ -12,18 +12,32 @@ user-invocable: false
 agentmemory connect claude-code   # or cursor, codex, gemini-cli, ...
 ```
 
-After wiring, restart the host or run its MCP reload (for example `/mcp` in Claude Code) so it picks up the server. Then confirm the agent lists agentmemory's tools.
+After wiring, restart the host or run its MCP reload (for example `/mcp` in Claude Code, or a new session after `devin mcp list` in Devin CLI) so it picks up the server. Then confirm the agent lists agentmemory's tools.
+
+Devin CLI and Devin Desktop can also install the whole plugin with `devin plugins install rohitg00/agentmemory#plugin`, which adds the skills, the MCP server, and the capture hooks in one step. Cloud Devin sessions cannot reach a local agentmemory server, so the plugin is for local sessions only.
+
+For Pi, Oh My Pi, or DeepSeek Harness, start the daemon and choose the matching command:
+
+```bash
+agentmemory connect pi --with-mcp
+agentmemory connect omp --with-mcp
+agentmemory connect dsh --with-hooks
+```
+
+Pi and OMP install native recall, capture and bundled skills; `--with-mcp` adds the tools needed by the broader workflows. Reload Pi with `/reload`, or restart OMP, then run `/agentmemory-status`. Restart DSH after enabling its bundled capture plugin. Re-run the matching connector after upgrading or moving AgentMemory so installed runtime paths stay current.
+
+Cursor's connector configures MCP. Install and enable the Cursor plugin through Settings → Plugins → Add marketplace → this repository for lifecycle capture; do not add a second global hook copy.
 
 ## Workflow
 
-1. Detect the calling agent. If unknown, default to `claude-code`.
+1. Detect the calling agent. If unknown, ask which host to configure before changing files.
 2. Run `agentmemory connect <name>` using a name from the table in REFERENCE.md.
-3. Verify: the host should show the full tool set with a server running. Only 7 tools means the MCP shim could not reach a server (see ../_shared/TROUBLESHOOTING.md).
+3. Read the command result: an adapter that prints manual setup instructions has not completed installation. Restart the configured host, inspect its actual tool inventory, and perform an authorized save/recall check. A native memory provider and an MCP connection are separate surfaces (see [TROUBLESHOOTING.md](TROUBLESHOOTING.md)).
 
 ## Notes
 
-- The action skills (remember, recall, and the rest) are installed separately with `npx skills add rohitg00/agentmemory`. `connect` makes tools available; skills teach the agent when to use them.
-- Windows: use WSL2. Native Windows runs the server but `connect` is not supported there.
+- Hermes, OpenClaw, Pi and OMP connectors bundle skills. For a separate skills installation, use `npx skills@1.7.1 add rohitg00/agentmemory --agent hermes-agent --skill '*'` or `--agent openclaw`. Choose the intended host; add `--global` only for a user-wide installation. Avoid duplicate skill installations when a native package already bundles them. Verify skill discovery and read a skill's local support file in that host.
+- Native Windows supports `agentmemory connect copilot-cli`. Other automated connectors require macOS, Linux or a host running in the same WSL2 environment; use the host's manual setup instructions otherwise.
 
 ## See also
 

package/plugin/skills/agentmemory-agents/TROUBLESHOOTING.md

@@ -0,0 +1,70 @@
+<!-- AUTOGEN:troubleshooting START - generated by scripts/skills/generate.ts, do not edit by hand -->
+# Troubleshooting agentmemory skills
+
+Recovery steps for separately installed skills. This document is generated into
+each skill directory so native skill readers can open it without parent traversal.
+
+## "MCP tool not available"
+
+Missing tools can mean a stopped MCP process, a disconnected daemon, or an
+explicitly reduced tool surface. Walk these in order:
+
+1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.
+   In Hermes, inspect the configured memory provider and `mcp_servers` separately.
+   In OpenClaw, validate the host configuration and inspect its MCP servers and
+   native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the
+   MCP inventory separately; native save/search does not prove the broader tools
+   are connected. Do not run another host's setup commands.
+2. Restart or reload the affected host connection after configuration changes.
+3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invoke
+   the actual advertised names and schemas. A native memory provider is not
+   proof that every MCP tool or shared skill is available.
+4. Check `agentmemory status` and the daemon's `AGENTMEMORY_TOOLS` setting.
+   Codex's bundled bridge lists the daemon's enabled tools. The standalone shim
+   used by other hosts can fall back to seven basic tools with a separate store.
+   Do not claim full daemon functionality based on those seven tools.
+5. If `agentmemory connect codex` and the Codex plugin are both enabled, choose
+   one MCP connection. Check `/hooks` before adding global hook fallbacks.
+
+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts
+may install them separately. Check the host's skill inventory and open this file
+from the installed skill directory. Test automatic capture with a real turn and
+a recorded observation; tool connectivity alone does not establish lifecycle
+capture.
+
+An outage or timeout is not an empty search result. Report the failure. A write
+may have committed before the response was lost; inspect state before retrying.
+
+## REST fallback
+
+When the MCP tools stay unavailable but the daemon is running, call the REST
+API directly:
+
+1. Set `AGENTMEMORY_URL` to the daemon base URL (default `http://localhost:3111`).
+2. The REST API requires a bearer credential by default. Use the host's explicit
+   `AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in
+   `~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locally
+   without displaying it. Never send a local-file secret to a remote URL.
+   If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential
+   and do not read local credential files.
+   Authenticated REST fallback requests require HTTPS for non-loopback
+   URLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).
+   Reject redirects on authenticated requests. Do not print or save the secret.
+
+Endpoint map by skill:
+
+| Skill           | REST call                                                        |
+| --------------- | --------------------------------------------------------------- |
+| remember        | `POST /agentmemory/remember`                                     |
+| recall          | `POST /agentmemory/smart-search`                                 |
+| recap           | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search`   |
+| handoff         | `GET /agentmemory/sessions` + `POST /agentmemory/smart-search`   |
+| session-history | `GET /agentmemory/sessions`                                      |
+| commit-context  | `GET /agentmemory/session/by-commit?sha=<sha>`                   |
+| commit-history  | `GET /agentmemory/commits` (URL-encode every query param)       |
+
+The MCP host reads the plugin MCP configuration. Restart the daemon after
+changing its configuration, then restart or reconnect the host MCP process after
+changing its URL or explicit secret. The local bridge reads the credential files
+for each request; it does not inherit other daemon `.env` settings.
+<!-- AUTOGEN:troubleshooting END -->

package/plugin/skills/agentmemory-architecture/SKILL.md

@@ -4,7 +4,7 @@ description: How agentmemory is built, the iii engine primitives it runs on, its
 user-invocable: false
 ---
 
-agentmemory is a memory server for coding agents. It runs locally, captures observations, indexes them for hybrid retrieval, and serves them back over REST and MCP. It is built on the iii engine.
+agentmemory is a memory server for coding agents. It runs locally, captures observations, indexes them for hybrid retrieval, and serves them back over REST and MCP. Worker Compose runs the pinned iii engine with AgentMemory and the registry `state` and `http` workers. The state worker uses a file-backed KV store by default, with Redis available by configuration; it is not SQLite.
 
 ## iii primitives
 
@@ -12,7 +12,11 @@ Everything is a function, a trigger, or worker state on the iii engine. There is
 
 ## Retrieval model
 
-Recall is hybrid: BM25 keyword search plus vector similarity plus graph expansion over linked concepts. The default install needs no API key because embeddings run on-device and BM25 needs none. An LLM provider only adds richer summaries and auto-injection, both opt-in.
+Recall combines BM25 keyword search with configured vector similarity and graph expansion. A clean installation has no embedding provider and uses BM25 without an API key. Set `EMBEDDING_PROVIDER=local` to enable on-device embeddings, which download a model once. A remote embedding provider runs only when `EMBEDDING_PROVIDER` names it. LLM summaries, consolidation and reflection run only when `AGENTMEMORY_LLM_PROVIDER` selects a provider or `AGENTMEMORY_ALLOW_AGENT_SDK=true` turns on the Claude Agent SDK fallback; a key in the environment alone does not turn them on. Per-observation LLM compression also needs `AGENTMEMORY_AUTO_COMPRESS=true`.
+
+## Data boundary
+
+Captured prompts, tool inputs and outputs, and memories stay in the local store. They leave the machine only through options the user turns on: a selected LLM provider, the Agent SDK fallback (`AGENTMEMORY_ALLOW_AGENT_SDK=true`), a remote embedding provider, a Redis state backend, or mesh sync to peer servers the user registers.
 
 ## Storage and lifecycle
 
@@ -20,11 +24,11 @@ Memories carry content, concepts, files, importance, and timestamps, grouped int
 
 ## Ports
 
-REST is the anchor at 3111. Streams = N+1 (3112), viewer = N+2 (3113), engine = N+46023 (49134). `--instance N` shifts the whole block by N*100.
+REST defaults to port `3111`, the viewer to `3113`, and the internal engine WebSocket to `49134`. Use `--port <N>` or `--instance <N>` to select another local runtime.
 
 ## Viewer
 
-A real-time web viewer at `http://localhost:3113` shows memory building as sessions run. Useful for demos and for confirming capture is working.
+A real-time web viewer at `http://localhost:3113` shows memory building as sessions run, with authenticated SSE updates over the REST port. Useful for demos and for confirming capture is working.
 
 ## See also