@agentmemory/agentmemory 0.7.9 → 0.8.0

package/README.md

@@ -241,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
@@ -298,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
@@ -613,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 |
 
@@ -626,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=...
 
@@ -640,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
@@ -703,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-DNbB7fd7.mjs");
+		await import("./src-qOdKVNQz.mjs");
 		return;
 	}
 	if (await isEngineRunning()) {
 		p.log.success("iii-engine is running");
-		await import("./src-DNbB7fd7.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-DNbB7fd7.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":";;;;;;;;AAQA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AACzD,MAAM,OAAO,QAAQ,KAAK,MAAM,EAAE;AAElC,IAAI,KAAK,SAAS,SAAS,IAAI,KAAK,SAAS,KAAK,EAAE;AAClD,SAAQ,IAAI;;;;;;;;;;;;;;;;;;;EAmBZ;AACA,SAAQ,KAAK,EAAE;;AAGjB,MAAM,WAAW,KAAK,QAAQ,UAAU;AACxC,IAAI,aAAa,MAAM,KAAK,WAAW,GACrC,SAAQ,IAAI,uBAAuB,KAAK,WAAW;AAGrD,MAAM,UAAU,KAAK,QAAQ,SAAS;AACtC,IAAI,YAAY,MAAM,KAAK,UAAU,GACnC,SAAQ,IAAI,mBAAmB,KAAK,UAAU;AAGhD,MAAM,aAAa,KAAK,SAAS,cAAc;AAE/C,SAAS,cAAsB;AAC7B,QAAO,SAAS,QAAQ,IAAI,oBAAoB,QAAQ,GAAG,IAAI;;AAGjE,eAAe,kBAAoC;AACjD,KAAI;AACF,QAAM,MAAM,oBAAoB,aAAa,CAAC,IAAI,EAChD,QAAQ,YAAY,QAAQ,IAAK,EAClC,CAAC;AACF,SAAO;SACD;AACN,SAAO;;;AAIX,SAAS,gBAAwB;CAC/B,MAAM,aAAa;EACjB,KAAK,WAAW,kBAAkB;EAClC,KAAK,WAAW,MAAM,kBAAkB;EACxC,KAAK,QAAQ,KAAK,EAAE,kBAAkB;EACvC;AACD,MAAK,MAAM,KAAK,WACd,KAAI,WAAW,EAAE,CAAE,QAAO;AAE5B,QAAO;;AAGT,SAAS,YAAY,MAA6B;CAChD,MAAM,MAAM,QAAQ,aAAa,UAAU,UAAU;AACrD,KAAI;AACF,SAAO,aAAa,KAAK,CAAC,KAAK,EAAE,EAAE,UAAU,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;SACrE;AACN,SAAO;;;AAIX,eAAe,aAA+B;AAC5C,KAAI,QAAQ,aAAa,SAAS;AAChC,IAAE,IAAI,KAAK,4DAA4D;AACvE,IAAE,IAAI,KAAK,yCAAyC;AACpD,SAAO;;AAIT,KAAI,CADY,YAAY,OAAO,EACrB;AACZ,IAAE,IAAI,KAAK,mDAAmD;AAC9D,SAAO;;CAGT,MAAM,gBAAgB,MAAM,EAAE,QAAQ;EACpC,SAAS;EACT,cAAc;EACf,CAAC;AAEF,KAAI,EAAE,SAAS,cAAc,IAAI,CAAC,cAChC,QAAO;CAGT,MAAM,IAAI,EAAE,SAAS;AACrB,GAAE,MAAM,2BAA2B;AAEnC,KAAI;AACF,WAAS,+DAA+D;GACtE,OAAO;IAAC;IAAQ;IAAQ;IAAO;GAC/B,SAAS;GACV,CAAC;AAGF,MADkB,YAAY,MAAM,EACrB;AACb,KAAE,KAAK,oCAAoC;AAC3C,UAAO;;AAGT,IAAE,KAAK,mDAAmD;AAC1D,IAAE,IAAI,KAAK,8DAA8D;EAEzE,MAAM,WAAW,CACf,KAAK,QAAQ,IAAI,WAAW,IAAI,UAAU,OAAO,MAAM,EACvD,qBACD;AACD,OAAK,MAAM,WAAW,SACpB,KAAI,WAAW,QAAQ,EAAE;AACvB,KAAE,IAAI,KAAK,iBAAiB,UAAU;AACtC,WAAQ,IAAI,UAAU,GAAG,QAAQ,QAAQ,CAAC,GAAG,QAAQ,IAAI;AACzD,UAAO;;AAIX,SAAO;UACA,KAAK;AACZ,IAAE,KAAK,+BAA+B;AACtC,IAAE,IAAI,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC7D,SAAO;;;AAIX,eAAe,cAAgC;CAC7C,MAAM,aAAa,eAAe;CAClC,IAAI,SAAS,YAAY,MAAM;AAE/B,KAAI,CAAC,QAEH;MADkB,MAAM,YAAY,CAElC,UAAS,YAAY,MAAM;;AAI/B,KAAI,UAAU,YAAY;EACxB,MAAM,IAAI,EAAE,SAAS;AACrB,IAAE,MAAM,wBAAwB,SAAS;AAKzC,EAJc,MAAM,QAAQ,CAAC,YAAY,WAAW,EAAE;GACpD,UAAU;GACV,OAAO;GACR,CAAC,CACI,OAAO;AACb,IAAE,KAAK,6BAA6B;AACpC,SAAO;;CAGT,MAAM,YAAY,YAAY,SAAS;CACvC,MAAM,gBAAgB,KAAK,WAAW,MAAM,qBAAqB;CACjE,MAAM,WAAW,WAAW,cAAc,IAAI,WAAW,KAAK,QAAQ,KAAK,EAAE,qBAAqB,CAAC;AAEnG,KAAI,aAAa,UAAU;EACzB,MAAM,cAAc,WAAW,cAAc,GAAG,gBAAgB,KAAK,QAAQ,KAAK,EAAE,qBAAqB;EACzG,MAAM,IAAI,EAAE,SAAS;AACrB,IAAE,MAAM,oCAAoC;AAK5C,EAJc,MAAM,WAAW;GAAC;GAAW;GAAM;GAAa;GAAM;GAAK,EAAE;GACzE,UAAU;GACV,OAAO;GACR,CAAC,CACI,OAAO;AACb,IAAE,KAAK,yBAAyB;AAChC,SAAO;;AAGT,QAAO;;AAGT,eAAe,cAAc,WAAqC;CAChE,MAAM,QAAQ,KAAK,KAAK;AACxB,QAAO,KAAK,KAAK,GAAG,QAAQ,WAAW;AACrC,MAAI,MAAM,iBAAiB,CAAE,QAAO;AACpC,QAAM,IAAI,SAAS,MAAM,WAAW,GAAG,IAAI,CAAC;;AAE9C,QAAO;;AAGT,eAAe,OAAO;AACpB,GAAE,MAAM,cAAc;AAEtB,KAAI,YAAY;AACd,IAAE,IAAI,KAAK,sCAAsC;AACjD,QAAM,OAAO;AACb;;AAGF,KAAI,MAAM,iBAAiB,EAAE;AAC3B,IAAE,IAAI,QAAQ,wBAAwB;AACtC,QAAM,OAAO;AACb;;AAIF,KAAI,CADY,MAAM,aAAa,EACrB;AACZ,IAAE,IAAI,MAAM,8BAA8B;AAC1C,IAAE,KACA;GACE;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACD,CAAC,KAAK,KAAK,EACZ,iBACD;AACD,UAAQ,KAAK,EAAE;;CAGjB,MAAM,IAAI,EAAE,SAAS;AACrB,GAAE,MAAM,wCAAwC;AAGhD,KAAI,CADU,MAAM,cAAc,KAAM,EAC5B;EACV,MAAM,OAAO,aAAa;AAC1B,IAAE,KAAK,6CAA6C;AACpD,IAAE,IAAI,MAAM,oBAAoB,KAAK,IAAI,OAAO,EAAE,wBAAwB;AAC1E,UAAQ,KAAK,EAAE;;AAGjB,GAAE,KAAK,sBAAsB;AAC7B,OAAM,OAAO;;AAGf,eAAe,YAAY;CACzB,MAAM,OAAO,aAAa;CAC1B,MAAM,OAAO,oBAAoB;AACjC,GAAE,MAAM,qBAAqB;AAG7B,KAAI,CADO,MAAM,iBAAiB,EACzB;AACP,IAAE,IAAI,MAAM,qCAAqC,OAAO;AACxD,IAAE,IAAI,KAAK,2CAA2C;AACtD,UAAQ,KAAK,EAAE;;AAGjB,KAAI;EACF,MAAM,CAAC,WAAW,aAAa,YAAY,MAAM,QAAQ,IAAI;GAC3D,MAAM,GAAG,KAAK,sBAAsB,EAAE,QAAQ,YAAY,QAAQ,IAAK,EAAE,CAAC,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,YAAY,KAAK;GAClH,MAAM,GAAG,KAAK,wBAAwB,EAAE,QAAQ,YAAY,QAAQ,IAAK,EAAE,CAAC,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,YAAY,KAAK;GACpH,MAAM,GAAG,KAAK,2BAA2B,EAAE,QAAQ,YAAY,QAAQ,IAAK,EAAE,CAAC,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC,CAAC,YAAY,KAAK;GACxH,CAAC;EAEF,MAAM,IAAI,WAAW;EACrB,MAAM,SAAS,WAAW,UAAU;EACpC,MAAM,UAAU,WAAW,WAAW;EACtC,MAAM,WAAW,MAAM,QAAQ,aAAa,SAAS,GAAG,YAAY,SAAS,SAAS;AACrE,KAAG,UAAU,IAAI;EAClC,MAAM,QAAQ,UAAU,SAAS;EACjC,MAAM,QAAQ,UAAU,SAAS;EACjC,MAAM,KAAK,WAAW,gBAAgB,SAAS;EAC/C,MAAM,SAAS,GAAG,SAAS,KAAK,MAAM,EAAE,OAAO,WAAW,QAAQ,GAAG;EACrE,MAAM,SAAS,GAAG,gBAAgB,KAAK,MAAM,EAAE,cAAc,GAAG;AAEhE,IAAE,IAAI,QAAQ,gBAAgB,QAAQ,WAAW,OAAO;EAExD,MAAM,QAAQ;GACZ,eAAe,WAAW,YAAY,YAAY;GAClD,eAAe;GACf,eAAe,MAAM,UAAU,MAAM;GACrC,eAAe;GACf,eAAe,OAAO;GACtB,eAAe,OAAO;GACtB,gCAAgC,OAAO;GACxC;AACD,IAAE,KAAK,MAAM,KAAK,KAAK,EAAE,cAAc;UAChC,KAAK;AACZ,IAAE,IAAI,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC7D,UAAQ,KAAK,EAAE;;;AAInB,IAAI,KAAK,OAAO,SACd,YAAW,CAAC,OAAO,QAAQ;AACzB,GAAE,IAAI,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC7D,SAAQ,KAAK,EAAE;EACf;IAEF,OAAM,CAAC,OAAO,QAAQ;AACpB,GAAE,IAAI,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC7D,SAAQ,KAAK,EAAE;EACf"}

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.9";
+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.9"
+			"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({