@agentmemory/agentmemory 0.8.9 → 0.8.11

package/AGENTS.md

@@ -45,7 +45,7 @@ agentmemory is a persistent memory system for AI coding agents, built on iii-eng
 ### Function Registration
 ```typescript
 sdk.registerFunction(
-  { id: "mem::your-function" },
+  "mem::your-function",
   async (data: { ... }) => {
     // validate inputs
     // do work via kv.get/kv.set/kv.list
@@ -57,12 +57,15 @@ sdk.registerFunction(
 
 ### REST Endpoint Registration
 ```typescript
-sdk.registerFunction({ id: "api::your-endpoint" }, async (req: ApiRequest) => {
+sdk.registerFunction("api::your-endpoint", async (req: ApiRequest) => {
   const denied = checkAuth(req, secret);
   if (denied) return denied;
   const body = req.body as Record<string, unknown>;
   // validate + whitelist fields (never pass raw body to sdk.trigger)
-  const result = await sdk.trigger("mem::your-function", { ... });
+  const result = await sdk.trigger({
+    function_id: "mem::your-function",
+    payload: { ... },
+  });
   return { status_code: 200, body: result };
 });
 sdk.registerTrigger({
@@ -77,7 +80,10 @@ sdk.registerTrigger({
 case "memory_your_tool": {
   // validate args with typeof checks
   // parse CSV args: args.field.split(",").map(t => t.trim()).filter(Boolean)
-  const result = await sdk.trigger("mem::your-function", { ... });
+  const result = await sdk.trigger({
+    function_id: "mem::your-function",
+    payload: { ... },
+  });
   return { status_code: 200, body: { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] } };
 }
 ```
@@ -98,16 +104,16 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import).
 
 ## Testing
 
-- All tests must pass before PR: `npm test` (613+ tests)
+- All tests must pass before PR: `npm test` (699+ tests)
 - Mock pattern: `vi.mock("iii-sdk")` with mock `sdk.trigger`, `kv.get/set/list`
 - Test files go in `test/` with `.test.ts` extension
 - Follow existing patterns in `test/crystallize.test.ts` for function tests
 
-## Current Stats (v0.7.0)
+## Current Stats (v0.8.9)
 
 - 43 MCP tools (8 visible by default, `AGENTMEMORY_TOOLS=all` for all)
 - 103 REST endpoints
 - 6 MCP resources, 3 MCP prompts
 - 12 hooks, 4 skills
 - 50+ iii functions
-- 627 tests
+- 699 tests

package/README.md

@@ -7,6 +7,14 @@
   Persistent memory for Claude Code, Cursor, Gemini CLI, OpenCode, and any MCP client.
 </p>
 
+<p align="center">
+  <a href="https://gist.github.com/rohitg00/2067ab416f7bbe447c1977edaaa681e2"><img src="https://img.shields.io/badge/Viral%20GitHub%20Gist-669%20stars%20%2F%2091%20forks-FF6B35?style=for-the-badge&logo=github&logoColor=white&labelColor=1a1a1a" alt="Design doc: 686 stars / 94 forks on the gist" /></a>
+</p>
+
+<p align="center">
+  <strong>The gist extends Karpathy's LLM Wiki pattern with confidence scoring, lifecycle, knowledge graphs, and hybrid search.<br/> agentmemory is the implementation.</strong>
+</p>
+
 <p align="center">
   <a href="https://www.npmjs.com/package/@agentmemory/agentmemory"><img src="https://img.shields.io/npm/v/@agentmemory/agentmemory?color=CB3837&label=npm&style=for-the-badge&logo=npm" alt="npm version" /></a>
   <a href="https://github.com/rohitg00/agentmemory/actions"><img src="https://img.shields.io/github/actions/workflow/status/rohitg00/agentmemory/ci.yml?label=tests&style=for-the-badge&logo=github" alt="CI" /></a>
@@ -278,6 +286,8 @@ npx @agentmemory/agentmemory
 
 <h2 id="quick-start"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-quickstart.svg"><img src="assets/tags/section-quickstart.svg" alt="Quick Start" height="32" /></picture></h2>
 
+Compatibility: this release targets stable `iii-sdk` `^0.11.0` and iii-engine v0.11.x.
+
 ### Try it in 30 seconds
 
 ```bash
@@ -292,6 +302,18 @@ npx @agentmemory/agentmemory demo
 
 Open `http://localhost:3113` to watch the memory build live.
 
+### Upgrade / Maintenance
+
+Use the maintenance command when you intentionally want to update your local runtime:
+
+```bash
+npx @agentmemory/agentmemory upgrade
+```
+
+Warning: this command mutates the current workspace/runtime. It can update JavaScript dependencies, may run `cargo install iii-engine --force`, and may pull Docker images.
+
+Implementation details live in `src/cli.ts` (see `runUpgrade` around the `src/cli.ts:544-595` region).
+
 ### Claude Code (one block, paste it)
 
 ```
@@ -723,6 +745,20 @@ Create `~/.agentmemory/.env`:
                                    # LLM provider to compress the
                                    # observation — expect significant
                                    # token spend on active sessions.
+# AGENTMEMORY_INJECT_CONTEXT=false # OFF by default (#143). When on:
+                                   # - SessionStart may inject ~1-2K
+                                   #   chars of project context into
+                                   #   the first turn of each session
+                                   #   (this is what actually reaches
+                                   #   the model — Claude Code treats
+                                   #   SessionStart stdout as context)
+                                   # - PreToolUse fires /agentmemory/enrich
+                                   #   on every file-touching tool call
+                                   #   (resource cleanup, not a token
+                                   #   fix — PreToolUse stdout is debug
+                                   #   log only per Claude Code docs)
+                                   # Observations are still captured via
+                                   # PostToolUse regardless of this flag.
 # GRAPH_EXTRACTION_ENABLED=false
 # CONSOLIDATION_ENABLED=true
 # LESSON_DECAY_ENABLED=true

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { execFileSync, spawn } from "node:child_process";
+import { execFileSync, spawn, spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { delimiter, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -89,6 +89,7 @@ Commands:
   (default)          Start agentmemory worker
   status             Show connection status, memory count, and health
   demo               Seed sample sessions and show recall in action
+  upgrade            Upgrade local deps + iii runtime (best effort)
   mcp                Start standalone MCP server (no engine required)
 
 Options:
@@ -102,6 +103,7 @@ Quick start:
   npx @agentmemory/agentmemory          # start with local iii-engine or Docker
   npx @agentmemory/agentmemory status   # check health
   npx @agentmemory/agentmemory demo     # try it in 30 seconds (needs server running)
+  npx @agentmemory/agentmemory upgrade  # upgrade agentmemory + iii runtime
   npx @agentmemory/agentmemory mcp      # standalone MCP server (no engine)
   npx @agentmemory/mcp                  # same as above (shim package)
 `);
@@ -284,12 +286,12 @@ async function main() {
 	p.intro("agentmemory");
 	if (skipEngine) {
 		p.log.info("Skipping engine check (--no-engine)");
-		await import("./src-DJpwR1mt.mjs");
+		await import("./src-M6V9yZW5.mjs");
 		return;
 	}
 	if (await isEngineRunning()) {
 		p.log.success("iii-engine is running");
-		await import("./src-DJpwR1mt.mjs");
+		await import("./src-M6V9yZW5.mjs");
 		return;
 	}
 	if (!await startEngine()) {
@@ -333,7 +335,7 @@ async function main() {
 		process.exit(1);
 	}
 	s.stop("iii-engine is ready");
-	await import("./src-DJpwR1mt.mjs");
+	await import("./src-M6V9yZW5.mjs");
 }
 async function runStatus() {
 	const port = getRestPort();
@@ -556,12 +558,97 @@ async function runDemo() {
 	p.note(lines.join("\n"), "demo complete");
 	p.log.success("agentmemory is working. Point your agent at it and get back to coding.");
 }
+function runCommand(command, commandArgs, options = { label: "command" }) {
+	const spinner = p.spinner();
+	spinner.start(options.label);
+	const result = spawnSync(command, commandArgs, {
+		cwd: options.cwd || process.cwd(),
+		stdio: "pipe",
+		encoding: "utf-8"
+	});
+	if (result.status === 0) {
+		spinner.stop(`${options.label} ✓`);
+		return true;
+	}
+	const stderr = (result.stderr || "").toString().trim();
+	const stdout = (result.stdout || "").toString().trim();
+	const msg = stderr || stdout || "unknown error";
+	if (options.optional) {
+		spinner.stop(`${options.label} (skipped)`);
+		p.log.warn(msg.slice(0, 300));
+		return false;
+	}
+	spinner.stop(`${options.label} ✗`);
+	p.log.error(msg.slice(0, 300));
+	return false;
+}
+async function runUpgrade() {
+	p.intro("agentmemory upgrade");
+	const cwd = process.cwd();
+	const hasPackageJson = existsSync(join(cwd, "package.json"));
+	const hasPnpmLock = existsSync(join(cwd, "pnpm-lock.yaml"));
+	const pnpmBin = whichBinary("pnpm");
+	const npmBin = whichBinary("npm");
+	const cargoBin = whichBinary("cargo");
+	const dockerBin = whichBinary("docker");
+	p.log.info(`Working directory: ${cwd}`);
+	const requireSuccess = (ok, label) => {
+		if (!ok) {
+			p.log.error(`Upgrade aborted: ${label} failed.`);
+			process.exit(1);
+		}
+	};
+	if (hasPackageJson) if (!!pnpmBin && hasPnpmLock && pnpmBin) {
+		requireSuccess(runCommand(pnpmBin, ["install"], { label: "Refreshing dependencies (pnpm install)" }), "pnpm install");
+		runCommand(pnpmBin, ["up", "iii-sdk@latest"], {
+			label: "Upgrading iii-sdk to latest",
+			optional: true
+		});
+	} else if (npmBin) {
+		requireSuccess(runCommand(npmBin, ["install"], { label: "Refreshing dependencies (npm install)" }), "npm install");
+		runCommand(npmBin, ["install", "iii-sdk@latest"], {
+			label: "Upgrading iii-sdk to latest",
+			optional: true
+		});
+	} else p.log.warn("No package manager found (pnpm/npm). Skipping JS dependency upgrade.");
+	else p.log.warn("No package.json in current directory. Skipping JS dependency upgrade.");
+	if (cargoBin) {
+		const upgradeEngine = await p.confirm({
+			message: "Upgrade iii-engine via cargo install --force?",
+			initialValue: true
+		});
+		if (p.isCancel(upgradeEngine)) {
+			p.cancel("Cancelled.");
+			return process.exit(0);
+		}
+		if (upgradeEngine === true) requireSuccess(runCommand(cargoBin, [
+			"install",
+			"iii-engine",
+			"--force"
+		], { label: "Upgrading iii-engine (cargo)" }), "cargo install iii-engine --force");
+		else p.log.info("Skipped cargo-based iii-engine upgrade.");
+	} else p.log.warn("Cargo not found. Skipping iii-engine binary upgrade.");
+	if (dockerBin) runCommand(dockerBin, ["pull", "iiidev/iii:latest"], {
+		label: "Pulling latest iii Docker image",
+		optional: true
+	});
+	else p.log.info("Docker not found. Skipping Docker image refresh.");
+	p.note([
+		"Upgrade flow completed.",
+		"",
+		"Recommended next steps:",
+		"  1) agentmemory status",
+		"  2) npm/pnpm test",
+		"  3) restart agentmemory process"
+	].join("\n"), "agentmemory upgrade");
+}
 async function runMcp() {
-	await import("./standalone-DpxhaZLn.mjs");
+	await import("./standalone-XB9gPYmo.mjs");
 }
 ({
 	status: runStatus,
 	demo: runDemo,
+	upgrade: runUpgrade,
 	mcp: runMcp
 }[args[0] ?? ""] ?? main)().catch((err) => {
 	p.log.error(err instanceof Error ? err.message : String(err));

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":["PATH_DELIMITER"],"sources":["../src/state/schema.ts","../src/cli.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nexport const KV = {\n  sessions: \"mem:sessions\",\n  observations: (sessionId: string) => `mem:obs:${sessionId}`,\n  memories: \"mem:memories\",\n  summaries: \"mem:summaries\",\n  config: \"mem:config\",\n  metrics: \"mem:metrics\",\n  health: \"mem:health\",\n  embeddings: (obsId: string) => `mem:emb:${obsId}`,\n  bm25Index: \"mem:index:bm25\",\n  relations: \"mem:relations\",\n  profiles: \"mem:profiles\",\n  claudeBridge: \"mem:claude-bridge\",\n  graphNodes: \"mem:graph:nodes\",\n  graphEdges: \"mem:graph:edges\",\n  semantic: \"mem:semantic\",\n  procedural: \"mem:procedural\",\n  teamShared: (teamId: string) => `mem:team:${teamId}:shared`,\n  teamUsers: (teamId: string, userId: string) =>\n    `mem:team:${teamId}:users:${userId}`,\n  teamProfile: (teamId: string) => `mem:team:${teamId}:profile`,\n  audit: \"mem:audit\",\n  actions: \"mem:actions\",\n  actionEdges: \"mem:action-edges\",\n  leases: \"mem:leases\",\n  routines: \"mem:routines\",\n  routineRuns: \"mem:routine-runs\",\n  signals: \"mem:signals\",\n  checkpoints: \"mem:checkpoints\",\n  mesh: \"mem:mesh\",\n  sketches: \"mem:sketches\",\n  facets: \"mem:facets\",\n  sentinels: \"mem:sentinels\",\n  crystals: \"mem:crystals\",\n  lessons: \"mem:lessons\",\n  insights: \"mem:insights\",\n  graphEdgeHistory: \"mem:graph:edge-history\",\n  enrichedChunks: (sessionId: string) => `mem:enriched:${sessionId}`,\n  latentEmbeddings: (obsId: string) => `mem:latent:${obsId}`,\n  retentionScores: \"mem:retention\",\n  accessLog: \"mem:access\",\n} as const;\n\nexport const STREAM = {\n  name: \"mem-live\",\n  group: (sessionId: string) => sessionId,\n  viewerGroup: \"viewer\",\n} as const;\n\nexport function generateId(prefix: string): string {\n  const ts = Date.now().toString(36);\n  const rand = crypto.randomUUID().replace(/-/g, \"\").slice(0, 12);\n  return `${prefix}_${ts}_${rand}`;\n}\n\nexport function fingerprintId(prefix: string, content: string): string {\n  const hash = createHash(\"sha256\").update(content).digest(\"hex\");\n  return `${prefix}_${hash.slice(0, 16)}`;\n}\n\nexport function jaccardSimilarity(a: string, b: string): number {\n  const setA = new Set(a.split(/\\s+/).filter((t) => t.length > 2));\n  const setB = new Set(b.split(/\\s+/).filter((t) => t.length > 2));\n  if (setA.size === 0 && setB.size === 0) return 1;\n  if (setA.size === 0 || setB.size === 0) return 0;\n  let intersection = 0;\n  for (const word of setA) {\n    if (setB.has(word)) intersection++;\n  }\n  return intersection / (setA.size + setB.size - intersection);\n}\n","#!/usr/bin/env node\n\nimport { spawn, execFileSync, type ChildProcess } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { join, dirname, delimiter as PATH_DELIMITER } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { platform } from \"node:os\";\nimport * as p from \"@clack/prompts\";\nimport { generateId } from \"./state/schema.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst args = process.argv.slice(2);\nconst IS_WINDOWS = platform() === \"win32\";\nconst IS_VERBOSE = args.includes(\"--verbose\") || args.includes(\"-v\");\n\nfunction vlog(msg: string): void {\n  if (IS_VERBOSE) p.log.info(`[verbose] ${msg}`);\n}\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nagentmemory — persistent memory for AI coding agents\n\nUsage: agentmemory [command] [options]\n\nCommands:\n  (default)          Start agentmemory worker\n  status             Show connection status, memory count, and health\n  demo               Seed sample sessions and show recall in action\n  mcp                Start standalone MCP server (no engine required)\n\nOptions:\n  --help, -h         Show this help\n  --verbose, -v      Show engine stderr and diagnostic info on startup\n  --tools all|core   Tool visibility (default: core = 7 tools)\n  --no-engine        Skip auto-starting iii-engine\n  --port <N>         Override REST port (default: 3111)\n\nQuick start:\n  npx @agentmemory/agentmemory          # start with local iii-engine or Docker\n  npx @agentmemory/agentmemory status   # check health\n  npx @agentmemory/agentmemory demo     # try it in 30 seconds (needs server running)\n  npx @agentmemory/agentmemory mcp      # standalone MCP server (no engine)\n  npx @agentmemory/mcp                  # same as above (shim package)\n`);\n  process.exit(0);\n}\n\nconst toolsIdx = args.indexOf(\"--tools\");\nif (toolsIdx !== -1 && args[toolsIdx + 1]) {\n  process.env[\"AGENTMEMORY_TOOLS\"] = args[toolsIdx + 1];\n}\n\nconst portIdx = args.indexOf(\"--port\");\nif (portIdx !== -1 && args[portIdx + 1]) {\n  process.env[\"III_REST_PORT\"] = args[portIdx + 1];\n}\n\nconst skipEngine = args.includes(\"--no-engine\");\n\nfunction getRestPort(): number {\n  return parseInt(process.env[\"III_REST_PORT\"] || \"3111\", 10) || 3111;\n}\n\nasync function isEngineRunning(): Promise<boolean> {\n  try {\n    await fetch(`http://localhost:${getRestPort()}/`, {\n      signal: AbortSignal.timeout(2000),\n    });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction findIiiConfig(): string {\n  const candidates = [\n    join(__dirname, \"iii-config.yaml\"),\n    join(__dirname, \"..\", \"iii-config.yaml\"),\n    join(process.cwd(), \"iii-config.yaml\"),\n  ];\n  for (const c of candidates) {\n    if (existsSync(c)) return c;\n  }\n  return \"\";\n}\n\nfunction whichBinary(name: string): string | null {\n  const cmd = IS_WINDOWS ? \"where\" : \"which\";\n  try {\n    const out = execFileSync(cmd, [name], { encoding: \"utf-8\" });\n    const first = out\n      .split(/\\r?\\n/)\n      .map((line) => line.trim())\n      .find((line) => line.length > 0);\n    return first ?? null;\n  } catch {\n    return null;\n  }\n}\n\nfunction fallbackIiiPaths(): string[] {\n  if (IS_WINDOWS) {\n    const userProfile = process.env[\"USERPROFILE\"];\n    if (!userProfile) return [];\n    return [\n      join(userProfile, \".local\", \"bin\", \"iii.exe\"),\n      join(userProfile, \"bin\", \"iii.exe\"),\n    ];\n  }\n  const home = process.env[\"HOME\"];\n  if (!home) return [\"/usr/local/bin/iii\"];\n  return [join(home, \".local\", \"bin\", \"iii\"), \"/usr/local/bin/iii\"];\n}\n\ntype StartupFailure = {\n  kind: \"no-engine\" | \"no-docker-compose\" | \"engine-crashed\" | \"docker-crashed\";\n  stderr?: string;\n  binary?: string;\n};\n\nlet startupFailure: StartupFailure | null = null;\n\n// Spawn a background engine and collect any startup stderr for a short\n// window. The process is unref'd so the CLI parent can exit cleanly; we\n// only care about stderr that shows up BEFORE the health check succeeds,\n// which is what surfaces early crash/config-parse errors on all platforms.\nfunction spawnEngineBackground(\n  bin: string,\n  spawnArgs: string[],\n  label: string,\n): ChildProcess {\n  vlog(`spawn: ${bin} ${spawnArgs.join(\" \")}`);\n  const child = spawn(bin, spawnArgs, {\n    detached: true,\n    stdio: [\"ignore\", \"ignore\", \"pipe\"],\n    windowsHide: true,\n  });\n  const stderrChunks: Buffer[] = [];\n  let stderrBytes = 0;\n  const MAX_STDERR_CAPTURE = 16 * 1024;\n  child.stderr?.on(\"data\", (chunk: Buffer) => {\n    if (stderrBytes >= MAX_STDERR_CAPTURE) return;\n    const slice = chunk.subarray(0, MAX_STDERR_CAPTURE - stderrBytes);\n    stderrChunks.push(slice);\n    stderrBytes += slice.length;\n  });\n  child.on(\"exit\", (code, signal) => {\n    const abnormal =\n      (code !== null && code !== 0) || (code === null && signal !== null);\n    if (abnormal) {\n      const stderr = Buffer.concat(stderrChunks).toString(\"utf-8\");\n      startupFailure = {\n        kind: label.includes(\"Docker\") ? \"docker-crashed\" : \"engine-crashed\",\n        stderr:\n          stderr.trim() ||\n          (signal\n            ? `process killed by signal ${signal}`\n            : `process exited with code ${code}`),\n        binary: bin,\n      };\n      vlog(`engine exited early: code=${code} signal=${signal}`);\n      if (IS_VERBOSE && stderr.trim()) {\n        p.log.error(`engine stderr:\\n${stderr}`);\n      }\n    }\n  });\n  child.unref();\n  return child;\n}\n\nasync function startEngine(): Promise<boolean> {\n  const configPath = findIiiConfig();\n  let iiiBin = whichBinary(\"iii\");\n  vlog(`iii binary: ${iiiBin ?? \"(not on PATH)\"}, config: ${configPath || \"(not found)\"}`);\n\n  if (iiiBin && configPath) {\n    const s = p.spinner();\n    s.start(`Starting iii-engine: ${iiiBin}`);\n    spawnEngineBackground(iiiBin, [\"--config\", configPath], \"iii-engine\");\n    s.stop(\"iii-engine process started\");\n    return true;\n  }\n\n  const dockerBin = whichBinary(\"docker\");\n  vlog(`docker binary: ${dockerBin ?? \"(not on PATH)\"}`);\n  const dockerComposeCandidates = [\n    join(__dirname, \"..\", \"docker-compose.yml\"),\n    join(__dirname, \"docker-compose.yml\"),\n    join(process.cwd(), \"docker-compose.yml\"),\n  ];\n  const composeFile = dockerComposeCandidates.find((c) => existsSync(c));\n  vlog(`docker-compose.yml: ${composeFile ?? \"(not found)\"}`);\n\n  if (dockerBin && composeFile) {\n    const s = p.spinner();\n    s.start(\"Starting iii-engine via Docker...\");\n    spawnEngineBackground(\n      dockerBin,\n      [\"compose\", \"-f\", composeFile, \"up\", \"-d\"],\n      \"iii-engine via Docker\",\n    );\n    s.stop(\"Docker compose started\");\n    return true;\n  }\n\n  for (const iiiPath of fallbackIiiPaths()) {\n    if (existsSync(iiiPath)) {\n      p.log.info(`Found iii at: ${iiiPath}`);\n      process.env[\"PATH\"] = `${dirname(iiiPath)}${PATH_DELIMITER}${process.env[\"PATH\"] ?? \"\"}`;\n      iiiBin = iiiPath;\n      break;\n    }\n  }\n\n  if (iiiBin && configPath) {\n    const s = p.spinner();\n    s.start(`Starting iii-engine: ${iiiBin}`);\n    spawnEngineBackground(iiiBin, [\"--config\", configPath], \"iii-engine\");\n    s.stop(\"iii-engine process started\");\n    return true;\n  }\n\n  if (!iiiBin && (!dockerBin || !composeFile)) {\n    startupFailure = { kind: \"no-engine\" };\n  } else if (!composeFile && dockerBin) {\n    startupFailure = { kind: \"no-docker-compose\" };\n  }\n  return false;\n}\n\nasync function waitForEngine(timeoutMs: number): Promise<boolean> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    if (await isEngineRunning()) return true;\n    await new Promise((r) => setTimeout(r, 500));\n  }\n  return false;\n}\n\nfunction installInstructions(): string[] {\n  if (IS_WINDOWS) {\n    return [\n      \"agentmemory requires the `iii-engine` runtime. Pick one:\",\n      \"\",\n      \"  A) Download the prebuilt Windows binary:\",\n      \"     1. Open https://github.com/iii-hq/iii/releases/latest\",\n      \"     2. Download iii-x86_64-pc-windows-msvc.zip\",\n      \"        (or iii-aarch64-pc-windows-msvc.zip on ARM)\",\n      \"     3. Extract iii.exe and either add its folder to PATH\",\n      \"        or move it to %USERPROFILE%\\\\.local\\\\bin\\\\iii.exe\",\n      \"     4. Re-run: npx @agentmemory/agentmemory\",\n      \"\",\n      \"  B) Docker Desktop:\",\n      \"     1. Install Docker Desktop for Windows\",\n      \"     2. Start Docker Desktop (engine must be running)\",\n      \"     3. Re-run: npx @agentmemory/agentmemory\",\n      \"\",\n      \"Or skip the engine entirely for standalone MCP:\",\n      \"  npx @agentmemory/agentmemory mcp\",\n    ];\n  }\n  return [\n    \"agentmemory requires the `iii-engine` runtime. Pick one:\",\n    \"\",\n    \"  A) curl -fsSL https://install.iii.dev/iii/main/install.sh | sh\",\n    \"     (installs the prebuilt iii binary into ~/.local/bin/iii)\",\n    \"\",\n    \"  B) Docker: install Docker Desktop or docker-ce, then re-run\",\n    \"\",\n    \"Or skip the engine entirely for standalone MCP:\",\n    \"  npx @agentmemory/agentmemory mcp\",\n    \"\",\n    \"Docs: https://iii.dev/docs\",\n  ];\n}\n\nfunction portInUseDiagnostic(port: number): string {\n  return IS_WINDOWS\n    ? `  netstat -ano | findstr :${port}`\n    : `  lsof -i :${port}   # or: ss -tlnp | grep :${port}`;\n}\n\nasync function main() {\n  p.intro(\"agentmemory\");\n\n  if (skipEngine) {\n    p.log.info(\"Skipping engine check (--no-engine)\");\n    await import(\"./index.js\");\n    return;\n  }\n\n  if (await isEngineRunning()) {\n    p.log.success(\"iii-engine is running\");\n    await import(\"./index.js\");\n    return;\n  }\n\n  const started = await startEngine();\n  if (!started) {\n    p.log.error(\"Could not start iii-engine.\");\n    const lines = installInstructions();\n    if (startupFailure?.kind === \"no-docker-compose\") {\n      lines.unshift(\n        \"Docker is installed but docker-compose.yml is missing from this\",\n        \"install. Re-install with: npm install -g @agentmemory/agentmemory\",\n        \"\",\n      );\n    }\n    p.note(lines.join(\"\\n\"), \"Setup required\");\n    process.exit(1);\n  }\n\n  const s = p.spinner();\n  s.start(\"Waiting for iii-engine to be ready...\");\n\n  const ready = await waitForEngine(15000);\n  if (!ready) {\n    const port = getRestPort();\n    s.stop(\"iii-engine did not become ready within 15s\");\n\n    if (startupFailure?.kind === \"engine-crashed\" || startupFailure?.kind === \"docker-crashed\") {\n      p.log.error(\"The iii-engine process crashed on startup.\");\n      if (startupFailure.binary) {\n        p.log.info(`Binary: ${startupFailure.binary}`);\n      }\n      if (startupFailure.stderr) {\n        p.note(startupFailure.stderr, \"engine stderr\");\n      } else {\n        p.log.info(\"No stderr was captured. Re-run with --verbose for more detail.\");\n      }\n      p.note(\n        [\n          \"Common causes:\",\n          \"  - iii-engine version mismatch — reinstall the latest binary\",\n          \"    (sh script on macOS/Linux, GitHub release zip on Windows)\",\n          \"  - Docker Desktop not running (if you're using the Docker path)\",\n          \"  - Port already in use (see below)\",\n          \"\",\n          \"See https://iii.dev/docs for current install instructions.\",\n        ].join(\"\\n\"),\n        \"Troubleshooting\",\n      );\n    } else {\n      p.log.error(\"The engine process started but the REST API never responded.\");\n      p.note(\n        [\n          `Check whether port ${port} is already bound by another process:`,\n          portInUseDiagnostic(port),\n          \"\",\n          \"If it is, free the port or override: agentmemory --port <N>\",\n          \"\",\n          \"If it isn't, a firewall may be blocking 127.0.0.1:\" + port + \".\",\n          \"Re-run with --verbose to see engine stderr.\",\n        ].join(\"\\n\"),\n        \"Troubleshooting\",\n      );\n    }\n    process.exit(1);\n  }\n\n  s.stop(\"iii-engine is ready\");\n  await import(\"./index.js\");\n}\n\nasync function runStatus() {\n  const port = getRestPort();\n  const base = `http://localhost:${port}`;\n  p.intro(\"agentmemory status\");\n\n  const up = await isEngineRunning();\n  if (!up) {\n    p.log.error(`Not running — no response on port ${port}`);\n    p.log.info(\"Start with: npx @agentmemory/agentmemory\");\n    process.exit(1);\n  }\n\n  try {\n    const [healthRes, sessionsRes, graphRes, memoriesRes] = await Promise.all([\n      fetch(`${base}/agentmemory/health`, { signal: AbortSignal.timeout(5000) }).then((r) => r.json()).catch(() => null),\n      fetch(`${base}/agentmemory/sessions`, { signal: AbortSignal.timeout(5000) }).then((r) => r.json()).catch(() => null),\n      fetch(`${base}/agentmemory/graph/stats`, { signal: AbortSignal.timeout(5000) }).then((r) => r.json()).catch(() => null),\n      fetch(`${base}/agentmemory/export`, { signal: AbortSignal.timeout(5000) }).then((r) => r.json()).catch(() => null),\n    ]);\n\n    const h = healthRes?.health;\n    const status = healthRes?.status || \"unknown\";\n    const version = healthRes?.version || \"?\";\n    const sessions = Array.isArray(sessionsRes?.sessions) ? sessionsRes.sessions.length : 0;\n    const nodes = graphRes?.nodes || 0;\n    const edges = graphRes?.edges || 0;\n    const cb = healthRes?.circuitBreaker?.state || \"closed\";\n    const heapMB = h?.memory ? Math.round(h.memory.heapUsed / 1048576) : 0;\n    const uptime = h?.uptimeSeconds ? Math.round(h.uptimeSeconds) : 0;\n\n    const obsCount = memoriesRes?.observations?.length || 0;\n    const memCount = memoriesRes?.memories?.length || 0;\n    const estFullTokens = obsCount * 80;\n    const estInjectedTokens = Math.min(obsCount, 50) * 38;\n    const tokensSaved = estFullTokens - estInjectedTokens;\n    const pctSaved = estFullTokens > 0 ? Math.round((tokensSaved / estFullTokens) * 100) : 0;\n\n    p.log.success(`Connected — v${version} on port ${port}`);\n\n    const lines = [\n      `Health:       ${status === \"healthy\" ? \"✓ healthy\" : status}`,\n      `Sessions:     ${sessions}`,\n      `Observations: ${obsCount}`,\n      `Memories:     ${memCount}`,\n      `Graph:        ${nodes} nodes, ${edges} edges`,\n      `Circuit:      ${cb}`,\n      `Heap:         ${heapMB} MB`,\n      `Uptime:       ${uptime}s`,\n      `Viewer:       http://localhost:${port + 2}`,\n    ];\n\n    if (obsCount > 0) {\n      lines.push(\"\");\n      lines.push(`Token savings: ~${tokensSaved.toLocaleString()} tokens saved (${pctSaved}% reduction)`);\n      lines.push(`  Full context: ~${estFullTokens.toLocaleString()} tokens`);\n      lines.push(`  Injected:     ~${estInjectedTokens.toLocaleString()} tokens`);\n    }\n\n    p.note(lines.join(\"\\n\"), \"agentmemory\");\n  } catch (err) {\n    p.log.error(err instanceof Error ? err.message : String(err));\n    process.exit(1);\n  }\n}\n\ntype DemoObservation = {\n  toolName: string;\n  toolInput: Record<string, string>;\n  toolOutput: string;\n};\n\ntype DemoSession = {\n  id: string;\n  title: string;\n  observations: DemoObservation[];\n};\n\ntype SearchResult = { query: string; hits: number; topTitle: string };\n\nfunction buildDemoSessions(): DemoSession[] {\n  return [\n    {\n      id: generateId(\"demo\"),\n      title: \"Session 1: JWT auth setup\",\n      observations: [\n        {\n          toolName: \"Write\",\n          toolInput: { file_path: \"src/middleware/auth.ts\" },\n          toolOutput:\n            \"Created JWT middleware using jose library. Tokens expire after 30 days. Chose jose over jsonwebtoken for Edge compatibility.\",\n        },\n        {\n          toolName: \"Write\",\n          toolInput: { file_path: \"test/auth.test.ts\" },\n          toolOutput:\n            \"Added token validation tests covering expired, malformed, and valid cases.\",\n        },\n        {\n          toolName: \"Bash\",\n          toolInput: { command: \"npm test\" },\n          toolOutput: \"All 12 auth tests passing.\",\n        },\n      ],\n    },\n    {\n      id: generateId(\"demo\"),\n      title: \"Session 2: Database migration debugging\",\n      observations: [\n        {\n          toolName: \"Read\",\n          toolInput: { file_path: \"prisma/schema.prisma\" },\n          toolOutput:\n            \"Found N+1 query issue in user relations. Need to add include on posts query.\",\n        },\n        {\n          toolName: \"Edit\",\n          toolInput: { file_path: \"src/api/users.ts\" },\n          toolOutput:\n            \"Fixed N+1 by adding Prisma include. Query time dropped from 450ms to 28ms.\",\n        },\n      ],\n    },\n    {\n      id: generateId(\"demo\"),\n      title: \"Session 3: Rate limiting\",\n      observations: [\n        {\n          toolName: \"Write\",\n          toolInput: { file_path: \"src/middleware/ratelimit.ts\" },\n          toolOutput:\n            \"Added rate limiting middleware with 100 req/min default. Uses in-memory store for dev, Redis for prod.\",\n        },\n      ],\n    },\n  ];\n}\n\nasync function postJson<T = unknown>(\n  url: string,\n  body: unknown,\n  timeoutMs = 5000,\n): Promise<T | null> {\n  try {\n    const res = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(timeoutMs),\n    });\n    if (!res.ok) return null;\n    return (await res.json().catch(() => null)) as T | null;\n  } catch {\n    return null;\n  }\n}\n\nasync function postJsonStrict<T = unknown>(\n  url: string,\n  body: unknown,\n  timeoutMs = 5000,\n): Promise<T | null> {\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify(body),\n    signal: AbortSignal.timeout(timeoutMs),\n  });\n  if (!res.ok) {\n    const errBody = await res.text().catch(() => \"\");\n    const suffix = errBody ? ` — ${errBody.slice(0, 200)}` : \"\";\n    throw new Error(`POST ${url} failed: ${res.status} ${res.statusText}${suffix}`);\n  }\n  return (await res.json().catch(() => null)) as T | null;\n}\n\nasync function seedDemoSession(\n  base: string,\n  project: string,\n  session: DemoSession,\n): Promise<number> {\n  await postJsonStrict(`${base}/agentmemory/session/start`, {\n    sessionId: session.id,\n    project,\n    cwd: project,\n  });\n\n  let stored = 0;\n  for (const obs of session.observations) {\n    const url = `${base}/agentmemory/observe`;\n    const payload = {\n      hookType: \"post_tool_use\",\n      sessionId: session.id,\n      timestamp: new Date().toISOString(),\n      data: {\n        tool_name: obs.toolName,\n        tool_input: obs.toolInput,\n        tool_output: obs.toolOutput,\n      },\n    };\n\n    try {\n      const res = await fetch(url, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(payload),\n        signal: AbortSignal.timeout(5000),\n      });\n      if (res.ok) {\n        stored++;\n      } else {\n        const body = await res.text().catch(() => \"\");\n        p.log.warn(\n          `observe failed for ${obs.toolName}: ${res.status} ${res.statusText}${body ? ` — ${body.slice(0, 160)}` : \"\"}`,\n        );\n      }\n    } catch (err) {\n      p.log.warn(\n        `observe request failed for ${obs.toolName}: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  await postJsonStrict(`${base}/agentmemory/session/end`, { sessionId: session.id });\n  return stored;\n}\n\nasync function runDemoSearch(base: string, query: string): Promise<SearchResult> {\n  const data = await postJson<{ results?: Array<{ title?: string }> }>(\n    `${base}/agentmemory/smart-search`,\n    { query, limit: 5 },\n    10000,\n  );\n  const items = data?.results ?? [];\n  return {\n    query,\n    hits: items.length,\n    topTitle: items[0]?.title ?? \"(no results)\",\n  };\n}\n\nasync function runDemo() {\n  const port = getRestPort();\n  const base = `http://localhost:${port}`;\n  p.intro(\"agentmemory demo\");\n\n  if (!(await isEngineRunning())) {\n    p.log.error(`Not running — no response on port ${port}`);\n    p.log.info(\"Start the server first: npx @agentmemory/agentmemory\");\n    process.exit(1);\n  }\n\n  const demoProject = \"/tmp/agentmemory-demo\";\n  const sessions = buildDemoSessions();\n\n  const sSeed = p.spinner();\n  sSeed.start(\"Seeding 3 demo sessions with realistic observations...\");\n\n  let totalObs = 0;\n  for (const session of sessions) {\n    totalObs += await seedDemoSession(base, demoProject, session);\n  }\n\n  sSeed.stop(`Seeded ${totalObs} observations across ${sessions.length} sessions`);\n\n  const queries = [\n    \"jwt auth middleware\",\n    \"database performance optimization\",\n    \"rate limiting\",\n  ];\n\n  const sQuery = p.spinner();\n  sQuery.start(`Running ${queries.length} smart-search queries...`);\n\n  const results: SearchResult[] = [];\n  for (const query of queries) {\n    results.push(await runDemoSearch(base, query));\n  }\n\n  sQuery.stop(\"Search complete\");\n\n  const lines = [\n    `Project:       ${demoProject}`,\n    `Sessions:      ${sessions.length} seeded (${totalObs} observations)`,\n    \"\",\n    \"Search results:\",\n    ...results.flatMap((r) => [\n      `  \"${r.query}\"`,\n      `    → ${r.hits} hit(s), top: ${r.topTitle.slice(0, 60)}`,\n    ]),\n    \"\",\n    `Notice: searching \"database performance optimization\"`,\n    `found the N+1 query fix — keyword matching can't do that.`,\n    \"\",\n    `Viewer:        http://localhost:${port + 2}`,\n    `Clean up with: curl -X DELETE \"${base}/agentmemory/sessions?project=${demoProject}\"`,\n  ];\n\n  p.note(lines.join(\"\\n\"), \"demo complete\");\n  p.log.success(\"agentmemory is working. Point your agent at it and get back to coding.\");\n}\n\nasync function runMcp(): Promise<void> {\n  await import(\"./mcp/standalone.js\");\n}\n\nconst commands: Record<string, () => Promise<void>> = {\n  status: runStatus,\n  demo: runDemo,\n  mcp: runMcp,\n};\n\nconst handler = commands[args[0] ?? \"\"] ?? main;\nhandler().catch((err) => {\n  p.log.error(err instanceof Error ? err.message : String(err));\n  process.exit(1);\n});\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":["PATH_DELIMITER"],"sources":["../src/state/schema.ts","../src/cli.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nexport const KV = {\n  sessions: \"mem:sessions\",\n  observations: (sessionId: string) => `mem:obs:${sessionId}`,\n  memories: \"mem:memories\",\n  summaries: \"mem:summaries\",\n  config: \"mem:config\",\n  metrics: \"mem:metrics\",\n  health: \"mem:health\",\n  embeddings: (obsId: string) => `mem:emb:${obsId}`,\n  bm25Index: \"mem:index:bm25\",\n  relations: \"mem:relations\",\n  profiles: \"mem:profiles\",\n  claudeBridge: \"mem:claude-bridge\",\n  graphNodes: \"mem:graph:nodes\",\n  graphEdges: \"mem:graph:edges\",\n  semantic: \"mem:semantic\",\n  procedural: \"mem:procedural\",\n  teamShared: (teamId: string) => `mem:team:${teamId}:shared`,\n  teamUsers: (teamId: string, userId: string) =>\n    `mem:team:${teamId}:users:${userId}`,\n  teamProfile: (teamId: string) => `mem:team:${teamId}:profile`,\n  audit: \"mem:audit\",\n  actions: \"mem:actions\",\n  actionEdges: \"mem:action-edges\",\n  leases: \"mem:leases\",\n  routines: \"mem:routines\",\n  routineRuns: \"mem:routine-runs\",\n  signals: \"mem:signals\",\n  checkpoints: \"mem:checkpoints\",\n  mesh: \"mem:mesh\",\n  sketches: \"mem:sketches\",\n  facets: \"mem:facets\",\n  sentinels: \"mem:sentinels\",\n  crystals: \"mem:crystals\",\n  lessons: \"mem:lessons\",\n  insights: \"mem:insights\",\n  graphEdgeHistory: \"mem:graph:edge-history\",\n  enrichedChunks: (sessionId: string) => `mem:enriched:${sessionId}`,\n  latentEmbeddings: (obsId: string) => `mem:latent:${obsId}`,\n  retentionScores: \"mem:retention\",\n  accessLog: \"mem:access\",\n} as const;\n\nexport const STREAM = {\n  name: \"mem-live\",\n  group: (sessionId: string) => sessionId,\n  viewerGroup: \"viewer\",\n} as const;\n\nexport function generateId(prefix: string): string {\n  const ts = Date.now().toString(36);\n  const rand = crypto.randomUUID().replace(/-/g, \"\").slice(0, 12);\n  return `${prefix}_${ts}_${rand}`;\n}\n\nexport function fingerprintId(prefix: string, content: string): string {\n  const hash = createHash(\"sha256\").update(content).digest(\"hex\");\n  return `${prefix}_${hash.slice(0, 16)}`;\n}\n\nexport function jaccardSimilarity(a: string, b: string): number {\n  const setA = new Set(a.split(/\\s+/).filter((t) => t.length > 2));\n  const setB = new Set(b.split(/\\s+/).filter((t) => t.length > 2));\n  if (setA.size === 0 && setB.size === 0) return 1;\n  if (setA.size === 0 || setB.size === 0) return 0;\n  let intersection = 0;\n  for (const word of setA) {\n    if (setB.has(word)) intersection++;\n  }\n  return intersection / (setA.size + setB.size - intersection);\n}\n","#!/usr/bin/env node\n\nimport {\n  spawn,\n  execFileSync,\n  spawnSync,\n  type ChildProcess,\n} from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { join, dirname, delimiter as PATH_DELIMITER } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { platform } from \"node:os\";\nimport * as p from \"@clack/prompts\";\nimport { generateId } from \"./state/schema.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst args = process.argv.slice(2);\nconst IS_WINDOWS = platform() === \"win32\";\nconst IS_VERBOSE = args.includes(\"--verbose\") || args.includes(\"-v\");\n\nfunction vlog(msg: string): void {\n  if (IS_VERBOSE) p.log.info(`[verbose] ${msg}`);\n}\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nagentmemory — persistent memory for AI coding agents\n\nUsage: agentmemory [command] [options]\n\nCommands:\n  (default)          Start agentmemory worker\n  status             Show connection status, memory count, and health\n  demo               Seed sample sessions and show recall in action\n  upgrade            Upgrade local deps + iii runtime (best effort)\n  mcp                Start standalone MCP server (no engine required)\n\nOptions:\n  --help, -h         Show this help\n  --verbose, -v      Show engine stderr and diagnostic info on startup\n  --tools all|core   Tool visibility (default: core = 7 tools)\n  --no-engine        Skip auto-starting iii-engine\n  --port <N>         Override REST port (default: 3111)\n\nQuick start:\n  npx @agentmemory/agentmemory          # start with local iii-engine or Docker\n  npx @agentmemory/agentmemory status   # check health\n  npx @agentmemory/agentmemory demo     # try it in 30 seconds (needs server running)\n  npx @agentmemory/agentmemory upgrade  # upgrade agentmemory + iii runtime\n  npx @agentmemory/agentmemory mcp      # standalone MCP server (no engine)\n  npx @agentmemory/mcp                  # same as above (shim package)\n`);\n  process.exit(0);\n}\n\nconst toolsIdx = args.indexOf(\"--tools\");\nif (toolsIdx !== -1 && args[toolsIdx + 1]) {\n  process.env[\"AGENTMEMORY_TOOLS\"] = args[toolsIdx + 1];\n}\n\nconst portIdx = args.indexOf(\"--port\");\nif (portIdx !== -1 && args[portIdx + 1]) {\n  process.env[\"III_REST_PORT\"] = args[portIdx + 1];\n}\n\nconst skipEngine = args.includes(\"--no-engine\");\n\nfunction getRestPort(): number {\n  return parseInt(process.env[\"III_REST_PORT\"] || \"3111\", 10) || 3111;\n}\n\nasync function isEngineRunning(): Promise<boolean> {\n  try {\n    await fetch(`http://localhost:${getRestPort()}/`, {\n      signal: AbortSignal.timeout(2000),\n    });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction findIiiConfig(): string {\n  const candidates = [\n    join(__dirname, \"iii-config.yaml\"),\n    join(__dirname, \"..\", \"iii-config.yaml\"),\n    join(process.cwd(), \"iii-config.yaml\"),\n  ];\n  for (const c of candidates) {\n    if (existsSync(c)) return c;\n  }\n  return \"\";\n}\n\nfunction whichBinary(name: string): string | null {\n  const cmd = IS_WINDOWS ? \"where\" : \"which\";\n  try {\n    const out = execFileSync(cmd, [name], { encoding: \"utf-8\" });\n    const first = out\n      .split(/\\r?\\n/)\n      .map((line) => line.trim())\n      .find((line) => line.length > 0);\n    return first ?? null;\n  } catch {\n    return null;\n  }\n}\n\nfunction fallbackIiiPaths(): string[] {\n  if (IS_WINDOWS) {\n    const userProfile = process.env[\"USERPROFILE\"];\n    if (!userProfile) return [];\n    return [\n      join(userProfile, \".local\", \"bin\", \"iii.exe\"),\n      join(userProfile, \"bin\", \"iii.exe\"),\n    ];\n  }\n  const home = process.env[\"HOME\"];\n  if (!home) return [\"/usr/local/bin/iii\"];\n  return [join(home, \".local\", \"bin\", \"iii\"), \"/usr/local/bin/iii\"];\n}\n\ntype StartupFailure = {\n  kind: \"no-engine\" | \"no-docker-compose\" | \"engine-crashed\" | \"docker-crashed\";\n  stderr?: string;\n  binary?: string;\n};\n\nlet startupFailure: StartupFailure | null = null;\n\n// Spawn a background engine and collect any startup stderr for a short\n// window. The process is unref'd so the CLI parent can exit cleanly; we\n// only care about stderr that shows up BEFORE the health check succeeds,\n// which is what surfaces early crash/config-parse errors on all platforms.\nfunction spawnEngineBackground(\n  bin: string,\n  spawnArgs: string[],\n  label: string,\n): ChildProcess {\n  vlog(`spawn: ${bin} ${spawnArgs.join(\" \")}`);\n  const child = spawn(bin, spawnArgs, {\n    detached: true,\n    stdio: [\"ignore\", \"ignore\", \"pipe\"],\n    windowsHide: true,\n  });\n  const stderrChunks: Buffer[] = [];\n  let stderrBytes = 0;\n  const MAX_STDERR_CAPTURE = 16 * 1024;\n  child.stderr?.on(\"data\", (chunk: Buffer) => {\n    if (stderrBytes >= MAX_STDERR_CAPTURE) return;\n    const slice = chunk.subarray(0, MAX_STDERR_CAPTURE - stderrBytes);\n    stderrChunks.push(slice);\n    stderrBytes += slice.length;\n  });\n  child.on(\"exit\", (code, signal) => {\n    const abnormal =\n      (code !== null && code !== 0) || (code === null && signal !== null);\n    if (abnormal) {\n      const stderr = Buffer.concat(stderrChunks).toString(\"utf-8\");\n      startupFailure = {\n        kind: label.includes(\"Docker\") ? \"docker-crashed\" : \"engine-crashed\",\n        stderr:\n          stderr.trim() ||\n          (signal\n            ? `process killed by signal ${signal}`\n            : `process exited with code ${code}`),\n        binary: bin,\n      };\n      vlog(`engine exited early: code=${code} signal=${signal}`);\n      if (IS_VERBOSE && stderr.trim()) {\n        p.log.error(`engine stderr:\\n${stderr}`);\n      }\n    }\n  });\n  child.unref();\n  return child;\n}\n\nasync function startEngine(): Promise<boolean> {\n  const configPath = findIiiConfig();\n  let iiiBin = whichBinary(\"iii\");\n  vlog(`iii binary: ${iiiBin ?? \"(not on PATH)\"}, config: ${configPath || \"(not found)\"}`);\n\n  if (iiiBin && configPath) {\n    const s = p.spinner();\n    s.start(`Starting iii-engine: ${iiiBin}`);\n    spawnEngineBackground(iiiBin, [\"--config\", configPath], \"iii-engine\");\n    s.stop(\"iii-engine process started\");\n    return true;\n  }\n\n  const dockerBin = whichBinary(\"docker\");\n  vlog(`docker binary: ${dockerBin ?? \"(not on PATH)\"}`);\n  const dockerComposeCandidates = [\n    join(__dirname, \"..\", \"docker-compose.yml\"),\n    join(__dirname, \"docker-compose.yml\"),\n    join(process.cwd(), \"docker-compose.yml\"),\n  ];\n  const composeFile = dockerComposeCandidates.find((c) => existsSync(c));\n  vlog(`docker-compose.yml: ${composeFile ?? \"(not found)\"}`);\n\n  if (dockerBin && composeFile) {\n    const s = p.spinner();\n    s.start(\"Starting iii-engine via Docker...\");\n    spawnEngineBackground(\n      dockerBin,\n      [\"compose\", \"-f\", composeFile, \"up\", \"-d\"],\n      \"iii-engine via Docker\",\n    );\n    s.stop(\"Docker compose started\");\n    return true;\n  }\n\n  for (const iiiPath of fallbackIiiPaths()) {\n    if (existsSync(iiiPath)) {\n      p.log.info(`Found iii at: ${iiiPath}`);\n      process.env[\"PATH\"] = `${dirname(iiiPath)}${PATH_DELIMITER}${process.env[\"PATH\"] ?? \"\"}`;\n      iiiBin = iiiPath;\n      break;\n    }\n  }\n\n  if (iiiBin && configPath) {\n    const s = p.spinner();\n    s.start(`Starting iii-engine: ${iiiBin}`);\n    spawnEngineBackground(iiiBin, [\"--config\", configPath], \"iii-engine\");\n    s.stop(\"iii-engine process started\");\n    return true;\n  }\n\n  if (!iiiBin && (!dockerBin || !composeFile)) {\n    startupFailure = { kind: \"no-engine\" };\n  } else if (!composeFile && dockerBin) {\n    startupFailure = { kind: \"no-docker-compose\" };\n  }\n  return false;\n}\n\nasync function waitForEngine(timeoutMs: number): Promise<boolean> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    if (await isEngineRunning()) return true;\n    await new Promise((r) => setTimeout(r, 500));\n  }\n  return false;\n}\n\nfunction installInstructions(): string[] {\n  if (IS_WINDOWS) {\n    return [\n      \"agentmemory requires the `iii-engine` runtime. Pick one:\",\n      \"\",\n      \"  A) Download the prebuilt Windows binary:\",\n      \"     1. Open https://github.com/iii-hq/iii/releases/latest\",\n      \"     2. Download iii-x86_64-pc-windows-msvc.zip\",\n      \"        (or iii-aarch64-pc-windows-msvc.zip on ARM)\",\n      \"     3. Extract iii.exe and either add its folder to PATH\",\n      \"        or move it to %USERPROFILE%\\\\.local\\\\bin\\\\iii.exe\",\n      \"     4. Re-run: npx @agentmemory/agentmemory\",\n      \"\",\n      \"  B) Docker Desktop:\",\n      \"     1. Install Docker Desktop for Windows\",\n      \"     2. Start Docker Desktop (engine must be running)\",\n      \"     3. Re-run: npx @agentmemory/agentmemory\",\n      \"\",\n      \"Or skip the engine entirely for standalone MCP:\",\n      \"  npx @agentmemory/agentmemory mcp\",\n    ];\n  }\n  return [\n    \"agentmemory requires the `iii-engine` runtime. Pick one:\",\n    \"\",\n    \"  A) curl -fsSL https://install.iii.dev/iii/main/install.sh | sh\",\n    \"     (installs the prebuilt iii binary into ~/.local/bin/iii)\",\n    \"\",\n    \"  B) Docker: install Docker Desktop or docker-ce, then re-run\",\n    \"\",\n    \"Or skip the engine entirely for standalone MCP:\",\n    \"  npx @agentmemory/agentmemory mcp\",\n    \"\",\n    \"Docs: https://iii.dev/docs\",\n  ];\n}\n\nfunction portInUseDiagnostic(port: number): string {\n  return IS_WINDOWS\n    ? `  netstat -ano | findstr :${port}`\n    : `  lsof -i :${port}   # or: ss -tlnp | grep :${port}`;\n}\n\nasync function main() {\n  p.intro(\"agentmemory\");\n\n  if (skipEngine) {\n    p.log.info(\"Skipping engine check (--no-engine)\");\n    await import(\"./index.js\");\n    return;\n  }\n\n  if (await isEngineRunning()) {\n    p.log.success(\"iii-engine is running\");\n    await import(\"./index.js\");\n    return;\n  }\n\n  const started = await startEngine();\n  if (!started) {\n    p.log.error(\"Could not start iii-engine.\");\n    const lines = installInstructions();\n    if (startupFailure?.kind === \"no-docker-compose\") {\n      lines.unshift(\n        \"Docker is installed but docker-compose.yml is missing from this\",\n        \"install. Re-install with: npm install -g @agentmemory/agentmemory\",\n        \"\",\n      );\n    }\n    p.note(lines.join(\"\\n\"), \"Setup required\");\n    process.exit(1);\n  }\n\n  const s = p.spinner();\n  s.start(\"Waiting for iii-engine to be ready...\");\n\n  const ready = await waitForEngine(15000);\n  if (!ready) {\n    const port = getRestPort();\n    s.stop(\"iii-engine did not become ready within 15s\");\n\n    if (startupFailure?.kind === \"engine-crashed\" || startupFailure?.kind === \"docker-crashed\") {\n      p.log.error(\"The iii-engine process crashed on startup.\");\n      if (startupFailure.binary) {\n        p.log.info(`Binary: ${startupFailure.binary}`);\n      }\n      if (startupFailure.stderr) {\n        p.note(startupFailure.stderr, \"engine stderr\");\n      } else {\n        p.log.info(\"No stderr was captured. Re-run with --verbose for more detail.\");\n      }\n      p.note(\n        [\n          \"Common causes:\",\n          \"  - iii-engine version mismatch — reinstall the latest binary\",\n          \"    (sh script on macOS/Linux, GitHub release zip on Windows)\",\n          \"  - Docker Desktop not running (if you're using the Docker path)\",\n          \"  - Port already in use (see below)\",\n          \"\",\n          \"See https://iii.dev/docs for current install instructions.\",\n        ].join(\"\\n\"),\n        \"Troubleshooting\",\n      );\n    } else {\n      p.log.error(\"The engine process started but the REST API never responded.\");\n      p.note(\n        [\n          `Check whether port ${port} is already bound by another process:`,\n          portInUseDiagnostic(port),\n          \"\",\n          \"If it is, free the port or override: agentmemory --port <N>\",\n          \"\",\n          \"If it isn't, a firewall may be blocking 127.0.0.1:\" + port + \".\",\n          \"Re-run with --verbose to see engine stderr.\",\n        ].join(\"\\n\"),\n        \"Troubleshooting\",\n      );\n    }\n    process.exit(1);\n  }\n\n  s.stop(\"iii-engine is ready\");\n  await import(\"./index.js\");\n}\n\nasync function runStatus() {\n  const port = getRestPort();\n  const base = `http://localhost:${port}`;\n  p.intro(\"agentmemory status\");\n\n  const up = await isEngineRunning();\n  if (!up) {\n    p.log.error(`Not running — no response on port ${port}`);\n    p.log.info(\"Start with: npx @agentmemory/agentmemory\");\n    process.exit(1);\n  }\n\n  try {\n    const [healthRes, sessionsRes, graphRes, memoriesRes] = await Promise.all([\n      fetch(`${base}/agentmemory/health`, { signal: AbortSignal.timeout(5000) }).then((r) => r.json()).catch(() => null),\n      fetch(`${base}/agentmemory/sessions`, { signal: AbortSignal.timeout(5000) }).then((r) => r.json()).catch(() => null),\n      fetch(`${base}/agentmemory/graph/stats`, { signal: AbortSignal.timeout(5000) }).then((r) => r.json()).catch(() => null),\n      fetch(`${base}/agentmemory/export`, { signal: AbortSignal.timeout(5000) }).then((r) => r.json()).catch(() => null),\n    ]);\n\n    const h = healthRes?.health;\n    const status = healthRes?.status || \"unknown\";\n    const version = healthRes?.version || \"?\";\n    const sessions = Array.isArray(sessionsRes?.sessions) ? sessionsRes.sessions.length : 0;\n    const nodes = graphRes?.nodes || 0;\n    const edges = graphRes?.edges || 0;\n    const cb = healthRes?.circuitBreaker?.state || \"closed\";\n    const heapMB = h?.memory ? Math.round(h.memory.heapUsed / 1048576) : 0;\n    const uptime = h?.uptimeSeconds ? Math.round(h.uptimeSeconds) : 0;\n\n    const obsCount = memoriesRes?.observations?.length || 0;\n    const memCount = memoriesRes?.memories?.length || 0;\n    const estFullTokens = obsCount * 80;\n    const estInjectedTokens = Math.min(obsCount, 50) * 38;\n    const tokensSaved = estFullTokens - estInjectedTokens;\n    const pctSaved = estFullTokens > 0 ? Math.round((tokensSaved / estFullTokens) * 100) : 0;\n\n    p.log.success(`Connected — v${version} on port ${port}`);\n\n    const lines = [\n      `Health:       ${status === \"healthy\" ? \"✓ healthy\" : status}`,\n      `Sessions:     ${sessions}`,\n      `Observations: ${obsCount}`,\n      `Memories:     ${memCount}`,\n      `Graph:        ${nodes} nodes, ${edges} edges`,\n      `Circuit:      ${cb}`,\n      `Heap:         ${heapMB} MB`,\n      `Uptime:       ${uptime}s`,\n      `Viewer:       http://localhost:${port + 2}`,\n    ];\n\n    if (obsCount > 0) {\n      lines.push(\"\");\n      lines.push(`Token savings: ~${tokensSaved.toLocaleString()} tokens saved (${pctSaved}% reduction)`);\n      lines.push(`  Full context: ~${estFullTokens.toLocaleString()} tokens`);\n      lines.push(`  Injected:     ~${estInjectedTokens.toLocaleString()} tokens`);\n    }\n\n    p.note(lines.join(\"\\n\"), \"agentmemory\");\n  } catch (err) {\n    p.log.error(err instanceof Error ? err.message : String(err));\n    process.exit(1);\n  }\n}\n\ntype DemoObservation = {\n  toolName: string;\n  toolInput: Record<string, string>;\n  toolOutput: string;\n};\n\ntype DemoSession = {\n  id: string;\n  title: string;\n  observations: DemoObservation[];\n};\n\ntype SearchResult = { query: string; hits: number; topTitle: string };\n\nfunction buildDemoSessions(): DemoSession[] {\n  return [\n    {\n      id: generateId(\"demo\"),\n      title: \"Session 1: JWT auth setup\",\n      observations: [\n        {\n          toolName: \"Write\",\n          toolInput: { file_path: \"src/middleware/auth.ts\" },\n          toolOutput:\n            \"Created JWT middleware using jose library. Tokens expire after 30 days. Chose jose over jsonwebtoken for Edge compatibility.\",\n        },\n        {\n          toolName: \"Write\",\n          toolInput: { file_path: \"test/auth.test.ts\" },\n          toolOutput:\n            \"Added token validation tests covering expired, malformed, and valid cases.\",\n        },\n        {\n          toolName: \"Bash\",\n          toolInput: { command: \"npm test\" },\n          toolOutput: \"All 12 auth tests passing.\",\n        },\n      ],\n    },\n    {\n      id: generateId(\"demo\"),\n      title: \"Session 2: Database migration debugging\",\n      observations: [\n        {\n          toolName: \"Read\",\n          toolInput: { file_path: \"prisma/schema.prisma\" },\n          toolOutput:\n            \"Found N+1 query issue in user relations. Need to add include on posts query.\",\n        },\n        {\n          toolName: \"Edit\",\n          toolInput: { file_path: \"src/api/users.ts\" },\n          toolOutput:\n            \"Fixed N+1 by adding Prisma include. Query time dropped from 450ms to 28ms.\",\n        },\n      ],\n    },\n    {\n      id: generateId(\"demo\"),\n      title: \"Session 3: Rate limiting\",\n      observations: [\n        {\n          toolName: \"Write\",\n          toolInput: { file_path: \"src/middleware/ratelimit.ts\" },\n          toolOutput:\n            \"Added rate limiting middleware with 100 req/min default. Uses in-memory store for dev, Redis for prod.\",\n        },\n      ],\n    },\n  ];\n}\n\nasync function postJson<T = unknown>(\n  url: string,\n  body: unknown,\n  timeoutMs = 5000,\n): Promise<T | null> {\n  try {\n    const res = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(timeoutMs),\n    });\n    if (!res.ok) return null;\n    return (await res.json().catch(() => null)) as T | null;\n  } catch {\n    return null;\n  }\n}\n\nasync function postJsonStrict<T = unknown>(\n  url: string,\n  body: unknown,\n  timeoutMs = 5000,\n): Promise<T | null> {\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify(body),\n    signal: AbortSignal.timeout(timeoutMs),\n  });\n  if (!res.ok) {\n    const errBody = await res.text().catch(() => \"\");\n    const suffix = errBody ? ` — ${errBody.slice(0, 200)}` : \"\";\n    throw new Error(`POST ${url} failed: ${res.status} ${res.statusText}${suffix}`);\n  }\n  return (await res.json().catch(() => null)) as T | null;\n}\n\nasync function seedDemoSession(\n  base: string,\n  project: string,\n  session: DemoSession,\n): Promise<number> {\n  await postJsonStrict(`${base}/agentmemory/session/start`, {\n    sessionId: session.id,\n    project,\n    cwd: project,\n  });\n\n  let stored = 0;\n  for (const obs of session.observations) {\n    const url = `${base}/agentmemory/observe`;\n    const payload = {\n      hookType: \"post_tool_use\",\n      sessionId: session.id,\n      timestamp: new Date().toISOString(),\n      data: {\n        tool_name: obs.toolName,\n        tool_input: obs.toolInput,\n        tool_output: obs.toolOutput,\n      },\n    };\n\n    try {\n      const res = await fetch(url, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(payload),\n        signal: AbortSignal.timeout(5000),\n      });\n      if (res.ok) {\n        stored++;\n      } else {\n        const body = await res.text().catch(() => \"\");\n        p.log.warn(\n          `observe failed for ${obs.toolName}: ${res.status} ${res.statusText}${body ? ` — ${body.slice(0, 160)}` : \"\"}`,\n        );\n      }\n    } catch (err) {\n      p.log.warn(\n        `observe request failed for ${obs.toolName}: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  await postJsonStrict(`${base}/agentmemory/session/end`, { sessionId: session.id });\n  return stored;\n}\n\nasync function runDemoSearch(base: string, query: string): Promise<SearchResult> {\n  const data = await postJson<{ results?: Array<{ title?: string }> }>(\n    `${base}/agentmemory/smart-search`,\n    { query, limit: 5 },\n    10000,\n  );\n  const items = data?.results ?? [];\n  return {\n    query,\n    hits: items.length,\n    topTitle: items[0]?.title ?? \"(no results)\",\n  };\n}\n\nasync function runDemo() {\n  const port = getRestPort();\n  const base = `http://localhost:${port}`;\n  p.intro(\"agentmemory demo\");\n\n  if (!(await isEngineRunning())) {\n    p.log.error(`Not running — no response on port ${port}`);\n    p.log.info(\"Start the server first: npx @agentmemory/agentmemory\");\n    process.exit(1);\n  }\n\n  const demoProject = \"/tmp/agentmemory-demo\";\n  const sessions = buildDemoSessions();\n\n  const sSeed = p.spinner();\n  sSeed.start(\"Seeding 3 demo sessions with realistic observations...\");\n\n  let totalObs = 0;\n  for (const session of sessions) {\n    totalObs += await seedDemoSession(base, demoProject, session);\n  }\n\n  sSeed.stop(`Seeded ${totalObs} observations across ${sessions.length} sessions`);\n\n  const queries = [\n    \"jwt auth middleware\",\n    \"database performance optimization\",\n    \"rate limiting\",\n  ];\n\n  const sQuery = p.spinner();\n  sQuery.start(`Running ${queries.length} smart-search queries...`);\n\n  const results: SearchResult[] = [];\n  for (const query of queries) {\n    results.push(await runDemoSearch(base, query));\n  }\n\n  sQuery.stop(\"Search complete\");\n\n  const lines = [\n    `Project:       ${demoProject}`,\n    `Sessions:      ${sessions.length} seeded (${totalObs} observations)`,\n    \"\",\n    \"Search results:\",\n    ...results.flatMap((r) => [\n      `  \"${r.query}\"`,\n      `    → ${r.hits} hit(s), top: ${r.topTitle.slice(0, 60)}`,\n    ]),\n    \"\",\n    `Notice: searching \"database performance optimization\"`,\n    `found the N+1 query fix — keyword matching can't do that.`,\n    \"\",\n    `Viewer:        http://localhost:${port + 2}`,\n    `Clean up with: curl -X DELETE \"${base}/agentmemory/sessions?project=${demoProject}\"`,\n  ];\n\n  p.note(lines.join(\"\\n\"), \"demo complete\");\n  p.log.success(\"agentmemory is working. Point your agent at it and get back to coding.\");\n}\n\nfunction runCommand(\n  command: string,\n  commandArgs: string[],\n  options: { cwd?: string; label: string; optional?: boolean } = { label: \"command\" },\n): boolean {\n  const spinner = p.spinner();\n  spinner.start(options.label);\n  const result = spawnSync(command, commandArgs, {\n    cwd: options.cwd || process.cwd(),\n    stdio: \"pipe\",\n    encoding: \"utf-8\",\n  });\n\n  if (result.status === 0) {\n    spinner.stop(`${options.label} ✓`);\n    return true;\n  }\n\n  const stderr = (result.stderr || \"\").toString().trim();\n  const stdout = (result.stdout || \"\").toString().trim();\n  const msg = stderr || stdout || \"unknown error\";\n\n  if (options.optional) {\n    spinner.stop(`${options.label} (skipped)`);\n    p.log.warn(msg.slice(0, 300));\n    return false;\n  }\n\n  spinner.stop(`${options.label} ✗`);\n  p.log.error(msg.slice(0, 300));\n  return false;\n}\n\nasync function runUpgrade() {\n  p.intro(\"agentmemory upgrade\");\n\n  const cwd = process.cwd();\n  const hasPackageJson = existsSync(join(cwd, \"package.json\"));\n  const hasPnpmLock = existsSync(join(cwd, \"pnpm-lock.yaml\"));\n\n  const pnpmBin = whichBinary(\"pnpm\");\n  const npmBin = whichBinary(\"npm\");\n  const cargoBin = whichBinary(\"cargo\");\n  const dockerBin = whichBinary(\"docker\");\n\n  p.log.info(`Working directory: ${cwd}`);\n  const requireSuccess = (ok: boolean, label: string): void => {\n    if (!ok) {\n      p.log.error(`Upgrade aborted: ${label} failed.`);\n      process.exit(1);\n    }\n  };\n\n  if (hasPackageJson) {\n    const usePnpm = !!pnpmBin && hasPnpmLock;\n    if (usePnpm && pnpmBin) {\n      const installOk = runCommand(pnpmBin, [\"install\"], {\n        label: \"Refreshing dependencies (pnpm install)\",\n      });\n      requireSuccess(installOk, \"pnpm install\");\n      runCommand(pnpmBin, [\"up\", \"iii-sdk@latest\"], {\n        label: \"Upgrading iii-sdk to latest\",\n        optional: true,\n      });\n    } else if (npmBin) {\n      const installOk = runCommand(npmBin, [\"install\"], {\n        label: \"Refreshing dependencies (npm install)\",\n      });\n      requireSuccess(installOk, \"npm install\");\n      runCommand(npmBin, [\"install\", \"iii-sdk@latest\"], {\n        label: \"Upgrading iii-sdk to latest\",\n        optional: true,\n      });\n    } else {\n      p.log.warn(\"No package manager found (pnpm/npm). Skipping JS dependency upgrade.\");\n    }\n  } else {\n    p.log.warn(\"No package.json in current directory. Skipping JS dependency upgrade.\");\n  }\n\n  if (cargoBin) {\n    const upgradeEngine = await p.confirm({\n      message: \"Upgrade iii-engine via cargo install --force?\",\n      initialValue: true,\n    });\n    if (p.isCancel(upgradeEngine)) {\n      p.cancel(\"Cancelled.\");\n      return process.exit(0);\n    }\n    if (upgradeEngine === true) {\n      const cargoOk = runCommand(cargoBin, [\"install\", \"iii-engine\", \"--force\"], {\n        label: \"Upgrading iii-engine (cargo)\",\n      });\n      requireSuccess(cargoOk, \"cargo install iii-engine --force\");\n    } else {\n      p.log.info(\"Skipped cargo-based iii-engine upgrade.\");\n    }\n  } else {\n    p.log.warn(\"Cargo not found. Skipping iii-engine binary upgrade.\");\n  }\n\n  if (dockerBin) {\n    runCommand(dockerBin, [\"pull\", \"iiidev/iii:latest\"], {\n      label: \"Pulling latest iii Docker image\",\n      optional: true,\n    });\n  } else {\n    p.log.info(\"Docker not found. Skipping Docker image refresh.\");\n  }\n\n  p.note(\n    [\n      \"Upgrade flow completed.\",\n      \"\",\n      \"Recommended next steps:\",\n      \"  1) agentmemory status\",\n      \"  2) npm/pnpm test\",\n      \"  3) restart agentmemory process\",\n    ].join(\"\\n\"),\n    \"agentmemory upgrade\",\n  );\n}\n\nasync function runMcp(): Promise<void> {\n  await import(\"./mcp/standalone.js\");\n}\n\nconst commands: Record<string, () => Promise<void>> = {\n  status: runStatus,\n  demo: runDemo,\n  upgrade: runUpgrade,\n  mcp: runMcp,\n};\n\nconst handler = commands[args[0] ?? \"\"] ?? main;\nhandler().catch((err) => {\n  p.log.error(err instanceof Error ? err.message : String(err));\n  process.exit(1);\n});\n"],"mappings":"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"}

package/dist/hooks/pre-tool-use.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 //#region src/hooks/pre-tool-use.ts
+const INJECT_CONTEXT = process.env["AGENTMEMORY_INJECT_CONTEXT"] === "true";
 const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
 const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
 function authHeaders() {
@@ -8,6 +9,7 @@ function authHeaders() {
 	return h;
 }
 async function main() {
+	if (!INJECT_CONTEXT) return;
 	let input = "";
 	for await (const chunk of process.stdin) input += chunk;
 	let data;

package/dist/hooks/pre-tool-use.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pre-tool-use.mjs","names":[],"sources":["../../src/hooks/pre-tool-use.ts"],"sourcesContent":["#!/usr/bin/env node\n\nconst REST_URL = process.env[\"AGENTMEMORY_URL\"] || \"http://localhost:3111\";\nconst SECRET = process.env[\"AGENTMEMORY_SECRET\"] || \"\";\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  const toolName = data.tool_name as string;\n  if (!toolName) return;\n\n  const fileTools = [\"Edit\", \"Write\", \"Read\", \"Glob\", \"Grep\"];\n  if (!fileTools.includes(toolName)) return;\n\n  const toolInput = (data.tool_input || {}) as Record<string, unknown>;\n  const files: string[] = [];\n  const fileKeys =\n    toolName === \"Grep\"\n      ? [\"path\", \"file\"]\n      : [\"file_path\", \"path\", \"file\", \"pattern\"];\n  for (const key of fileKeys) {\n    const val = toolInput[key];\n    if (typeof val === \"string\" && val.length > 0) files.push(val);\n  }\n  if (files.length === 0) return;\n\n  const terms: string[] = [];\n  if (toolName === \"Grep\" || toolName === \"Glob\") {\n    const pattern = toolInput[\"pattern\"];\n    if (typeof pattern === \"string\" && pattern.length > 0) {\n      terms.push(pattern);\n    }\n  }\n\n  const sessionId = (data.session_id as string) || \"unknown\";\n\n  try {\n    const res = await fetch(`${REST_URL}/agentmemory/enrich`, {\n      method: \"POST\",\n      headers: authHeaders(),\n      body: JSON.stringify({ sessionId, files, terms, toolName }),\n      signal: AbortSignal.timeout(2000),\n    });\n\n    if (res.ok) {\n      const result = (await res.json()) as { context?: string };\n      if (result.context) {\n        process.stdout.write(result.context);\n      }\n    }\n  } catch {\n    // don't block tool execution\n  }\n}\n\nmain();\n"],"mappings":";;AAEA,MAAM,WAAW,QAAQ,IAAI,sBAAsB;AACnD,MAAM,SAAS,QAAQ,IAAI,yBAAyB;AAEpD,SAAS,cAAsC;CAC7C,MAAM,IAA4B,EAAE,gBAAgB,oBAAoB;AACxE,KAAI,OAAQ,GAAE,mBAAmB,UAAU;AAC3C,QAAO;;AAGT,eAAe,OAAO;CACpB,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;CAGF,MAAM,WAAW,KAAK;AACtB,KAAI,CAAC,SAAU;AAGf,KAAI,CADc;EAAC;EAAQ;EAAS;EAAQ;EAAQ;EAAO,CAC5C,SAAS,SAAS,CAAE;CAEnC,MAAM,YAAa,KAAK,cAAc,EAAE;CACxC,MAAM,QAAkB,EAAE;CAC1B,MAAM,WACJ,aAAa,SACT,CAAC,QAAQ,OAAO,GAChB;EAAC;EAAa;EAAQ;EAAQ;EAAU;AAC9C,MAAK,MAAM,OAAO,UAAU;EAC1B,MAAM,MAAM,UAAU;AACtB,MAAI,OAAO,QAAQ,YAAY,IAAI,SAAS,EAAG,OAAM,KAAK,IAAI;;AAEhE,KAAI,MAAM,WAAW,EAAG;CAExB,MAAM,QAAkB,EAAE;AAC1B,KAAI,aAAa,UAAU,aAAa,QAAQ;EAC9C,MAAM,UAAU,UAAU;AAC1B,MAAI,OAAO,YAAY,YAAY,QAAQ,SAAS,EAClD,OAAM,KAAK,QAAQ;;CAIvB,MAAM,YAAa,KAAK,cAAyB;AAEjD,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,GAAG,SAAS,sBAAsB;GACxD,QAAQ;GACR,SAAS,aAAa;GACtB,MAAM,KAAK,UAAU;IAAE;IAAW;IAAO;IAAO;IAAU,CAAC;GAC3D,QAAQ,YAAY,QAAQ,IAAK;GAClC,CAAC;AAEF,MAAI,IAAI,IAAI;GACV,MAAM,SAAU,MAAM,IAAI,MAAM;AAChC,OAAI,OAAO,QACT,SAAQ,OAAO,MAAM,OAAO,QAAQ;;SAGlC;;AAKV,MAAM"}
+{"version":3,"file":"pre-tool-use.mjs","names":[],"sources":["../../src/hooks/pre-tool-use.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// Pre-tool-use enrichment hook.\n//\n// THIS HOOK IS A NO-OP BY DEFAULT AS OF 0.8.10 (#143). Previously it\n// fired /agentmemory/enrich on every Edit/Write/Read/Glob/Grep tool call\n// and wrote up to 4000 chars of context to stdout. Claude Code reads\n// PreToolUse stdout and prepends it to the model's next turn, which meant\n// agentmemory was silently injecting ~1000 tokens into every tool turn\n// via the user's Claude Code session. On Claude Pro that burned entire\n// allocations in a handful of messages (@adrianricardo, #143).\n//\n// Users who explicitly want pre-tool enrichment opt in with:\n//   AGENTMEMORY_INJECT_CONTEXT=true   in ~/.agentmemory/.env\n// and restart Claude Code. Expect your session input token count to grow\n// proportionally with the number of file-touching tool calls per turn.\nconst INJECT_CONTEXT = process.env[\"AGENTMEMORY_INJECT_CONTEXT\"] === \"true\";\n\nconst REST_URL = process.env[\"AGENTMEMORY_URL\"] || \"http://localhost:3111\";\nconst SECRET = process.env[\"AGENTMEMORY_SECRET\"] || \"\";\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  // Default off: exit immediately so we don't even open stdin. This keeps\n  // Claude Code's tool-call hot path as cheap as possible.\n  if (!INJECT_CONTEXT) return;\n\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  const toolName = data.tool_name as string;\n  if (!toolName) return;\n\n  const fileTools = [\"Edit\", \"Write\", \"Read\", \"Glob\", \"Grep\"];\n  if (!fileTools.includes(toolName)) return;\n\n  const toolInput = (data.tool_input || {}) as Record<string, unknown>;\n  const files: string[] = [];\n  const fileKeys =\n    toolName === \"Grep\"\n      ? [\"path\", \"file\"]\n      : [\"file_path\", \"path\", \"file\", \"pattern\"];\n  for (const key of fileKeys) {\n    const val = toolInput[key];\n    if (typeof val === \"string\" && val.length > 0) files.push(val);\n  }\n  if (files.length === 0) return;\n\n  const terms: string[] = [];\n  if (toolName === \"Grep\" || toolName === \"Glob\") {\n    const pattern = toolInput[\"pattern\"];\n    if (typeof pattern === \"string\" && pattern.length > 0) {\n      terms.push(pattern);\n    }\n  }\n\n  const sessionId = (data.session_id as string) || \"unknown\";\n\n  try {\n    const res = await fetch(`${REST_URL}/agentmemory/enrich`, {\n      method: \"POST\",\n      headers: authHeaders(),\n      body: JSON.stringify({ sessionId, files, terms, toolName }),\n      signal: AbortSignal.timeout(2000),\n    });\n\n    if (res.ok) {\n      const result = (await res.json()) as { context?: string };\n      if (result.context) {\n        process.stdout.write(result.context);\n      }\n    }\n  } catch {\n    // don't block tool execution\n  }\n}\n\nmain();\n"],"mappings":";;AAgBA,MAAM,iBAAiB,QAAQ,IAAI,kCAAkC;AAErE,MAAM,WAAW,QAAQ,IAAI,sBAAsB;AACnD,MAAM,SAAS,QAAQ,IAAI,yBAAyB;AAEpD,SAAS,cAAsC;CAC7C,MAAM,IAA4B,EAAE,gBAAgB,oBAAoB;AACxE,KAAI,OAAQ,GAAE,mBAAmB,UAAU;AAC3C,QAAO;;AAGT,eAAe,OAAO;AAGpB,KAAI,CAAC,eAAgB;CAErB,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;CAGF,MAAM,WAAW,KAAK;AACtB,KAAI,CAAC,SAAU;AAGf,KAAI,CADc;EAAC;EAAQ;EAAS;EAAQ;EAAQ;EAAO,CAC5C,SAAS,SAAS,CAAE;CAEnC,MAAM,YAAa,KAAK,cAAc,EAAE;CACxC,MAAM,QAAkB,EAAE;CAC1B,MAAM,WACJ,aAAa,SACT,CAAC,QAAQ,OAAO,GAChB;EAAC;EAAa;EAAQ;EAAQ;EAAU;AAC9C,MAAK,MAAM,OAAO,UAAU;EAC1B,MAAM,MAAM,UAAU;AACtB,MAAI,OAAO,QAAQ,YAAY,IAAI,SAAS,EAAG,OAAM,KAAK,IAAI;;AAEhE,KAAI,MAAM,WAAW,EAAG;CAExB,MAAM,QAAkB,EAAE;AAC1B,KAAI,aAAa,UAAU,aAAa,QAAQ;EAC9C,MAAM,UAAU,UAAU;AAC1B,MAAI,OAAO,YAAY,YAAY,QAAQ,SAAS,EAClD,OAAM,KAAK,QAAQ;;CAIvB,MAAM,YAAa,KAAK,cAAyB;AAEjD,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,GAAG,SAAS,sBAAsB;GACxD,QAAQ;GACR,SAAS,aAAa;GACtB,MAAM,KAAK,UAAU;IAAE;IAAW;IAAO;IAAO;IAAU,CAAC;GAC3D,QAAQ,YAAY,QAAQ,IAAK;GAClC,CAAC;AAEF,MAAI,IAAI,IAAI;GACV,MAAM,SAAU,MAAM,IAAI,MAAM;AAChC,OAAI,OAAO,QACT,SAAQ,OAAO,MAAM,OAAO,QAAQ;;SAGlC;;AAKV,MAAM"}

package/dist/hooks/session-start.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 //#region src/hooks/session-start.ts
+const INJECT_CONTEXT = process.env["AGENTMEMORY_INJECT_CONTEXT"] === "true";
 const REST_URL = process.env["AGENTMEMORY_URL"] || "http://localhost:3111";
 const SECRET = process.env["AGENTMEMORY_SECRET"] || "";
 function authHeaders() {
@@ -29,7 +30,7 @@ async function main() {
 			}),
 			signal: AbortSignal.timeout(5e3)
 		});
-		if (res.ok) {
+		if (INJECT_CONTEXT && res.ok) {
 			const result = await res.json();
 			if (result.context) process.stdout.write(result.context);
 		}

package/dist/hooks/session-start.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"session-start.mjs","names":[],"sources":["../../src/hooks/session-start.ts"],"sourcesContent":["#!/usr/bin/env node\n\nconst REST_URL = process.env[\"AGENTMEMORY_URL\"] || \"http://localhost:3111\";\nconst SECRET = process.env[\"AGENTMEMORY_SECRET\"] || \"\";\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  const sessionId =\n    (data.session_id as string) || `ses_${Date.now().toString(36)}`;\n  const project = (data.cwd as string) || process.cwd();\n\n  try {\n    const res = await fetch(`${REST_URL}/agentmemory/session/start`, {\n      method: \"POST\",\n      headers: authHeaders(),\n      body: JSON.stringify({ sessionId, project, cwd: project }),\n      signal: AbortSignal.timeout(5000),\n    });\n\n    if (res.ok) {\n      const result = (await res.json()) as { context?: string };\n      if (result.context) {\n        process.stdout.write(result.context);\n      }\n    }\n  } catch {\n    // silently fail -- don't block Claude Code startup\n  }\n}\n\nmain();\n"],"mappings":";;AAEA,MAAM,WAAW,QAAQ,IAAI,sBAAsB;AACnD,MAAM,SAAS,QAAQ,IAAI,yBAAyB;AAEpD,SAAS,cAAsC;CAC7C,MAAM,IAA4B,EAAE,gBAAgB,oBAAoB;AACxE,KAAI,OAAQ,GAAE,mBAAmB,UAAU;AAC3C,QAAO;;AAGT,eAAe,OAAO;CACpB,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;CAGF,MAAM,YACH,KAAK,cAAyB,OAAO,KAAK,KAAK,CAAC,SAAS,GAAG;CAC/D,MAAM,UAAW,KAAK,OAAkB,QAAQ,KAAK;AAErD,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,GAAG,SAAS,6BAA6B;GAC/D,QAAQ;GACR,SAAS,aAAa;GACtB,MAAM,KAAK,UAAU;IAAE;IAAW;IAAS,KAAK;IAAS,CAAC;GAC1D,QAAQ,YAAY,QAAQ,IAAK;GAClC,CAAC;AAEF,MAAI,IAAI,IAAI;GACV,MAAM,SAAU,MAAM,IAAI,MAAM;AAChC,OAAI,OAAO,QACT,SAAQ,OAAO,MAAM,OAAO,QAAQ;;SAGlC;;AAKV,MAAM"}
+{"version":3,"file":"session-start.mjs","names":[],"sources":["../../src/hooks/session-start.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// Session-start hook.\n//\n// Always registers the session for observation tracking (so memories\n// captured on PostToolUse get attached to the right session). Only writes\n// project context to stdout — which Claude Code prepends to the very first\n// turn — when AGENTMEMORY_INJECT_CONTEXT=true. Default off as of 0.8.10\n// (#143); see pre-tool-use.ts for the full explanation.\nconst INJECT_CONTEXT = process.env[\"AGENTMEMORY_INJECT_CONTEXT\"] === \"true\";\n\nconst REST_URL = process.env[\"AGENTMEMORY_URL\"] || \"http://localhost:3111\";\nconst SECRET = process.env[\"AGENTMEMORY_SECRET\"] || \"\";\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  const sessionId =\n    (data.session_id as string) || `ses_${Date.now().toString(36)}`;\n  const project = (data.cwd as string) || process.cwd();\n\n  try {\n    const res = await fetch(`${REST_URL}/agentmemory/session/start`, {\n      method: \"POST\",\n      headers: authHeaders(),\n      body: JSON.stringify({ sessionId, project, cwd: project }),\n      signal: AbortSignal.timeout(5000),\n    });\n\n    // Only write context to stdout when the user has explicitly opted\n    // into injection. Registering the session is cheap and doesn't touch\n    // Claude Code's input token window.\n    if (INJECT_CONTEXT && res.ok) {\n      const result = (await res.json()) as { context?: string };\n      if (result.context) {\n        process.stdout.write(result.context);\n      }\n    }\n  } catch {\n    // silently fail -- don't block Claude Code startup\n  }\n}\n\nmain();\n"],"mappings":";;AASA,MAAM,iBAAiB,QAAQ,IAAI,kCAAkC;AAErE,MAAM,WAAW,QAAQ,IAAI,sBAAsB;AACnD,MAAM,SAAS,QAAQ,IAAI,yBAAyB;AAEpD,SAAS,cAAsC;CAC7C,MAAM,IAA4B,EAAE,gBAAgB,oBAAoB;AACxE,KAAI,OAAQ,GAAE,mBAAmB,UAAU;AAC3C,QAAO;;AAGT,eAAe,OAAO;CACpB,IAAI,QAAQ;AACZ,YAAW,MAAM,SAAS,QAAQ,MAChC,UAAS;CAGX,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN;;CAGF,MAAM,YACH,KAAK,cAAyB,OAAO,KAAK,KAAK,CAAC,SAAS,GAAG;CAC/D,MAAM,UAAW,KAAK,OAAkB,QAAQ,KAAK;AAErD,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,GAAG,SAAS,6BAA6B;GAC/D,QAAQ;GACR,SAAS,aAAa;GACtB,MAAM,KAAK,UAAU;IAAE;IAAW;IAAS,KAAK;IAAS,CAAC;GAC1D,QAAQ,YAAY,QAAQ,IAAK;GAClC,CAAC;AAKF,MAAI,kBAAkB,IAAI,IAAI;GAC5B,MAAM,SAAU,MAAM,IAAI,MAAM;AAChC,OAAI,OAAO,QACT,SAAQ,OAAO,MAAM,OAAO,QAAQ;;SAGlC;;AAKV,MAAM"}

package/dist/iii-config.docker.yaml

@@ -1,13 +1,5 @@
-modules:
-  - class: modules::state::StateModule
-    config:
-      adapter:
-        class: modules::state::adapters::KvStore
-        config:
-          store_method: file_based
-          file_path: ./data/state_store.db
-
-  - class: modules::api::RestApiModule
+workers:
+  - name: iii-http
     config:
       port: 3111
       host: 0.0.0.0
@@ -15,35 +7,44 @@ modules:
       cors:
         allowed_origins: ["http://localhost:3111", "http://localhost:3113", "http://127.0.0.1:3111", "http://127.0.0.1:3113"]
         allowed_methods: [GET, POST, PUT, DELETE, OPTIONS]
-
-  - class: modules::queue::QueueModule
+  - name: iii-state
     config:
       adapter:
-        class: modules::queue::BuiltinQueueAdapter
-
-  - class: modules::pubsub::PubSubModule
+        name: kv
+        config:
+          store_method: file_based
+          file_path: ./data/state_store.db
+  - name: iii-queue
+    config:
+      adapter:
+        name: builtin
+  - name: iii-pubsub
     config:
       adapter:
-        class: modules::pubsub::LocalAdapter
-
-  - class: modules::cron::CronModule
+        name: local
+  - name: iii-cron
     config:
       adapter:
-        class: modules::cron::KvCronAdapter
-
-  - class: modules::stream::StreamModule
+        name: kv
+  - name: iii-stream
     config:
       port: 3112
       host: 0.0.0.0
-
-  - class: modules::observability::OtelModule
+      adapter:
+        name: kv
+        config:
+          store_method: file_based
+          file_path: ./data/stream_store
+  - name: iii-observability
     config:
       enabled: true
       service_name: agentmemory
       exporter: memory
+      sampling_ratio: 1.0
+      metrics_enabled: true
       logs_enabled: true
-
-  - class: modules::shell::ExecModule
+      logs_console_output: true
+  - name: iii-exec
     config:
       watch:
         - src/**/*.ts