@agentmemory/agentmemory 0.7.8 → 0.8.0

package/README.md

@@ -3,8 +3,8 @@
 </p>
 
 <p align="center">
-  <strong>Persistent memory for AI coding agents.</strong><br/>
-  Powered by <a href="https://iii.dev">iii-engine</a>.
+  <strong>Your coding agent remembers everything. No more re-explaining.</strong><br/>
+  Persistent memory for Claude Code, Cursor, Gemini CLI, OpenCode, and any MCP client.
 </p>
 
 <p align="center">
@@ -26,9 +26,11 @@
 
 ---
 
-Every AI coding agent has the same blind spot. Session ends, memory vanishes. You re-explain architecture. You re-discover bugs. You re-teach preferences. Built-in memory files like CLAUDE.md and .cursorrules are 200-line sticky notes that overflow and go stale. agentmemory replaces that with a searchable, versioned, cross-agent database — 43 MCP tools, triple-stream retrieval (BM25 + vector + knowledge graph), 4-tier memory consolidation, provenance-tracked citations, and cascading staleness so retired facts never pollute your context again. One instance serves Claude Code, Cursor, Codex, Windsurf, and any MCP client simultaneously. 646 tests. Zero external DB dependencies.
+You explain the same architecture every session. You re-discover the same bugs. You re-teach the same preferences. Built-in memory (CLAUDE.md, .cursorrules) caps out at 200 lines and goes stale. agentmemory fixes this — it silently captures what your agent does, compresses it into searchable memory, and injects the right context when the next session starts. One command. Works across agents.
 
-The result is measurable. On LongMemEval-S (ICLR 2025, 500 questions), agentmemory achieves **95.2% Recall@5** and **98.6% Recall@10** with hybrid BM25+vector search — within 1.4pp of raw vector baselines while using 92% fewer tokens than dumping everything into context. When an agent searches "database performance optimization," it finds the N+1 fix you made three weeks ago — something keyword grep literally cannot do. Memories version automatically, supersede each other, propagate staleness to related graph nodes, and sync across agent instances via P2P mesh. Your agents stop repeating mistakes. Your context stays clean. Your sessions start fast.
+**What changes:** Session 1 you set up JWT auth. Session 2 you ask for rate limiting — the agent already knows your auth uses jose middleware in `src/middleware/auth.ts`, your tests cover token validation, and you chose jose over jsonwebtoken for Edge compatibility. No re-explaining. No copy-pasting. The agent just *knows*.
+
+**95.2% retrieval accuracy** on [LongMemEval](https://arxiv.org/abs/2410.10813) (ICLR 2025). 43 MCP tools. 12 hooks. Real-time viewer. Works with Claude Code, Cursor, Gemini CLI, OpenCode, and any MCP client. 646 tests. Zero external DB dependencies.
 
 ```bash
 npx @agentmemory/agentmemory   # installs iii-engine if missing, starts everything
@@ -38,7 +40,7 @@ npx @agentmemory/agentmemory   # installs iii-engine if missing, starts everythi
 
 ## Why agentmemory
 
-AI coding agents forget everything between sessions. You explain the same architecture, re-discover the same patterns, and re-learn the same preferences every time. agentmemory fixes that.
+Every coding agent forgets everything when the session ends. You waste the first 5 minutes of every session re-explaining your stack, your conventions, your recent decisions. agentmemory runs in the background and eliminates that entirely.
 
 ```
 Session 1: "Add auth to the API"
@@ -47,15 +49,14 @@ Session 1: "Add auth to the API"
   Session ends -> observations compressed into structured memory
 
 Session 2: "Now add rate limiting"
-  agentmemory injects context from Session 1:
+  Agent already knows:
     - Auth uses JWT middleware in src/middleware/auth.ts
     - Tests in test/auth.test.ts cover token validation
-    - Decision: chose jose over jsonwebtoken for Edge compatibility
-  Agent starts with full project awareness
+    - You chose jose over jsonwebtoken for Edge compatibility
+    - The rate limit discussion from last week's debugging session
+  Zero re-explaining. Starts working immediately.
 ```
 
-No manual notes. No copy-pasting. The agent just *knows*.
-
 ### What it gives you
 
 | Capability | What it does |
@@ -240,6 +241,12 @@ Add to `.opencode/config.json`:
 }
 ```
 
+**Any agent via SkillKit (32+ agents supported):**
+
+```bash
+npx skillkit install agentmemory
+```
+
 **REST API (any agent, any language):**
 
 ```bash
@@ -297,6 +304,54 @@ If you prefer not to use the plugin, add hooks directly to `~/.claude/settings.j
 }
 ```
 
+## First Steps After Install
+
+Once hooks are installed, memory builds silently. No action needed — just use your agent normally.
+
+### Session 1: Your agent works as usual
+
+```text
+You: "Add JWT auth to the Express API"
+Agent: reads files, writes code, runs tests, fixes errors
+```
+
+agentmemory captures every tool use via PostToolUse hooks. At session end, 47 raw observations compress into structured memory:
+
+```json
+{
+  "type": "file_edit",
+  "title": "Implement JWT middleware with jose",
+  "facts": ["Using jose library for Edge compatibility", "JWT tokens expire after 30 days", "Middleware in src/middleware/auth.ts"],
+  "concepts": ["jwt", "authentication", "jose", "middleware"],
+  "files": ["src/middleware/auth.ts", "src/app/api/auth/route.ts"],
+  "importance": 9
+}
+```
+
+### Session 2: The payoff
+
+You start a new session. Before the agent responds, the SessionStart hook fires and injects context (~1,900 tokens):
+
+```text
+Agent already knows:
+  - Auth uses jose JWT middleware in src/middleware/auth.ts
+  - Tests in test/auth.test.ts cover token validation
+  - You chose jose over jsonwebtoken for Edge compatibility
+  - Rate limiting discussion from last week's debugging session
+```
+
+No re-explaining. The agent starts working immediately.
+
+### How to verify it's working
+
+```bash
+npx @agentmemory/agentmemory status   # quick terminal check
+curl http://localhost:3111/agentmemory/health
+open http://localhost:3113              # real-time viewer
+```
+
+After 1 session: check the Timeline tab in the viewer. After 2+ sessions: check Dashboard for memory count > 0 and the Token Savings card.
+
 ## How It Works
 
 ### Observation Pipeline
@@ -612,7 +667,8 @@ agentmemory needs an LLM for compressing observations and generating summaries.
 | Provider | Config | Notes |
 |----------|--------|-------|
 | **Claude subscription** (default) | No config needed | Uses `@anthropic-ai/claude-agent-sdk`. Zero cost beyond your Max/Pro plan |
-| **Anthropic API** | `ANTHROPIC_API_KEY` | Direct API access, per-token billing |
+| **Anthropic API** | `ANTHROPIC_API_KEY` | Direct API access, per-token billing. Supports `ANTHROPIC_BASE_URL` for custom endpoints |
+| **MiniMax** | `MINIMAX_API_KEY` | Anthropic-compatible API. Default model: `MiniMax-M2.7` |
 | **Gemini** | `GEMINI_API_KEY` | Also enables Gemini embeddings (free tier) |
 | **OpenRouter** | `OPENROUTER_API_KEY` | Access any model through one API |
 
@@ -625,6 +681,9 @@ Create `~/.agentmemory/.env`:
 ```env
 # LLM provider (pick one, or leave empty for Claude subscription)
 ANTHROPIC_API_KEY=sk-ant-...
+# ANTHROPIC_BASE_URL=https://custom-endpoint.example.com
+# MINIMAX_API_KEY=...
+# MINIMAX_MODEL=MiniMax-M2.7
 # GEMINI_API_KEY=...
 # OPENROUTER_API_KEY=...
 
@@ -639,7 +698,7 @@ ANTHROPIC_API_KEY=sk-ant-...
 # VECTOR_WEIGHT=0.6
 
 # Provider fallback chain (comma-separated, tried in order)
-# FALLBACK_PROVIDERS=anthropic,gemini,openrouter
+# FALLBACK_PROVIDERS=anthropic,minimax,gemini,openrouter
 
 # Bearer token for API auth
 # AGENTMEMORY_SECRET=your-secret-here
@@ -702,7 +761,7 @@ ANTHROPIC_API_KEY=sk-ant-...
 | `POST` | `/agentmemory/session/end` | Mark session complete |
 | `POST` | `/agentmemory/observe` | Capture observation |
 | `POST` | `/agentmemory/context` | Generate context |
-| `POST` | `/agentmemory/search` | Search observations (BM25) |
+| `POST` | `/agentmemory/search` | Search observations (BM25). Optional `project`/`cwd` filters |
 | `POST` | `/agentmemory/smart-search` | Hybrid search with progressive disclosure |
 | `POST` | `/agentmemory/summarize` | Generate session summary |
 | `POST` | `/agentmemory/remember` | Save to long-term memory |

package/dist/cli.mjs

@@ -12,7 +12,11 @@ if (args.includes("--help") || args.includes("-h")) {
 	console.log(`
 agentmemory — persistent memory for AI coding agents
 
-Usage: agentmemory [options]
+Usage: agentmemory [command] [options]
+
+Commands:
+  (default)          Start agentmemory worker
+  status             Show connection status, memory count, and health
 
 Options:
   --help, -h         Show this help
@@ -20,15 +24,10 @@ Options:
   --no-engine        Skip auto-starting iii-engine
   --port <N>         Override REST port (default: 3111)
 
-Environment:
-  AGENTMEMORY_TOOLS=all        Expose all 41 MCP tools
-  AGENTMEMORY_SECRET=xxx       Auth secret for REST/MCP
-  CONSOLIDATION_ENABLED=true   Enable auto-consolidation (off by default)
-  OBSIDIAN_AUTO_EXPORT=true    Auto-export on consolidation
-
 Quick start:
-  npx @agentmemory/agentmemory    # installs iii if missing, starts everything
-  npx agentmemory-mcp             # standalone MCP server (no engine needed)
+  npx @agentmemory/agentmemory          # start everything
+  npx @agentmemory/agentmemory status   # check health
+  npx agentmemory-mcp                   # standalone MCP (no engine)
 `);
 	process.exit(0);
 }
@@ -160,12 +159,12 @@ async function main() {
 	p.intro("agentmemory");
 	if (skipEngine) {
 		p.log.info("Skipping engine check (--no-engine)");
-		await import("./src-Ct05bSXw.mjs");
+		await import("./src-qOdKVNQz.mjs");
 		return;
 	}
 	if (await isEngineRunning()) {
 		p.log.success("iii-engine is running");
-		await import("./src-Ct05bSXw.mjs");
+		await import("./src-qOdKVNQz.mjs");
 		return;
 	}
 	if (!await startEngine()) {
@@ -193,9 +192,54 @@ async function main() {
 		process.exit(1);
 	}
 	s.stop("iii-engine is ready");
-	await import("./src-Ct05bSXw.mjs");
+	await import("./src-qOdKVNQz.mjs");
 }
-main().catch((err) => {
+async function runStatus() {
+	const port = getRestPort();
+	const base = `http://localhost:${port}`;
+	p.intro("agentmemory status");
+	if (!await isEngineRunning()) {
+		p.log.error(`Not running — no response on port ${port}`);
+		p.log.info("Start with: npx @agentmemory/agentmemory");
+		process.exit(1);
+	}
+	try {
+		const [healthRes, sessionsRes, graphRes] = await Promise.all([
+			fetch(`${base}/agentmemory/health`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null),
+			fetch(`${base}/agentmemory/sessions`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null),
+			fetch(`${base}/agentmemory/graph/stats`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null)
+		]);
+		const h = healthRes?.health;
+		const status = healthRes?.status || "unknown";
+		const version = healthRes?.version || "?";
+		const sessions = Array.isArray(sessionsRes?.sessions) ? sessionsRes.sessions.length : 0;
+		h?.workers?.[0]?.function_count;
+		const nodes = graphRes?.nodes || 0;
+		const edges = graphRes?.edges || 0;
+		const cb = healthRes?.circuitBreaker?.state || "closed";
+		const heapMB = h?.memory ? Math.round(h.memory.heapUsed / 1048576) : 0;
+		const uptime = h?.uptimeSeconds ? Math.round(h.uptimeSeconds) : 0;
+		p.log.success(`Connected — v${version} on port ${port}`);
+		const lines = [
+			`Health:     ${status === "healthy" ? "healthy" : status}`,
+			`Sessions:   ${sessions}`,
+			`Graph:      ${nodes} nodes, ${edges} edges`,
+			`Circuit:    ${cb}`,
+			`Heap:       ${heapMB} MB`,
+			`Uptime:     ${uptime}s`,
+			`Viewer:     http://localhost:${port + 2}`
+		];
+		p.note(lines.join("\n"), "agentmemory");
+	} catch (err) {
+		p.log.error(err instanceof Error ? err.message : String(err));
+		process.exit(1);
+	}
+}
+if (args[0] === "status") runStatus().catch((err) => {
+	p.log.error(err instanceof Error ? err.message : String(err));
+	process.exit(1);
+});
+else main().catch((err) => {
 	p.log.error(err instanceof Error ? err.message : String(err));
 	process.exit(1);
 });

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { spawn, execFileSync, execSync } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport * as p from \"@clack/prompts\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst args = process.argv.slice(2);\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nagentmemory — persistent memory for AI coding agents\n\nUsage: agentmemory [options]\n\nOptions:\n  --help, -h         Show this help\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\nEnvironment:\n  AGENTMEMORY_TOOLS=all        Expose all 41 MCP tools\n  AGENTMEMORY_SECRET=xxx       Auth secret for REST/MCP\n  CONSOLIDATION_ENABLED=true   Enable auto-consolidation (off by default)\n  OBSIDIAN_AUTO_EXPORT=true    Auto-export on consolidation\n\nQuick start:\n  npx @agentmemory/agentmemory    # installs iii if missing, starts everything\n  npx agentmemory-mcp             # standalone MCP server (no engine needed)\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 = process.platform === \"win32\" ? \"where\" : \"which\";\n  try {\n    return execFileSync(cmd, [name], { encoding: \"utf-8\" }).trim().split(\"\\n\")[0];\n  } catch {\n    return null;\n  }\n}\n\nasync function installIii(): Promise<boolean> {\n  if (process.platform === \"win32\") {\n    p.log.warn(\"Automatic iii-engine install is not supported on Windows.\");\n    p.log.info(\"Install manually: https://iii.dev/docs\");\n    return false;\n  }\n\n  const curlBin = whichBinary(\"curl\");\n  if (!curlBin) {\n    p.log.warn(\"curl not found — cannot auto-install iii-engine.\");\n    return false;\n  }\n\n  const shouldInstall = await p.confirm({\n    message: \"iii-engine is not installed. Install it now?\",\n    initialValue: true,\n  });\n\n  if (p.isCancel(shouldInstall) || !shouldInstall) {\n    return false;\n  }\n\n  const s = p.spinner();\n  s.start(\"Installing iii-engine...\");\n\n  try {\n    execSync(\"curl -fsSL https://install.iii.dev/iii/main/install.sh | sh\", {\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      timeout: 120000,\n    });\n\n    const installed = whichBinary(\"iii\");\n    if (installed) {\n      s.stop(\"iii-engine installed successfully\");\n      return true;\n    }\n\n    s.stop(\"Installation completed but iii not found in PATH\");\n    p.log.warn(\"You may need to restart your shell or add iii to your PATH.\");\n\n    const iiiPaths = [\n      join(process.env[\"HOME\"] || \"\", \".local\", \"bin\", \"iii\"),\n      \"/usr/local/bin/iii\",\n    ];\n    for (const iiiPath of iiiPaths) {\n      if (existsSync(iiiPath)) {\n        p.log.info(`Found iii at: ${iiiPath}`);\n        process.env[\"PATH\"] = `${dirname(iiiPath)}:${process.env[\"PATH\"]}`;\n        return true;\n      }\n    }\n\n    return false;\n  } catch (err) {\n    s.stop(\"Failed to install iii-engine\");\n    p.log.error(err instanceof Error ? err.message : String(err));\n    return false;\n  }\n}\n\nasync function startEngine(): Promise<boolean> {\n  const configPath = findIiiConfig();\n  let iiiBin = whichBinary(\"iii\");\n\n  if (!iiiBin) {\n    const installed = await installIii();\n    if (installed) {\n      iiiBin = whichBinary(\"iii\");\n    }\n  }\n\n  if (iiiBin && configPath) {\n    const s = p.spinner();\n    s.start(`Starting iii-engine: ${iiiBin}`);\n    const child = spawn(iiiBin, [\"--config\", configPath], {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    s.stop(\"iii-engine process started\");\n    return true;\n  }\n\n  const dockerBin = whichBinary(\"docker\");\n  const dockerCompose = join(__dirname, \"..\", \"docker-compose.yml\");\n  const dcExists = existsSync(dockerCompose) || existsSync(join(process.cwd(), \"docker-compose.yml\"));\n\n  if (dockerBin && dcExists) {\n    const composeFile = existsSync(dockerCompose) ? dockerCompose : join(process.cwd(), \"docker-compose.yml\");\n    const s = p.spinner();\n    s.start(\"Starting iii-engine via Docker...\");\n    const child = spawn(dockerBin, [\"compose\", \"-f\", composeFile, \"up\", \"-d\"], {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    s.stop(\"Docker compose started\");\n    return true;\n  }\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\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    p.note(\n      [\n        \"Install iii-engine (pick one):\",\n        \"  curl -fsSL https://install.iii.dev/iii/main/install.sh | sh\",\n        \"  cargo install iii-engine\",\n        \"\",\n        \"Or use Docker:\",\n        \"  docker pull iiidev/iii:latest\",\n        \"\",\n        \"Docs: https://iii.dev/docs\",\n        \"\",\n        \"Or skip with: agentmemory --no-engine\",\n      ].join(\"\\n\"),\n      \"Setup required\",\n    );\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    p.log.error(`Check that ports ${port}, ${port + 1}, 49134 are available.`);\n    process.exit(1);\n  }\n\n  s.stop(\"iii-engine is ready\");\n  await import(\"./index.js\");\n}\n\nmain().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":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { spawn, execFileSync, execSync } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport * as p from \"@clack/prompts\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst args = process.argv.slice(2);\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\nOptions:\n  --help, -h         Show this help\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 everything\n  npx @agentmemory/agentmemory status   # check health\n  npx agentmemory-mcp                   # standalone MCP (no engine)\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 = process.platform === \"win32\" ? \"where\" : \"which\";\n  try {\n    return execFileSync(cmd, [name], { encoding: \"utf-8\" }).trim().split(\"\\n\")[0];\n  } catch {\n    return null;\n  }\n}\n\nasync function installIii(): Promise<boolean> {\n  if (process.platform === \"win32\") {\n    p.log.warn(\"Automatic iii-engine install is not supported on Windows.\");\n    p.log.info(\"Install manually: https://iii.dev/docs\");\n    return false;\n  }\n\n  const curlBin = whichBinary(\"curl\");\n  if (!curlBin) {\n    p.log.warn(\"curl not found — cannot auto-install iii-engine.\");\n    return false;\n  }\n\n  const shouldInstall = await p.confirm({\n    message: \"iii-engine is not installed. Install it now?\",\n    initialValue: true,\n  });\n\n  if (p.isCancel(shouldInstall) || !shouldInstall) {\n    return false;\n  }\n\n  const s = p.spinner();\n  s.start(\"Installing iii-engine...\");\n\n  try {\n    execSync(\"curl -fsSL https://install.iii.dev/iii/main/install.sh | sh\", {\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      timeout: 120000,\n    });\n\n    const installed = whichBinary(\"iii\");\n    if (installed) {\n      s.stop(\"iii-engine installed successfully\");\n      return true;\n    }\n\n    s.stop(\"Installation completed but iii not found in PATH\");\n    p.log.warn(\"You may need to restart your shell or add iii to your PATH.\");\n\n    const iiiPaths = [\n      join(process.env[\"HOME\"] || \"\", \".local\", \"bin\", \"iii\"),\n      \"/usr/local/bin/iii\",\n    ];\n    for (const iiiPath of iiiPaths) {\n      if (existsSync(iiiPath)) {\n        p.log.info(`Found iii at: ${iiiPath}`);\n        process.env[\"PATH\"] = `${dirname(iiiPath)}:${process.env[\"PATH\"]}`;\n        return true;\n      }\n    }\n\n    return false;\n  } catch (err) {\n    s.stop(\"Failed to install iii-engine\");\n    p.log.error(err instanceof Error ? err.message : String(err));\n    return false;\n  }\n}\n\nasync function startEngine(): Promise<boolean> {\n  const configPath = findIiiConfig();\n  let iiiBin = whichBinary(\"iii\");\n\n  if (!iiiBin) {\n    const installed = await installIii();\n    if (installed) {\n      iiiBin = whichBinary(\"iii\");\n    }\n  }\n\n  if (iiiBin && configPath) {\n    const s = p.spinner();\n    s.start(`Starting iii-engine: ${iiiBin}`);\n    const child = spawn(iiiBin, [\"--config\", configPath], {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    s.stop(\"iii-engine process started\");\n    return true;\n  }\n\n  const dockerBin = whichBinary(\"docker\");\n  const dockerCompose = join(__dirname, \"..\", \"docker-compose.yml\");\n  const dcExists = existsSync(dockerCompose) || existsSync(join(process.cwd(), \"docker-compose.yml\"));\n\n  if (dockerBin && dcExists) {\n    const composeFile = existsSync(dockerCompose) ? dockerCompose : join(process.cwd(), \"docker-compose.yml\");\n    const s = p.spinner();\n    s.start(\"Starting iii-engine via Docker...\");\n    const child = spawn(dockerBin, [\"compose\", \"-f\", composeFile, \"up\", \"-d\"], {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    s.stop(\"Docker compose started\");\n    return true;\n  }\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\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    p.note(\n      [\n        \"Install iii-engine (pick one):\",\n        \"  curl -fsSL https://install.iii.dev/iii/main/install.sh | sh\",\n        \"  cargo install iii-engine\",\n        \"\",\n        \"Or use Docker:\",\n        \"  docker pull iiidev/iii:latest\",\n        \"\",\n        \"Docs: https://iii.dev/docs\",\n        \"\",\n        \"Or skip with: agentmemory --no-engine\",\n      ].join(\"\\n\"),\n      \"Setup required\",\n    );\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    p.log.error(`Check that ports ${port}, ${port + 1}, 49134 are available.`);\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] = 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    ]);\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 memories = h?.workers?.[0]?.function_count || 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    p.log.success(`Connected — v${version} on port ${port}`);\n\n    const lines = [\n      `Health:     ${status === \"healthy\" ? \"healthy\" : status}`,\n      `Sessions:   ${sessions}`,\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    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\nif (args[0] === \"status\") {\n  runStatus().catch((err) => {\n    p.log.error(err instanceof Error ? err.message : String(err));\n    process.exit(1);\n  });\n} else {\n  main().catch((err) => {\n    p.log.error(err instanceof Error ? err.message : String(err));\n    process.exit(1);\n  });\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -40,10 +40,16 @@ function loadEnvFile() {
 }
 function detectProvider(env) {
 	const maxTokens = parseInt(env["MAX_TOKENS"] || "4096", 10);
+	if (env["MINIMAX_API_KEY"]) return {
+		provider: "minimax",
+		model: env["MINIMAX_MODEL"] || "MiniMax-M2.7",
+		maxTokens
+	};
 	if (env["ANTHROPIC_API_KEY"]) return {
 		provider: "anthropic",
 		model: env["ANTHROPIC_MODEL"] || "claude-sonnet-4-20250514",
-		maxTokens
+		maxTokens,
+		baseURL: env["ANTHROPIC_BASE_URL"]
 	};
 	if (env["GEMINI_API_KEY"]) return {
 		provider: "gemini",
@@ -157,7 +163,8 @@ const VALID_PROVIDERS = new Set([
 	"anthropic",
 	"gemini",
 	"openrouter",
-	"agent-sdk"
+	"agent-sdk",
+	"minimax"
 ]);
 function loadFallbackConfig() {
 	return { providers: (getMergedEnv()["FALLBACK_PROVIDERS"] || "").split(",").map((p) => p.trim()).filter((p) => Boolean(p) && VALID_PROVIDERS.has(p)) };
@@ -196,8 +203,11 @@ var AnthropicProvider = class {
 	client;
 	model;
 	maxTokens;
-	constructor(apiKey, model, maxTokens) {
-		this.client = new Anthropic({ apiKey });
+	constructor(apiKey, model, maxTokens, baseURL) {
+		this.client = new Anthropic({
+			apiKey,
+			...baseURL ? { baseURL } : {}
+		});
 		this.model = model;
 		this.maxTokens = maxTokens;
 	}
@@ -220,6 +230,67 @@ var AnthropicProvider = class {
 	}
 };
 
+//#endregion
+//#region src/providers/minimax.ts
+/**
+* MiniMax provider using raw fetch to call MiniMax's Anthropic-compatible API.
+*
+* The Anthropic SDK automatically injects `x-stainless-*` headers that MiniMax
+* rejects with 403. This provider bypasses the SDK and calls the API directly.
+*
+* Required env vars:
+*   MINIMAX_API_KEY  — your MiniMax API key
+*   MINIMAX_MODEL    — model name (default: MiniMax-M2.7)
+*   MAX_TOKENS       — max output tokens (default: 800; MiniMax-M2.7 needs ≤800)
+*
+* Optional:
+*   MINIMAX_BASE_URL — base URL without path (default: https://api.minimaxi.com/anthropic)
+*/
+var MinimaxProvider = class {
+	name = "minimax";
+	apiKey;
+	model;
+	maxTokens;
+	baseUrl;
+	constructor(apiKey, model, maxTokens) {
+		this.apiKey = apiKey;
+		this.model = model;
+		this.maxTokens = maxTokens;
+		this.baseUrl = process.env["MINIMAX_BASE_URL"] || "https://api.minimaxi.com/anthropic";
+	}
+	async compress(systemPrompt, userPrompt) {
+		return this.call(systemPrompt, userPrompt);
+	}
+	async summarize(systemPrompt, userPrompt) {
+		return this.call(systemPrompt, userPrompt);
+	}
+	async call(systemPrompt, userPrompt) {
+		const url = `${this.baseUrl}/v1/messages`;
+		const response = await fetch(url, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				"x-api-key": this.apiKey,
+				"anthropic-version": "2023-06-01"
+			},
+			body: JSON.stringify({
+				model: this.model,
+				max_tokens: this.maxTokens,
+				system: systemPrompt,
+				messages: [{
+					role: "user",
+					content: userPrompt
+				}]
+			})
+		});
+		if (!response.ok) {
+			const text = await response.text();
+			throw new Error(`MiniMax API error ${response.status}: ${text}`);
+		}
+		return ((await response.json()).content?.find((b) => b.type === "text"))?.text ?? "";
+	}
+};
+
 //#endregion
 //#region src/providers/openrouter.ts
 var OpenRouterProvider = class {
@@ -647,7 +718,8 @@ function createFallbackProvider(config, fallbackConfig) {
 }
 function createBaseProvider(config) {
 	switch (config.provider) {
-		case "anthropic": return new AnthropicProvider(requireEnvVar("ANTHROPIC_API_KEY"), config.model, config.maxTokens);
+		case "minimax": return new MinimaxProvider(requireEnvVar("MINIMAX_API_KEY"), config.model, config.maxTokens);
+		case "anthropic": return new AnthropicProvider(requireEnvVar("ANTHROPIC_API_KEY"), config.model, config.maxTokens, config.baseURL);
 		case "gemini": return new OpenRouterProvider(requireEnvVar("GEMINI_API_KEY"), config.model, config.maxTokens, "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions");
 		case "openrouter": return new OpenRouterProvider(requireEnvVar("OPENROUTER_API_KEY"), config.model, config.maxTokens, "https://openrouter.ai/api/v1/chat/completions");
 		default: return new AgentSDKProvider();
@@ -2123,23 +2195,56 @@ function registerSearchFunction(sdk, kv) {
 	}, async (data) => {
 		const ctx = getContext();
 		const idx = getSearchIndex();
+		if (typeof data?.query !== "string" || !data.query.trim()) throw new Error("mem::search: query must be a non-empty string");
+		const query = data.query.trim();
+		const MAX_LIMIT = 100;
+		let effectiveLimit = 20;
+		if (data.limit !== void 0) {
+			if (!Number.isInteger(data.limit) || data.limit < 1) throw new Error("mem::search: limit must be a positive integer");
+			effectiveLimit = Math.min(data.limit, MAX_LIMIT);
+		}
+		const projectFilter = typeof data.project === "string" && data.project.length > 0 ? data.project : void 0;
+		const cwdFilter = typeof data.cwd === "string" && data.cwd.length > 0 ? data.cwd : void 0;
 		if (idx.size === 0) {
 			const count = await rebuildIndex(kv);
 			ctx.logger.info("Search index rebuilt", { entries: count });
 		}
-		const results = idx.search(data.query, data.limit || 20);
-		const enriched = [];
+		const filtering = !!(projectFilter || cwdFilter);
+		const fetchLimit = filtering ? Math.max(effectiveLimit * 10, 100) : effectiveLimit;
+		const results = idx.search(query, fetchLimit);
+		const sessionCache = /* @__PURE__ */ new Map();
+		const loadSession = async (sessionId) => {
+			if (sessionCache.has(sessionId)) return sessionCache.get(sessionId);
+			const s = await kv.get(KV.sessions, sessionId);
+			sessionCache.set(sessionId, s ?? null);
+			return s ?? null;
+		};
+		const candidates = [];
 		for (const r of results) {
-			const obs = await kv.get(KV.observations(r.sessionId), r.obsId);
+			if (candidates.length >= effectiveLimit) break;
+			if (filtering) {
+				const s = await loadSession(r.sessionId);
+				if (!s) continue;
+				if (projectFilter && s.project !== projectFilter) continue;
+				if (cwdFilter && s.cwd !== cwdFilter) continue;
+			}
+			candidates.push(r);
+		}
+		const obsResults = await Promise.all(candidates.map((r) => kv.get(KV.observations(r.sessionId), r.obsId)));
+		const enriched = [];
+		for (let i = 0; i < candidates.length; i++) {
+			const obs = obsResults[i];
 			if (obs) enriched.push({
 				observation: obs,
-				score: r.score,
-				sessionId: r.sessionId
+				score: candidates[i].score,
+				sessionId: candidates[i].sessionId
 			});
 		}
 		ctx.logger.info("Search completed", {
-			query: data.query,
-			results: enriched.length
+			query,
+			results: enriched.length,
+			hasProjectFilter: !!projectFilter,
+			hasCwdFilter: !!cwdFilter
 		});
 		return { results: enriched };
 	});
@@ -3805,7 +3910,7 @@ function registerAutoForgetFunction(sdk, kv) {
 
 //#endregion
 //#region src/version.ts
-const VERSION = "0.7.8";
+const VERSION = "0.8.0";
 
 //#endregion
 //#region src/functions/export-import.ts
@@ -3910,7 +4015,8 @@ function registerExportImportFunction(sdk, kv) {
 			"0.7.5",
 			"0.7.6",
 			"0.7.7",
-			"0.7.8"
+			"0.7.9",
+			"0.8.0"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -10033,9 +10139,32 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction({ id: "api::search" }, async (req) => {
 		const authErr = checkAuth$1(req, secret);
 		if (authErr) return authErr;
+		const body = req.body ?? {};
+		if (typeof body.query !== "string" || !body.query.trim()) return {
+			status_code: 400,
+			body: { error: "query is required and must be a non-empty string" }
+		};
+		if (body.limit !== void 0 && (!Number.isInteger(body.limit) || body.limit < 1)) return {
+			status_code: 400,
+			body: { error: "limit must be a positive integer" }
+		};
+		if (body.project !== void 0 && typeof body.project !== "string") return {
+			status_code: 400,
+			body: { error: "project must be a string" }
+		};
+		if (body.cwd !== void 0 && typeof body.cwd !== "string") return {
+			status_code: 400,
+			body: { error: "cwd must be a string" }
+		};
+		const payload = {
+			query: body.query.trim(),
+			limit: body.limit,
+			project: body.project,
+			cwd: body.cwd
+		};
 		return {
 			status_code: 200,
-			body: await sdk.trigger("mem::search", req.body)
+			body: await sdk.trigger("mem::search", payload)
 		};
 	});
 	sdk.registerTrigger({