openclaw-amem 1.1.5 → 1.2.0

package/README.md

@@ -110,8 +110,8 @@ A memory plugin's job is to read configuration from the environment and send mem
 
 What it actually does — all of it declared in [`openclaw.plugin.json`](openclaw.plugin.json):
 
-- **Environment variables it reads** (its configuration surface, supplied by you): `AMEM_LLM_API_KEY`, `AMEM_LLM_BASE_URL`, `AMEM_LLM_MODEL`, `AMEM_COLLECTION`, `AMEM_DATA_DIR`, `AMEM_EVO_COUNTER_PATH`, `AMEM_REVIEW_DIR`, `AMEM_PROMPT_LOCALE`. No credential is bundled, hardcoded, or logged.
-- **Network destinations**: only your **local Qdrant** (`http://localhost:6333`) and your configured **LLM endpoint** (Anthropic by default, or `AMEM_LLM_BASE_URL`). It sends memory text/embeddings there to store and evolve notes — its stated purpose. It does not phone home.
+- **Environment variables it reads** (its configuration surface, supplied by you): `AMEM_LLM_PROVIDER`, `AMEM_LLM_API_KEY`, `AMEM_LLM_BASE_URL`, `AMEM_LLM_MODEL`, `AMEM_COLLECTION`, `AMEM_DATA_DIR`, `AMEM_EVO_COUNTER_PATH`, `AMEM_REVIEW_DIR`, `AMEM_PROMPT_LOCALE`. No credential is bundled, hardcoded, or logged.
+- **Network destinations**: only your **local Qdrant** (`http://localhost:6333`) and your configured **LLM endpoint** (Anthropic by default, or any OpenAI-compatible endpoint via `AMEM_LLM_PROVIDER=openai` + `AMEM_LLM_BASE_URL`). It sends memory text/embeddings there to store and evolve notes — its stated purpose. It does not phone home.
 - **Conversation content** is processed for memory only when you set `hooks.allowConversationAccess: true`. Keep Qdrant and review-output paths scoped to locations you control.
 
 ## Development

package/dist/index.js

@@ -122,468 +122,6 @@ var init_embedding = __esm({
   }
 });
 
-// ../amem-core/src/evo-counter.ts
-function counterFile() {
-  return process.env.AMEM_EVO_COUNTER_PATH || path2.join(getDataDir(), "amem_evo_cnt.json");
-}
-function getEvoCount() {
-  try {
-    const data = JSON.parse(fs.readFileSync(counterFile(), "utf-8"));
-    return data.count || 0;
-  } catch {
-    return 0;
-  }
-}
-function incrementEvoCount() {
-  const count = getEvoCount() + 1;
-  fs.writeFileSync(counterFile(), JSON.stringify({ count, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }));
-  return count;
-}
-function shouldRunEvolution() {
-  const count = incrementEvoCount();
-  return count % EVO_THRESHOLD === 0;
-}
-var fs, path2, EVO_THRESHOLD;
-var init_evo_counter = __esm({
-  "../amem-core/src/evo-counter.ts"() {
-    "use strict";
-    fs = __toESM(require("fs"), 1);
-    path2 = __toESM(require("path"), 1);
-    init_config();
-    EVO_THRESHOLD = 20;
-  }
-});
-
-// ../amem-core/src/prompts.ts
-var LOCALE, en, zh, templates, t;
-var init_prompts = __esm({
-  "../amem-core/src/prompts.ts"() {
-    "use strict";
-    LOCALE = process.env.AMEM_PROMPT_LOCALE === "zh" ? "zh" : "en";
-    en = {
-      crudDecision: (userText, assistantText, memoryList) => `You are a memory management agent. Analyze the conversation and decide what memory operations are needed.
-
-## Conversation
-
-User: ${userText}
-Assistant: ${assistantText}
-
-## Existing relevant memories (identified by integer idx)
-
-${memoryList}
-
-## Task
-
-Extract only genuinely important long-term facts (decisions, preferences, account info, project status, key insights). Skip small talk, confirmations, and information already captured in existing memories.
-
-## Operation types
-- NEW: Extract a brand new fact not present in existing memories
-- UPDATE: New information refines or supersedes an existing memory; specify existingIdx
-- DELETE: An existing memory is outdated, contradicted, or wrong; specify existingIdx, fact = original content
-- NONE: Nothing worth recording, or information already fully captured
-
-## Output format
-
-Return a JSON array. Each item:
-{"action": "NEW"|"UPDATE"|"DELETE"|"NONE", "fact": "fact content", "existingIdx": integer or omit, "reason": "optional"}
-
-Return at most 3 operations. If nothing is worth recording, return [].
-Return only the JSON array, no other text.
-
-Examples:
-
-1. New preference:
-[{"action": "NEW", "fact": "User prefers TypeScript over JavaScript", "reason": "Explicitly stated tech preference"}]
-
-2. Updating an existing memory (idx 0 was "User is evaluating React and Vue"):
-[{"action": "UPDATE", "fact": "User decided to use React (dropped Vue)", "existingIdx": 0, "reason": "Decision finalized, update evaluation status"}]
-
-3. Conversation is just "Sure, thanks" / "Got it" with no new info:
-[]`,
-      shouldMerge: (contentA, contentB) => `You are a memory deduplication assistant. Determine whether two memories express essentially the same information.
-
-Memory A: ${contentA}
-Memory B: ${contentB}
-
-Rules:
-- If both memories express the same core fact (possibly different wording or granularity), return:
-  {"shouldMerge": true, "merged": "Concise merged statement preserving key details from both, more complete than either alone"}
-- If the memories are complementary, on different topics, or contain different specific facts, return:
-  {"shouldMerge": false}
-
-Return only JSON, no other text.
-
-Examples:
-
-1. Should merge (different granularity):
-A: "Project uses PostgreSQL"
-B: "Project's primary database is PostgreSQL 16, deployed on AWS RDS"
--> {"shouldMerge": true, "merged": "Project uses PostgreSQL 16 as primary database, deployed on AWS RDS"}
-
-2. Should NOT merge (complementary but distinct):
-A: "User prefers VS Code"
-B: "User's VS Code uses One Dark Pro theme"
--> {"shouldMerge": false}`,
-      evolutionJudge: (oldContent, newContent) => `You are a memory evolution judge. Analyze the relationship between an old and new memory and return JSON.
-
-Old memory: ${oldContent}
-New memory: ${newContent}
-
-Classification rules:
-
-- EVOLVE: New content deepens or updates the old memory (e.g. "Considering Next.js" -> "Decided on Next.js 14 App Router")
-  Return: {"type": "EVOLVE", "mergedContent": "Merged content preserving the evolution trajectory"}
-
-- CONFLICT: Old and new information directly contradict each other on the same attribute (e.g. "Uses MySQL as primary DB" vs "Migrated to PostgreSQL")
-  Return: {"type": "CONFLICT"}
-
-- EXPAND: New information supplements the old memory on the same topic (e.g. "Handles backend dev" + "Backend uses Go and gRPC")
-  Return: {"type": "EXPAND", "mergedContent": "Merged content integrating both pieces of information"}
-
-- NEW: Completely unrelated information, no substantive connection to the old memory
-  Return: {"type": "NEW"}
-
-Return only JSON, no other text.`
-    };
-    zh = {
-      crudDecision: (userText, assistantText, memoryList) => `\u4F60\u662F\u4E00\u4E2A\u8BB0\u5FC6\u7BA1\u7406 agent\uFF0C\u8D1F\u8D23\u5206\u6790\u5BF9\u8BDD\u5185\u5BB9\u5E76\u51B3\u5B9A\u5982\u4F55\u64CD\u4F5C\u8BB0\u5FC6\u5E93\u3002
-
-## \u5BF9\u8BDD\u5185\u5BB9
-
-\u7528\u6237\uFF1A${userText}
-\u52A9\u624B\uFF1A${assistantText}
-
-## \u5DF2\u6709\u76F8\u5173\u8BB0\u5FC6\uFF08\u7528\u6574\u6570 idx \u6807\u8BC6\uFF09
-
-${memoryList}
-
-## \u4EFB\u52A1
-
-\u5206\u6790\u4E0A\u8FF0\u5BF9\u8BDD\uFF0C\u51B3\u5B9A\u9700\u8981\u54EA\u4E9B\u8BB0\u5FC6\u64CD\u4F5C\u3002\u53EA\u63D0\u53D6\u771F\u6B63\u91CD\u8981\u7684\u957F\u671F\u4E8B\u5B9E\uFF08\u51B3\u7B56\u3001\u504F\u597D\u3001\u8D26\u53F7\u4FE1\u606F\u3001\u9879\u76EE\u72B6\u6001\u3001\u5173\u952E\u6D1E\u5BDF\uFF09\u3002\u8DF3\u8FC7\u95F2\u804A\u3001\u786E\u8BA4\u8BED\u3001\u91CD\u590D\u4FE1\u606F\u3002
-
-## \u64CD\u4F5C\u7C7B\u578B
-- NEW\uFF1A\u63D0\u53D6\u5168\u65B0\u4E8B\u5B9E\uFF08\u5DF2\u6709\u8BB0\u5FC6\u4E2D\u6CA1\u6709\u7684\u4FE1\u606F\uFF09
-- UPDATE\uFF1A\u65B0\u4FE1\u606F\u66F4\u65B0\u4E86\u67D0\u6761\u5DF2\u6709\u8BB0\u5FC6\uFF0C\u7528 existingIdx \u6307\u5B9A\u8981\u66F4\u65B0\u7684\u6761\u76EE
-- DELETE\uFF1A\u67D0\u6761\u5DF2\u6709\u8BB0\u5FC6\u5DF2\u7ECF\u8FC7\u65F6\u3001\u53D1\u751F\u51B2\u7A81\u6216\u9519\u8BEF\uFF0C\u7528 existingIdx \u6307\u5B9A\uFF0Cfact \u586B\u539F\u5185\u5BB9
-- NONE\uFF1A\u4E0D\u503C\u5F97\u8BB0\u5F55\u6216\u5DF2\u6709\u5B8C\u5168\u76F8\u540C\u7684\u4FE1\u606F
-
-## \u8F93\u51FA\u683C\u5F0F
-
-\u8FD4\u56DE JSON \u6570\u7EC4\uFF0C\u6BCF\u6761\u683C\u5F0F\uFF1A
-{"action": "NEW"|"UPDATE"|"DELETE"|"NONE", "fact": "\u4E8B\u5B9E\u5185\u5BB9", "existingIdx": \u6574\u6570\u6216\u7701\u7565, "reason": "\u539F\u56E0\uFF08\u53EF\u9009\uFF09"}
-
-\u6BCF\u6B21\u6700\u591A\u8FD4\u56DE 3 \u6761\u64CD\u4F5C\u3002\u5982\u679C\u6CA1\u6709\u503C\u5F97\u64CD\u4F5C\u7684\u5185\u5BB9\uFF0C\u8FD4\u56DE []\u3002
-\u53EA\u8FD4\u56DE JSON \u6570\u7EC4\uFF0C\u4E0D\u8981\u4EFB\u4F55\u5176\u4ED6\u6587\u5B57\u3002
-
-\u793A\u4F8B\uFF1A
-
-1. \u63D0\u53D6\u65B0\u504F\u597D\uFF1A
-[{"action": "NEW", "fact": "\u7528\u6237\u504F\u597D TypeScript \u800C\u975E JavaScript", "reason": "\u660E\u786E\u8868\u8FBE\u7684\u6280\u672F\u504F\u597D"}]
-
-2. \u66F4\u65B0\u5DF2\u6709\u8BB0\u5FC6\uFF08idx 0 \u539F\u4E3A"\u7528\u6237\u6B63\u5728\u8BC4\u4F30 React \u548C Vue"\uFF09\uFF1A
-[{"action": "UPDATE", "fact": "\u7528\u6237\u51B3\u5B9A\u4F7F\u7528 React\uFF08\u653E\u5F03\u4E86 Vue\uFF09", "existingIdx": 0, "reason": "\u51B3\u7B56\u5DF2\u660E\u786E\uFF0C\u66F4\u65B0\u8BC4\u4F30\u72B6\u6001"}]
-
-3. \u5BF9\u8BDD\u4EC5\u4E3A"\u597D\u7684\uFF0C\u8C22\u8C22"/"\u6CA1\u95EE\u9898"\u7B49\u786E\u8BA4\u8BED\uFF0C\u65E0\u65B0\u4FE1\u606F\uFF1A
-[]`,
-      shouldMerge: (contentA, contentB) => `\u4F60\u662F\u4E00\u4E2A\u8BB0\u5FC6\u53BB\u91CD\u52A9\u624B\uFF0C\u8D1F\u8D23\u5224\u65AD\u4E24\u6761\u8BB0\u5FC6\u662F\u5426\u8868\u8FBE\u4E86\u672C\u8D28\u76F8\u540C\u7684\u4FE1\u606F\u3002
-
-\u8BB0\u5FC6A\uFF1A${contentA}
-\u8BB0\u5FC6B\uFF1A${contentB}
-
-\u5224\u65AD\u89C4\u5219\uFF1A
-- \u5982\u679C\u4E24\u6761\u8BB0\u5FC6\u8868\u8FBE\u7684\u662F\u672C\u8D28\u76F8\u540C\u7684\u4FE1\u606F\uFF08\u53EF\u80FD\u63AA\u8F9E\u4E0D\u540C\u3001\u7C92\u5EA6\u4E0D\u540C\uFF0C\u4F46\u6838\u5FC3\u4E8B\u5B9E\u4E00\u81F4\uFF09\uFF0C\u8FD4\u56DE JSON\uFF1A
-  {"shouldMerge": true, "merged": "\u5408\u5E76\u540E\u7684\u7B80\u6D01\u8868\u8FF0\uFF0C\u4FDD\u7559\u4E24\u6761\u8BB0\u5FC6\u7684\u5173\u952E\u4FE1\u606F\uFF0C\u6BD4\u4EFB\u4F55\u4E00\u6761\u90FD\u66F4\u5B8C\u6574"}
-- \u5982\u679C\u4E24\u6761\u8BB0\u5FC6\u662F\u4E92\u8865\u4FE1\u606F\u3001\u4E0D\u540C\u4E3B\u9898\u3001\u6216\u5305\u542B\u4E0D\u540C\u7684\u5177\u4F53\u4E8B\u5B9E\uFF0C\u8FD4\u56DE JSON\uFF1A
-  {"shouldMerge": false}
-
-\u53EA\u8FD4\u56DE JSON\uFF0C\u4E0D\u8981\u4EFB\u4F55\u5176\u4ED6\u6587\u5B57\u3002
-
-\u793A\u4F8B\uFF1A
-
-1. \u5E94\u5408\u5E76\uFF08\u7C92\u5EA6\u4E0D\u540C\uFF09\uFF1A
-A: "\u9879\u76EE\u4F7F\u7528 PostgreSQL \u6570\u636E\u5E93"
-B: "\u9879\u76EE\u7684\u4E3B\u6570\u636E\u5E93\u662F PostgreSQL 16\uFF0C\u90E8\u7F72\u5728 AWS RDS \u4E0A"
-\u2192 {"shouldMerge": true, "merged": "\u9879\u76EE\u4F7F\u7528 PostgreSQL 16 \u4F5C\u4E3A\u4E3B\u6570\u636E\u5E93\uFF0C\u90E8\u7F72\u5728 AWS RDS \u4E0A"}
-
-2. \u4E0D\u5E94\u5408\u5E76\uFF08\u4E92\u8865\u4F46\u4E0D\u540C\uFF09\uFF1A
-A: "\u7528\u6237\u559C\u6B22\u7528 VS Code"
-B: "\u7528\u6237\u7684 VS Code \u4F7F\u7528 One Dark Pro \u4E3B\u9898"
-\u2192 {"shouldMerge": false}`,
-      evolutionJudge: (oldContent, newContent) => `\u4F60\u662F\u4E00\u4E2A\u8BB0\u5FC6\u6F14\u5316\u5224\u65AD\u52A9\u624B\u3002\u5206\u6790\u4EE5\u4E0B\u4E24\u6761\u8BB0\u5FC6\u7684\u5173\u7CFB\u5E76\u8FD4\u56DE JSON\u3002
-
-\u65E7\u8BB0\u5FC6\uFF1A${oldContent}
-\u65B0\u8BB0\u5FC6\uFF1A${newContent}
-
-\u5224\u65AD\u89C4\u5219\uFF1A
-
-- EVOLVE\uFF1A\u65B0\u5185\u5BB9\u662F\u5BF9\u65E7\u8BB0\u5FC6\u7684\u6DF1\u5316/\u66F4\u65B0\uFF08\u5982\u300C\u6B63\u5728\u8003\u8651\u7528 Next.js\u300D\u2192\u300C\u51B3\u5B9A\u7528 Next.js 14 App Router\u300D\uFF09
-  \u8FD4\u56DE\uFF1A{"type": "EVOLVE", "mergedContent": "\u878D\u5408\u540E\u7684\u5B8C\u6574\u5185\u5BB9\uFF0C\u4FDD\u7559\u6F14\u5316\u8F68\u8FF9"}
-
-- CONFLICT\uFF1A\u65B0\u65E7\u4FE1\u606F\u5728\u540C\u4E00\u5C5E\u6027\u4E0A\u76F4\u63A5\u77DB\u76FE\uFF08\u5982\u300C\u4F7F\u7528 MySQL \u4F5C\u4E3A\u4E3B\u6570\u636E\u5E93\u300Dvs\u300C\u5DF2\u8FC1\u79FB\u5230 PostgreSQL\u300D\uFF09
-  \u8FD4\u56DE\uFF1A{"type": "CONFLICT"}
-
-- EXPAND\uFF1A\u65B0\u4FE1\u606F\u662F\u5BF9\u65E7\u8BB0\u5FC6\u540C\u4E00\u4E3B\u9898\u7684\u8865\u5145\u6269\u5C55\uFF08\u5982\u300C\u8D1F\u8D23\u540E\u7AEF\u5F00\u53D1\u300D+\u300C\u540E\u7AEF\u4F7F\u7528 Go \u548C gRPC\u300D\uFF09
-  \u8FD4\u56DE\uFF1A{"type": "EXPAND", "mergedContent": "\u5408\u5E76\u540E\u7684\u5B8C\u6574\u5185\u5BB9\uFF0C\u6574\u5408\u53CC\u65B9\u4FE1\u606F"}
-
-- NEW\uFF1A\u5168\u65B0\u4FE1\u606F\uFF0C\u4E0E\u65E7\u8BB0\u5FC6\u65E0\u5B9E\u8D28\u5173\u8054\uFF08\u5982\u300C\u559C\u6B22 dark mode\u300Dvs\u300C\u4E0B\u5468\u8981\u53BB\u51FA\u5DEE\u300D\uFF09
-  \u8FD4\u56DE\uFF1A{"type": "NEW"}
-
-\u53EA\u8FD4\u56DE JSON\uFF0C\u4E0D\u8981\u4EFB\u4F55\u5176\u4ED6\u6587\u5B57\u3002`
-    };
-    templates = { en, zh };
-    t = templates[LOCALE];
-  }
-});
-
-// ../amem-core/src/llm.ts
-async function llmCall(prompt, maxTokens = 500) {
-  try {
-    const isThinking = MODEL.includes("gemini") || MODEL.includes("pro-agent");
-    const effectiveMaxTokens = isThinking ? Math.max(maxTokens * 8, 4e3) : maxTokens;
-    const resp = await client.messages.create({
-      model: MODEL,
-      max_tokens: effectiveMaxTokens,
-      messages: [{ role: "user", content: prompt }]
-    });
-    for (const block of resp.content) {
-      if (block.type === "text") return block.text.trim();
-    }
-    return null;
-  } catch (e) {
-    console.error(`[amem] LLM call failed: ${e.message}`);
-    return null;
-  }
-}
-function stripFences(raw) {
-  raw = raw.trim();
-  if (raw.startsWith("```")) {
-    const lines = raw.split("\n");
-    lines.shift();
-    if (lines[lines.length - 1] === "```") lines.pop();
-    raw = lines.join("\n").trim();
-  }
-  if (raw.startsWith('"') && raw.endsWith('"') || raw.startsWith("'") && raw.endsWith("'")) {
-    try {
-      raw = JSON.parse(raw);
-    } catch {
-    }
-  }
-  return raw;
-}
-async function llmConstructNote(content) {
-  const prompt = `Analyze the following text and respond with valid JSON only (no markdown fences, no explanation, no comments). All string values must use standard double quotes and be properly escaped:
-{
-  "keywords": ["keyword1", "keyword2"],
-  "tags": ["tag1", "tag2"],
-  "context": "one sentence summary in the same language as the input",
-  "category": "Technical|Business|Personal|Project|Research|System|General",
-  "note_type": "memory|knowledge",
-  "topics": ["Topic1", "Topic2"],
-  "confidence": "high|medium|low"
-}
-
-Category guide:
-- Technical: code, tools, configuration, APIs, debugging
-- Business: company, finance, compliance, contracts, invoices
-- Personal: personal state, habits, preferences, emotions
-- Project: project progress, decisions, milestones
-- Research: research, literature, evaluation, comparison
-- System: system services, monitoring, operations
-- General: anything that does not fit the above
-
-note_type guide:
-- knowledge: books, methodologies, tools, domain knowledge, reference material \u2014 durable, no strong time component
-- memory: events, decisions, preferences, states, observations \u2014 episodic, time-sensitive
-
-topics guide (Story 26B):
-- Only populate for knowledge notes (note_type=knowledge). For memory notes, return [].
-- List 1-5 concise subject tags representing the main topics of this knowledge, e.g. ["TypeScript", "Qdrant", "Vector DB"].
-
-confidence guide (Story 27):
-- high: note_type is unambiguous \u2014 clearly episodic (event/decision/state) or clearly durable knowledge (tool doc/methodology)
-- medium: some ambiguity \u2014 e.g. "learned X method" could be either memory or knowledge
-- low: LLM is uncertain \u2014 vague, fragmentary, or mixed content
-
-Text: ${content}`;
-  const raw = await llmCall(prompt, 400);
-  if (!raw)
-    return {
-      keywords: [],
-      tags: [],
-      context: "",
-      category: "General",
-      note_type: "memory",
-      topics: [],
-      confidence: "medium"
-    };
-  try {
-    const data = JSON.parse(stripFences(raw));
-    const rawCategory = typeof data.category === "string" ? data.category : "General";
-    const category = VALID_CATEGORIES.has(rawCategory) ? rawCategory : "General";
-    const note_type = data.note_type === "knowledge" ? "knowledge" : "memory";
-    const topics = note_type === "knowledge" && Array.isArray(data.topics) ? data.topics.filter((v) => typeof v === "string") : [];
-    const rawConfidence = typeof data.confidence === "string" ? data.confidence : "medium";
-    const confidence = VALID_CONFIDENCE.has(rawConfidence) ? rawConfidence : "medium";
-    return {
-      keywords: Array.isArray(data.keywords) ? data.keywords : [],
-      tags: Array.isArray(data.tags) ? data.tags : [],
-      context: typeof data.context === "string" ? data.context : "",
-      category,
-      note_type,
-      topics,
-      confidence
-    };
-  } catch (e) {
-    console.error(`[amem] Note construction parse failed: ${e.message}`);
-    return {
-      keywords: [],
-      tags: [],
-      context: "",
-      category: "General",
-      note_type: "memory",
-      topics: [],
-      confidence: "medium"
-    };
-  }
-}
-async function llmShouldLink(noteContent, candidateContent) {
-  const prompt = `Do these two memory notes have a meaningful relationship that would be useful to link?
-Reply with only "yes" or "no".
-
-Note A: ${noteContent}
-Note B: ${candidateContent}`;
-  const raw = await llmCall(prompt, 10);
-  if (!raw) return false;
-  return raw.toLowerCase().startsWith("yes");
-}
-async function llmCrudDecision(userText, assistantText, existingMemories) {
-  const memoryList = existingMemories.length > 0 ? existingMemories.map((m) => `[${m.idx}] ${m.content}`).join("\n") : "(none)";
-  const prompt = t.crudDecision(userText.slice(0, 500), assistantText.slice(0, 500), memoryList);
-  try {
-    const raw = await llmCall(prompt, 400);
-    if (!raw) return [];
-    const match = raw.match(/\[.*\]/s);
-    if (!match) return [];
-    const parsed = JSON.parse(match[0]);
-    if (!Array.isArray(parsed)) return [];
-    const ops = [];
-    for (const item of parsed) {
-      if (!item || typeof item !== "object") continue;
-      const action = item.action;
-      if (!["NEW", "UPDATE", "DELETE", "NONE"].includes(action)) continue;
-      if (action === "NONE") continue;
-      const op = {
-        action,
-        fact: typeof item.fact === "string" ? item.fact : "",
-        reason: typeof item.reason === "string" ? item.reason : void 0
-      };
-      if (typeof item.existingIdx === "number") {
-        op.existingIdx = item.existingIdx;
-      }
-      ops.push(op);
-    }
-    return ops.slice(0, 3);
-  } catch (e) {
-    console.error(`[amem] llmCrudDecision failed: ${e.message}`);
-    return [];
-  }
-}
-async function llmShouldMerge(contentA, contentB) {
-  const prompt = t.shouldMerge(contentA, contentB);
-  const raw = await llmCall(prompt, 300);
-  if (!raw) return { shouldMerge: false };
-  try {
-    const data = JSON.parse(stripFences(raw));
-    if (typeof data.shouldMerge !== "boolean") return { shouldMerge: false };
-    if (data.shouldMerge && typeof data.merged === "string") {
-      return { shouldMerge: true, merged: data.merged };
-    }
-    return { shouldMerge: false };
-  } catch (e) {
-    console.error(`[amem] llmShouldMerge parse failed: ${e.message}`);
-    return { shouldMerge: false };
-  }
-}
-async function llmEvolutionJudge(oldContent, newContent) {
-  const prompt = t.evolutionJudge(oldContent, newContent);
-  const raw = await llmCall(prompt, 300);
-  if (!raw) return { type: "NEW" };
-  try {
-    const data = JSON.parse(stripFences(raw));
-    const type = VALID_EVOLUTION_TYPES.has(data.type) ? data.type : "NEW";
-    return {
-      type,
-      mergedContent: typeof data.mergedContent === "string" ? data.mergedContent : void 0
-    };
-  } catch (e) {
-    console.error(`[amem] llmEvolutionJudge parse failed: ${e.message}`);
-    return { type: "NEW" };
-  }
-}
-async function llmEvolveNote(content, linkedNotes) {
-  const linkedStr = linkedNotes.map((n) => `- ID: ${n.id}
-  Content: ${n.content}`).join("\n");
-  const prompt = `A memory note has gained new connections. Update its context, tags, and decide whether to strengthen connections with specific neighbors.
-Reply with JSON only (no markdown):
-{
-  "tags": ["tag1", "tag2", ...],
-  "context": "updated one sentence summary",
-  "should_strengthen": true|false,
-  "suggested_connections": ["neighbor_id_1", "neighbor_id_2", ...],
-  "tags_to_update": ["tag_1", ..., "tag_n"]
-}
-
-Guidelines:
-- "tags" and "context" are for updating the original note based on new connections.
-- "should_strengthen" is a decision whether this note should strengthen its connections to any of the newly linked notes (neighbors).
-- "suggested_connections" must contain only IDs from the newly linked notes (neighbors) listed below.
-- "tags_to_update" are updated tags for the original note itself if we strengthen connections.
-
-Original note content: ${content}
-
-Newly linked notes (neighbors):
-${linkedStr}`;
-  const raw = await llmCall(prompt, 500);
-  if (!raw) return { tags: null, context: null, shouldStrengthen: false, suggestedConnections: [], tagsToUpdate: [] };
-  try {
-    const data = JSON.parse(stripFences(raw));
-    return {
-      tags: Array.isArray(data.tags) ? data.tags : null,
-      context: typeof data.context === "string" ? data.context : null,
-      shouldStrengthen: typeof data.should_strengthen === "boolean" ? data.should_strengthen : false,
-      suggestedConnections: Array.isArray(data.suggested_connections) ? data.suggested_connections.map(String) : [],
-      tagsToUpdate: Array.isArray(data.tags_to_update) ? data.tags_to_update.map(String) : []
-    };
-  } catch (e) {
-    console.error(`[amem] Evolution parse failed: ${e.message}`);
-    return { tags: null, context: null, shouldStrengthen: false, suggestedConnections: [], tagsToUpdate: [] };
-  }
-}
-var import_sdk, client, MODEL, VALID_CONFIDENCE, VALID_CATEGORIES, VALID_EVOLUTION_TYPES;
-var init_llm = __esm({
-  "../amem-core/src/llm.ts"() {
-    "use strict";
-    import_sdk = __toESM(require("@anthropic-ai/sdk"), 1);
-    init_prompts();
-    client = new import_sdk.default({
-      ...process.env.AMEM_LLM_API_KEY && { apiKey: process.env.AMEM_LLM_API_KEY },
-      ...process.env.AMEM_LLM_BASE_URL && { baseURL: process.env.AMEM_LLM_BASE_URL }
-    });
-    MODEL = process.env.AMEM_LLM_MODEL ?? "claude-sonnet-4-6";
-    VALID_CONFIDENCE = /* @__PURE__ */ new Set(["high", "medium", "low"]);
-    VALID_CATEGORIES = /* @__PURE__ */ new Set([
-      "Technical",
-      "Business",
-      "Personal",
-      "Project",
-      "Research",
-      "System",
-      "General"
-    ]);
-    VALID_EVOLUTION_TYPES = /* @__PURE__ */ new Set(["EVOLVE", "CONFLICT", "EXPAND", "NEW"]);
-  }
-});
-
 // ../amem-core/src/storage.ts
 async function qdrant(method, path6, body) {
   const res = await fetch(`${QDRANT_URL}${path6}`, {
@@ -601,10 +139,6 @@ async function pingQdrant() {
   const res = await fetch(`${QDRANT_URL}/readyz`);
   if (!res.ok) throw new Error(`Qdrant GET /readyz failed: ${res.status}`);
 }
-function resetCollectionReady() {
-  _collectionReady = false;
-  _collectionReadyMap.clear();
-}
 async function ensureCollection(collectionName) {
   const col = collectionName || getCollection();
   if (collectionName) {
@@ -942,57 +476,526 @@ function makeCrud(collectionName, modeBIsolated = false) {
 function createStorageContext(collectionName, modeBIsolated = false) {
   return makeCrud(collectionName || getCollection(), modeBIsolated);
 }
-async function addNote(note) {
-  return makeCrud(getCollection()).addNote(note);
-}
 async function getNote(id) {
   return makeCrud(getCollection()).getNote(id);
 }
 async function updateNote(note) {
   return makeCrud(getCollection()).updateNote(note);
 }
-async function findByHash(hash, agentId) {
-  return makeCrud(getCollection()).findByHash(hash, agentId);
+async function listNotes(agentId) {
+  return makeCrud(getCollection()).listNotes(agentId);
+}
+async function deleteNote(id) {
+  return makeCrud(getCollection()).deleteNote(id);
+}
+async function invalidateNote(id) {
+  return makeCrud(getCollection()).invalidateNote(id);
+}
+async function patchNotePayload(id, fields) {
+  return makeCrud(getCollection()).patchNotePayload(id, fields);
+}
+var QDRANT_URL, getCollection, VECTOR_DIM, _collectionReady, _collectionReadyMap;
+var init_storage = __esm({
+  "../amem-core/src/storage.ts"() {
+    "use strict";
+    QDRANT_URL = "http://localhost:6333";
+    getCollection = () => process.env.AMEM_COLLECTION || "amem_notes";
+    VECTOR_DIM = 384;
+    _collectionReady = false;
+    _collectionReadyMap = /* @__PURE__ */ new Map();
+  }
+});
+
+// ../amem-core/src/prompts.ts
+var LOCALE, en, zh, templates, t;
+var init_prompts = __esm({
+  "../amem-core/src/prompts.ts"() {
+    "use strict";
+    LOCALE = process.env.AMEM_PROMPT_LOCALE === "zh" ? "zh" : "en";
+    en = {
+      crudDecision: (userText, assistantText, memoryList) => `You are a memory management agent. Analyze the conversation and decide what memory operations are needed.
+
+## Conversation
+
+User: ${userText}
+Assistant: ${assistantText}
+
+## Existing relevant memories (identified by integer idx)
+
+${memoryList}
+
+## Task
+
+Extract only genuinely important long-term facts (decisions, preferences, account info, project status, key insights). Skip small talk, confirmations, and information already captured in existing memories.
+
+## Operation types
+- NEW: Extract a brand new fact not present in existing memories
+- UPDATE: New information refines or supersedes an existing memory; specify existingIdx
+- DELETE: An existing memory is outdated, contradicted, or wrong; specify existingIdx, fact = original content
+- NONE: Nothing worth recording, or information already fully captured
+
+## Output format
+
+Return a JSON array. Each item:
+{"action": "NEW"|"UPDATE"|"DELETE"|"NONE", "fact": "fact content", "existingIdx": integer or omit, "reason": "optional"}
+
+Return at most 3 operations. If nothing is worth recording, return [].
+Return only the JSON array, no other text.
+
+Examples:
+
+1. New preference:
+[{"action": "NEW", "fact": "User prefers TypeScript over JavaScript", "reason": "Explicitly stated tech preference"}]
+
+2. Updating an existing memory (idx 0 was "User is evaluating React and Vue"):
+[{"action": "UPDATE", "fact": "User decided to use React (dropped Vue)", "existingIdx": 0, "reason": "Decision finalized, update evaluation status"}]
+
+3. Conversation is just "Sure, thanks" / "Got it" with no new info:
+[]`,
+      shouldMerge: (contentA, contentB) => `You are a memory deduplication assistant. Determine whether two memories express essentially the same information.
+
+Memory A: ${contentA}
+Memory B: ${contentB}
+
+Rules:
+- If both memories express the same core fact (possibly different wording or granularity), return:
+  {"shouldMerge": true, "merged": "Concise merged statement preserving key details from both, more complete than either alone"}
+- If the memories are complementary, on different topics, or contain different specific facts, return:
+  {"shouldMerge": false}
+
+Return only JSON, no other text.
+
+Examples:
+
+1. Should merge (different granularity):
+A: "Project uses PostgreSQL"
+B: "Project's primary database is PostgreSQL 16, deployed on AWS RDS"
+-> {"shouldMerge": true, "merged": "Project uses PostgreSQL 16 as primary database, deployed on AWS RDS"}
+
+2. Should NOT merge (complementary but distinct):
+A: "User prefers VS Code"
+B: "User's VS Code uses One Dark Pro theme"
+-> {"shouldMerge": false}`,
+      evolutionJudge: (oldContent, newContent) => `You are a memory evolution judge. Analyze the relationship between an old and new memory and return JSON.
+
+Old memory: ${oldContent}
+New memory: ${newContent}
+
+Classification rules:
+
+- EVOLVE: New content deepens or updates the old memory (e.g. "Considering Next.js" -> "Decided on Next.js 14 App Router")
+  Return: {"type": "EVOLVE", "mergedContent": "Merged content preserving the evolution trajectory"}
+
+- CONFLICT: Old and new information directly contradict each other on the same attribute (e.g. "Uses MySQL as primary DB" vs "Migrated to PostgreSQL")
+  Return: {"type": "CONFLICT"}
+
+- EXPAND: New information supplements the old memory on the same topic (e.g. "Handles backend dev" + "Backend uses Go and gRPC")
+  Return: {"type": "EXPAND", "mergedContent": "Merged content integrating both pieces of information"}
+
+- NEW: Completely unrelated information, no substantive connection to the old memory
+  Return: {"type": "NEW"}
+
+Return only JSON, no other text.`
+    };
+    zh = {
+      crudDecision: (userText, assistantText, memoryList) => `\u4F60\u662F\u4E00\u4E2A\u8BB0\u5FC6\u7BA1\u7406 agent\uFF0C\u8D1F\u8D23\u5206\u6790\u5BF9\u8BDD\u5185\u5BB9\u5E76\u51B3\u5B9A\u5982\u4F55\u64CD\u4F5C\u8BB0\u5FC6\u5E93\u3002
+
+## \u5BF9\u8BDD\u5185\u5BB9
+
+\u7528\u6237\uFF1A${userText}
+\u52A9\u624B\uFF1A${assistantText}
+
+## \u5DF2\u6709\u76F8\u5173\u8BB0\u5FC6\uFF08\u7528\u6574\u6570 idx \u6807\u8BC6\uFF09
+
+${memoryList}
+
+## \u4EFB\u52A1
+
+\u5206\u6790\u4E0A\u8FF0\u5BF9\u8BDD\uFF0C\u51B3\u5B9A\u9700\u8981\u54EA\u4E9B\u8BB0\u5FC6\u64CD\u4F5C\u3002\u53EA\u63D0\u53D6\u771F\u6B63\u91CD\u8981\u7684\u957F\u671F\u4E8B\u5B9E\uFF08\u51B3\u7B56\u3001\u504F\u597D\u3001\u8D26\u53F7\u4FE1\u606F\u3001\u9879\u76EE\u72B6\u6001\u3001\u5173\u952E\u6D1E\u5BDF\uFF09\u3002\u8DF3\u8FC7\u95F2\u804A\u3001\u786E\u8BA4\u8BED\u3001\u91CD\u590D\u4FE1\u606F\u3002
+
+## \u64CD\u4F5C\u7C7B\u578B
+- NEW\uFF1A\u63D0\u53D6\u5168\u65B0\u4E8B\u5B9E\uFF08\u5DF2\u6709\u8BB0\u5FC6\u4E2D\u6CA1\u6709\u7684\u4FE1\u606F\uFF09
+- UPDATE\uFF1A\u65B0\u4FE1\u606F\u66F4\u65B0\u4E86\u67D0\u6761\u5DF2\u6709\u8BB0\u5FC6\uFF0C\u7528 existingIdx \u6307\u5B9A\u8981\u66F4\u65B0\u7684\u6761\u76EE
+- DELETE\uFF1A\u67D0\u6761\u5DF2\u6709\u8BB0\u5FC6\u5DF2\u7ECF\u8FC7\u65F6\u3001\u53D1\u751F\u51B2\u7A81\u6216\u9519\u8BEF\uFF0C\u7528 existingIdx \u6307\u5B9A\uFF0Cfact \u586B\u539F\u5185\u5BB9
+- NONE\uFF1A\u4E0D\u503C\u5F97\u8BB0\u5F55\u6216\u5DF2\u6709\u5B8C\u5168\u76F8\u540C\u7684\u4FE1\u606F
+
+## \u8F93\u51FA\u683C\u5F0F
+
+\u8FD4\u56DE JSON \u6570\u7EC4\uFF0C\u6BCF\u6761\u683C\u5F0F\uFF1A
+{"action": "NEW"|"UPDATE"|"DELETE"|"NONE", "fact": "\u4E8B\u5B9E\u5185\u5BB9", "existingIdx": \u6574\u6570\u6216\u7701\u7565, "reason": "\u539F\u56E0\uFF08\u53EF\u9009\uFF09"}
+
+\u6BCF\u6B21\u6700\u591A\u8FD4\u56DE 3 \u6761\u64CD\u4F5C\u3002\u5982\u679C\u6CA1\u6709\u503C\u5F97\u64CD\u4F5C\u7684\u5185\u5BB9\uFF0C\u8FD4\u56DE []\u3002
+\u53EA\u8FD4\u56DE JSON \u6570\u7EC4\uFF0C\u4E0D\u8981\u4EFB\u4F55\u5176\u4ED6\u6587\u5B57\u3002
+
+\u793A\u4F8B\uFF1A
+
+1. \u63D0\u53D6\u65B0\u504F\u597D\uFF1A
+[{"action": "NEW", "fact": "\u7528\u6237\u504F\u597D TypeScript \u800C\u975E JavaScript", "reason": "\u660E\u786E\u8868\u8FBE\u7684\u6280\u672F\u504F\u597D"}]
+
+2. \u66F4\u65B0\u5DF2\u6709\u8BB0\u5FC6\uFF08idx 0 \u539F\u4E3A"\u7528\u6237\u6B63\u5728\u8BC4\u4F30 React \u548C Vue"\uFF09\uFF1A
+[{"action": "UPDATE", "fact": "\u7528\u6237\u51B3\u5B9A\u4F7F\u7528 React\uFF08\u653E\u5F03\u4E86 Vue\uFF09", "existingIdx": 0, "reason": "\u51B3\u7B56\u5DF2\u660E\u786E\uFF0C\u66F4\u65B0\u8BC4\u4F30\u72B6\u6001"}]
+
+3. \u5BF9\u8BDD\u4EC5\u4E3A"\u597D\u7684\uFF0C\u8C22\u8C22"/"\u6CA1\u95EE\u9898"\u7B49\u786E\u8BA4\u8BED\uFF0C\u65E0\u65B0\u4FE1\u606F\uFF1A
+[]`,
+      shouldMerge: (contentA, contentB) => `\u4F60\u662F\u4E00\u4E2A\u8BB0\u5FC6\u53BB\u91CD\u52A9\u624B\uFF0C\u8D1F\u8D23\u5224\u65AD\u4E24\u6761\u8BB0\u5FC6\u662F\u5426\u8868\u8FBE\u4E86\u672C\u8D28\u76F8\u540C\u7684\u4FE1\u606F\u3002
+
+\u8BB0\u5FC6A\uFF1A${contentA}
+\u8BB0\u5FC6B\uFF1A${contentB}
+
+\u5224\u65AD\u89C4\u5219\uFF1A
+- \u5982\u679C\u4E24\u6761\u8BB0\u5FC6\u8868\u8FBE\u7684\u662F\u672C\u8D28\u76F8\u540C\u7684\u4FE1\u606F\uFF08\u53EF\u80FD\u63AA\u8F9E\u4E0D\u540C\u3001\u7C92\u5EA6\u4E0D\u540C\uFF0C\u4F46\u6838\u5FC3\u4E8B\u5B9E\u4E00\u81F4\uFF09\uFF0C\u8FD4\u56DE JSON\uFF1A
+  {"shouldMerge": true, "merged": "\u5408\u5E76\u540E\u7684\u7B80\u6D01\u8868\u8FF0\uFF0C\u4FDD\u7559\u4E24\u6761\u8BB0\u5FC6\u7684\u5173\u952E\u4FE1\u606F\uFF0C\u6BD4\u4EFB\u4F55\u4E00\u6761\u90FD\u66F4\u5B8C\u6574"}
+- \u5982\u679C\u4E24\u6761\u8BB0\u5FC6\u662F\u4E92\u8865\u4FE1\u606F\u3001\u4E0D\u540C\u4E3B\u9898\u3001\u6216\u5305\u542B\u4E0D\u540C\u7684\u5177\u4F53\u4E8B\u5B9E\uFF0C\u8FD4\u56DE JSON\uFF1A
+  {"shouldMerge": false}
+
+\u53EA\u8FD4\u56DE JSON\uFF0C\u4E0D\u8981\u4EFB\u4F55\u5176\u4ED6\u6587\u5B57\u3002
+
+\u793A\u4F8B\uFF1A
+
+1. \u5E94\u5408\u5E76\uFF08\u7C92\u5EA6\u4E0D\u540C\uFF09\uFF1A
+A: "\u9879\u76EE\u4F7F\u7528 PostgreSQL \u6570\u636E\u5E93"
+B: "\u9879\u76EE\u7684\u4E3B\u6570\u636E\u5E93\u662F PostgreSQL 16\uFF0C\u90E8\u7F72\u5728 AWS RDS \u4E0A"
+\u2192 {"shouldMerge": true, "merged": "\u9879\u76EE\u4F7F\u7528 PostgreSQL 16 \u4F5C\u4E3A\u4E3B\u6570\u636E\u5E93\uFF0C\u90E8\u7F72\u5728 AWS RDS \u4E0A"}
+
+2. \u4E0D\u5E94\u5408\u5E76\uFF08\u4E92\u8865\u4F46\u4E0D\u540C\uFF09\uFF1A
+A: "\u7528\u6237\u559C\u6B22\u7528 VS Code"
+B: "\u7528\u6237\u7684 VS Code \u4F7F\u7528 One Dark Pro \u4E3B\u9898"
+\u2192 {"shouldMerge": false}`,
+      evolutionJudge: (oldContent, newContent) => `\u4F60\u662F\u4E00\u4E2A\u8BB0\u5FC6\u6F14\u5316\u5224\u65AD\u52A9\u624B\u3002\u5206\u6790\u4EE5\u4E0B\u4E24\u6761\u8BB0\u5FC6\u7684\u5173\u7CFB\u5E76\u8FD4\u56DE JSON\u3002
+
+\u65E7\u8BB0\u5FC6\uFF1A${oldContent}
+\u65B0\u8BB0\u5FC6\uFF1A${newContent}
+
+\u5224\u65AD\u89C4\u5219\uFF1A
+
+- EVOLVE\uFF1A\u65B0\u5185\u5BB9\u662F\u5BF9\u65E7\u8BB0\u5FC6\u7684\u6DF1\u5316/\u66F4\u65B0\uFF08\u5982\u300C\u6B63\u5728\u8003\u8651\u7528 Next.js\u300D\u2192\u300C\u51B3\u5B9A\u7528 Next.js 14 App Router\u300D\uFF09
+  \u8FD4\u56DE\uFF1A{"type": "EVOLVE", "mergedContent": "\u878D\u5408\u540E\u7684\u5B8C\u6574\u5185\u5BB9\uFF0C\u4FDD\u7559\u6F14\u5316\u8F68\u8FF9"}
+
+- CONFLICT\uFF1A\u65B0\u65E7\u4FE1\u606F\u5728\u540C\u4E00\u5C5E\u6027\u4E0A\u76F4\u63A5\u77DB\u76FE\uFF08\u5982\u300C\u4F7F\u7528 MySQL \u4F5C\u4E3A\u4E3B\u6570\u636E\u5E93\u300Dvs\u300C\u5DF2\u8FC1\u79FB\u5230 PostgreSQL\u300D\uFF09
+  \u8FD4\u56DE\uFF1A{"type": "CONFLICT"}
+
+- EXPAND\uFF1A\u65B0\u4FE1\u606F\u662F\u5BF9\u65E7\u8BB0\u5FC6\u540C\u4E00\u4E3B\u9898\u7684\u8865\u5145\u6269\u5C55\uFF08\u5982\u300C\u8D1F\u8D23\u540E\u7AEF\u5F00\u53D1\u300D+\u300C\u540E\u7AEF\u4F7F\u7528 Go \u548C gRPC\u300D\uFF09
+  \u8FD4\u56DE\uFF1A{"type": "EXPAND", "mergedContent": "\u5408\u5E76\u540E\u7684\u5B8C\u6574\u5185\u5BB9\uFF0C\u6574\u5408\u53CC\u65B9\u4FE1\u606F"}
+
+- NEW\uFF1A\u5168\u65B0\u4FE1\u606F\uFF0C\u4E0E\u65E7\u8BB0\u5FC6\u65E0\u5B9E\u8D28\u5173\u8054\uFF08\u5982\u300C\u559C\u6B22 dark mode\u300Dvs\u300C\u4E0B\u5468\u8981\u53BB\u51FA\u5DEE\u300D\uFF09
+  \u8FD4\u56DE\uFF1A{"type": "NEW"}
+
+\u53EA\u8FD4\u56DE JSON\uFF0C\u4E0D\u8981\u4EFB\u4F55\u5176\u4ED6\u6587\u5B57\u3002`
+    };
+    templates = { en, zh };
+    t = templates[LOCALE];
+  }
+});
+
+// ../amem-core/src/llm.ts
+function anthropic() {
+  return _anthropic ??= new import_sdk.default({
+    ...process.env.AMEM_LLM_API_KEY && { apiKey: process.env.AMEM_LLM_API_KEY },
+    ...process.env.AMEM_LLM_BASE_URL && { baseURL: process.env.AMEM_LLM_BASE_URL }
+  });
+}
+function openai() {
+  return _openai ??= new import_openai.default({
+    // AMEM_LLM_API_KEY first (engine convention), then the SDK's own
+    // OPENAI_API_KEY (the standard) — passing an explicit key blocks the SDK's
+    // env fallback, so read it here. Placeholder last, so keyless local servers
+    // (Ollama, vLLM) still work.
+    apiKey: process.env.AMEM_LLM_API_KEY || process.env.OPENAI_API_KEY || "sk-no-key-required",
+    ...process.env.AMEM_LLM_BASE_URL && { baseURL: process.env.AMEM_LLM_BASE_URL }
+  });
+}
+async function llmCall(prompt, maxTokens = 500) {
+  const isThinking = MODEL.includes("gemini") || MODEL.includes("pro-agent");
+  const effectiveMaxTokens = isThinking ? Math.max(maxTokens * 8, 4e3) : maxTokens;
+  try {
+    return PROVIDER === "openai" ? await openaiCall(prompt, effectiveMaxTokens) : await anthropicCall(prompt, effectiveMaxTokens);
+  } catch (e) {
+    console.error(`[amem] LLM call failed: ${e.message}`);
+    return null;
+  }
+}
+async function anthropicCall(prompt, maxTokens) {
+  const resp = await anthropic().messages.create({
+    model: MODEL,
+    max_tokens: maxTokens,
+    messages: [{ role: "user", content: prompt }]
+  });
+  for (const block of resp.content) {
+    if (block.type === "text") return block.text.trim();
+  }
+  return null;
+}
+async function openaiCall(prompt, maxTokens) {
+  const isReasoning = /^o\d/.test(MODEL) || MODEL.startsWith("gpt-5");
+  const resp = await openai().chat.completions.create({
+    model: MODEL,
+    ...isReasoning ? { max_completion_tokens: maxTokens } : { max_tokens: maxTokens },
+    messages: [{ role: "user", content: prompt }]
+  });
+  return resp.choices[0]?.message?.content?.trim() ?? null;
+}
+function stripFences(raw) {
+  raw = raw.trim();
+  if (raw.startsWith("```")) {
+    const lines = raw.split("\n");
+    lines.shift();
+    if (lines[lines.length - 1] === "```") lines.pop();
+    raw = lines.join("\n").trim();
+  }
+  if (raw.startsWith('"') && raw.endsWith('"') || raw.startsWith("'") && raw.endsWith("'")) {
+    try {
+      raw = JSON.parse(raw);
+    } catch {
+    }
+  }
+  return raw;
+}
+async function llmConstructNote(content) {
+  const prompt = `Analyze the following text and respond with valid JSON only (no markdown fences, no explanation, no comments). All string values must use standard double quotes and be properly escaped:
+{
+  "keywords": ["keyword1", "keyword2"],
+  "tags": ["tag1", "tag2"],
+  "context": "one sentence summary in the same language as the input",
+  "category": "Technical|Business|Personal|Project|Research|System|General",
+  "note_type": "memory|knowledge",
+  "topics": ["Topic1", "Topic2"],
+  "confidence": "high|medium|low"
+}
+
+Category guide:
+- Technical: code, tools, configuration, APIs, debugging
+- Business: company, finance, compliance, contracts, invoices
+- Personal: personal state, habits, preferences, emotions
+- Project: project progress, decisions, milestones
+- Research: research, literature, evaluation, comparison
+- System: system services, monitoring, operations
+- General: anything that does not fit the above
+
+note_type guide:
+- knowledge: books, methodologies, tools, domain knowledge, reference material \u2014 durable, no strong time component
+- memory: events, decisions, preferences, states, observations \u2014 episodic, time-sensitive
+
+topics guide (Story 26B):
+- Only populate for knowledge notes (note_type=knowledge). For memory notes, return [].
+- List 1-5 concise subject tags representing the main topics of this knowledge, e.g. ["TypeScript", "Qdrant", "Vector DB"].
+
+confidence guide (Story 27):
+- high: note_type is unambiguous \u2014 clearly episodic (event/decision/state) or clearly durable knowledge (tool doc/methodology)
+- medium: some ambiguity \u2014 e.g. "learned X method" could be either memory or knowledge
+- low: LLM is uncertain \u2014 vague, fragmentary, or mixed content
+
+Text: ${content}`;
+  const raw = await llmCall(prompt, 400);
+  if (!raw)
+    return {
+      keywords: [],
+      tags: [],
+      context: "",
+      category: "General",
+      note_type: "memory",
+      topics: [],
+      confidence: "medium"
+    };
+  try {
+    const data = JSON.parse(stripFences(raw));
+    const rawCategory = typeof data.category === "string" ? data.category : "General";
+    const category = VALID_CATEGORIES.has(rawCategory) ? rawCategory : "General";
+    const note_type = data.note_type === "knowledge" ? "knowledge" : "memory";
+    const topics = note_type === "knowledge" && Array.isArray(data.topics) ? data.topics.filter((v) => typeof v === "string") : [];
+    const rawConfidence = typeof data.confidence === "string" ? data.confidence : "medium";
+    const confidence = VALID_CONFIDENCE.has(rawConfidence) ? rawConfidence : "medium";
+    return {
+      keywords: Array.isArray(data.keywords) ? data.keywords : [],
+      tags: Array.isArray(data.tags) ? data.tags : [],
+      context: typeof data.context === "string" ? data.context : "",
+      category,
+      note_type,
+      topics,
+      confidence
+    };
+  } catch (e) {
+    console.error(`[amem] Note construction parse failed: ${e.message}`);
+    return {
+      keywords: [],
+      tags: [],
+      context: "",
+      category: "General",
+      note_type: "memory",
+      topics: [],
+      confidence: "medium"
+    };
+  }
 }
-async function updateNoteContent(id, content, embedding, hash) {
-  return makeCrud(getCollection()).updateNoteContent(id, content, embedding, hash);
+async function llmShouldLink(noteContent, candidateContent) {
+  const prompt = `Do these two memory notes have a meaningful relationship that would be useful to link?
+Reply with only "yes" or "no".
+
+Note A: ${noteContent}
+Note B: ${candidateContent}`;
+  const raw = await llmCall(prompt, 10);
+  if (!raw) return false;
+  return raw.toLowerCase().startsWith("yes");
 }
-async function queryByEmbedding(embedding, topK, agentId, scoreThreshold = 0) {
-  return makeCrud(getCollection()).queryByEmbedding(embedding, topK, agentId, scoreThreshold);
+async function llmCrudDecision(userText, assistantText, existingMemories) {
+  const memoryList = existingMemories.length > 0 ? existingMemories.map((m) => `[${m.idx}] ${m.content}`).join("\n") : "(none)";
+  const prompt = t.crudDecision(userText.slice(0, 500), assistantText.slice(0, 500), memoryList);
+  try {
+    const raw = await llmCall(prompt, 400);
+    if (!raw) return [];
+    const match = raw.match(/\[.*\]/s);
+    if (!match) return [];
+    const parsed = JSON.parse(match[0]);
+    if (!Array.isArray(parsed)) return [];
+    const ops = [];
+    for (const item of parsed) {
+      if (!item || typeof item !== "object") continue;
+      const action = item.action;
+      if (!["NEW", "UPDATE", "DELETE", "NONE"].includes(action)) continue;
+      if (action === "NONE") continue;
+      const op = {
+        action,
+        fact: typeof item.fact === "string" ? item.fact : "",
+        reason: typeof item.reason === "string" ? item.reason : void 0
+      };
+      if (typeof item.existingIdx === "number") {
+        op.existingIdx = item.existingIdx;
+      }
+      ops.push(op);
+    }
+    return ops.slice(0, 3);
+  } catch (e) {
+    console.error(`[amem] llmCrudDecision failed: ${e.message}`);
+    return [];
+  }
 }
-async function listNotes(agentId) {
-  return makeCrud(getCollection()).listNotes(agentId);
+async function llmShouldMerge(contentA, contentB) {
+  const prompt = t.shouldMerge(contentA, contentB);
+  const raw = await llmCall(prompt, 300);
+  if (!raw) return { shouldMerge: false };
+  try {
+    const data = JSON.parse(stripFences(raw));
+    if (typeof data.shouldMerge !== "boolean") return { shouldMerge: false };
+    if (data.shouldMerge && typeof data.merged === "string") {
+      return { shouldMerge: true, merged: data.merged };
+    }
+    return { shouldMerge: false };
+  } catch (e) {
+    console.error(`[amem] llmShouldMerge parse failed: ${e.message}`);
+    return { shouldMerge: false };
+  }
 }
-async function deleteNote(id) {
-  return makeCrud(getCollection()).deleteNote(id);
+async function llmEvolutionJudge(oldContent, newContent) {
+  const prompt = t.evolutionJudge(oldContent, newContent);
+  const raw = await llmCall(prompt, 300);
+  if (!raw) return { type: "NEW" };
+  try {
+    const data = JSON.parse(stripFences(raw));
+    const type = VALID_EVOLUTION_TYPES.has(data.type) ? data.type : "NEW";
+    return {
+      type,
+      mergedContent: typeof data.mergedContent === "string" ? data.mergedContent : void 0
+    };
+  } catch (e) {
+    console.error(`[amem] llmEvolutionJudge parse failed: ${e.message}`);
+    return { type: "NEW" };
+  }
 }
-async function invalidateNote(id) {
-  return makeCrud(getCollection()).invalidateNote(id);
+async function llmEvolveNote(content, linkedNotes) {
+  const linkedStr = linkedNotes.map((n) => `- ID: ${n.id}
+  Content: ${n.content}`).join("\n");
+  const prompt = `A memory note has gained new connections. Update its context, tags, and decide whether to strengthen connections with specific neighbors.
+Reply with JSON only (no markdown):
+{
+  "tags": ["tag1", "tag2", ...],
+  "context": "updated one sentence summary",
+  "should_strengthen": true|false,
+  "suggested_connections": ["neighbor_id_1", "neighbor_id_2", ...],
+  "tags_to_update": ["tag_1", ..., "tag_n"]
 }
-async function getNotesByDatePrefix(datePrefix, agentId) {
-  return makeCrud(getCollection()).getNotesByDatePrefix(datePrefix, agentId);
+
+Guidelines:
+- "tags" and "context" are for updating the original note based on new connections.
+- "should_strengthen" is a decision whether this note should strengthen its connections to any of the newly linked notes (neighbors).
+- "suggested_connections" must contain only IDs from the newly linked notes (neighbors) listed below.
+- "tags_to_update" are updated tags for the original note itself if we strengthen connections.
+
+Original note content: ${content}
+
+Newly linked notes (neighbors):
+${linkedStr}`;
+  const raw = await llmCall(prompt, 500);
+  if (!raw) return { tags: null, context: null, shouldStrengthen: false, suggestedConnections: [], tagsToUpdate: [] };
+  try {
+    const data = JSON.parse(stripFences(raw));
+    return {
+      tags: Array.isArray(data.tags) ? data.tags : null,
+      context: typeof data.context === "string" ? data.context : null,
+      shouldStrengthen: typeof data.should_strengthen === "boolean" ? data.should_strengthen : false,
+      suggestedConnections: Array.isArray(data.suggested_connections) ? data.suggested_connections.map(String) : [],
+      tagsToUpdate: Array.isArray(data.tags_to_update) ? data.tags_to_update.map(String) : []
+    };
+  } catch (e) {
+    console.error(`[amem] Evolution parse failed: ${e.message}`);
+    return { tags: null, context: null, shouldStrengthen: false, suggestedConnections: [], tagsToUpdate: [] };
+  }
 }
-async function countNotes(agentId) {
-  return makeCrud(getCollection()).countNotes(agentId);
+var import_sdk, import_openai, PROVIDER, MODEL, _anthropic, _openai, VALID_CONFIDENCE, VALID_CATEGORIES, VALID_EVOLUTION_TYPES;
+var init_llm = __esm({
+  "../amem-core/src/llm.ts"() {
+    "use strict";
+    import_sdk = __toESM(require("@anthropic-ai/sdk"), 1);
+    import_openai = __toESM(require("openai"), 1);
+    init_prompts();
+    PROVIDER = (process.env.AMEM_LLM_PROVIDER ?? "anthropic").trim().toLowerCase();
+    if (PROVIDER !== "anthropic" && PROVIDER !== "openai") {
+      console.error(`[amem] unknown AMEM_LLM_PROVIDER "${PROVIDER}"; falling back to anthropic`);
+    }
+    MODEL = process.env.AMEM_LLM_MODEL ?? (PROVIDER === "openai" ? "gpt-4o-mini" : "claude-sonnet-4-6");
+    _anthropic = null;
+    _openai = null;
+    VALID_CONFIDENCE = /* @__PURE__ */ new Set(["high", "medium", "low"]);
+    VALID_CATEGORIES = /* @__PURE__ */ new Set([
+      "Technical",
+      "Business",
+      "Personal",
+      "Project",
+      "Research",
+      "System",
+      "General"
+    ]);
+    VALID_EVOLUTION_TYPES = /* @__PURE__ */ new Set(["EVOLVE", "CONFLICT", "EXPAND", "NEW"]);
+  }
+});
+
+// ../amem-core/src/evo-counter.ts
+function counterFile() {
+  return process.env.AMEM_EVO_COUNTER_PATH || path2.join(getDataDir(), "amem_evo_cnt.json");
 }
-async function updateNoteLinks(id, links) {
-  return makeCrud(getCollection()).updateNoteLinks(id, links);
+function getEvoCount() {
+  try {
+    const data = JSON.parse(fs.readFileSync(counterFile(), "utf-8"));
+    return data.count || 0;
+  } catch {
+    return 0;
+  }
 }
-async function patchNotePayload(id, fields) {
-  return makeCrud(getCollection()).patchNotePayload(id, fields);
+function incrementEvoCount() {
+  const count = getEvoCount() + 1;
+  fs.writeFileSync(counterFile(), JSON.stringify({ count, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }));
+  return count;
 }
-async function replaceLinkReferences(oldId, newId, agentId) {
-  return makeCrud(getCollection()).replaceLinkReferences(oldId, newId, agentId);
+function shouldRunEvolution() {
+  const count = incrementEvoCount();
+  return count % EVO_THRESHOLD === 0;
 }
-var QDRANT_URL, getCollection, VECTOR_DIM, _collectionReady, _collectionReadyMap;
-var init_storage = __esm({
-  "../amem-core/src/storage.ts"() {
+var fs, path2, EVO_THRESHOLD;
+var init_evo_counter = __esm({
+  "../amem-core/src/evo-counter.ts"() {
     "use strict";
-    QDRANT_URL = "http://localhost:6333";
-    getCollection = () => process.env.AMEM_COLLECTION || "amem_notes";
-    VECTOR_DIM = 384;
-    _collectionReady = false;
-    _collectionReadyMap = /* @__PURE__ */ new Map();
+    fs = __toESM(require("fs"), 1);
+    path2 = __toESM(require("path"), 1);
+    init_config();
+    EVO_THRESHOLD = 20;
   }
 });
 
@@ -1790,64 +1793,37 @@ var src_exports = {};
 __export(src_exports, {
   addEpisodic: () => addEpisodic,
   addMemory: () => addMemory,
-  addNote: () => addNote,
-  bm25Score: () => bm25Score,
-  buildBM25: () => buildBM25,
   checkQuality: () => checkQuality,
   configure: () => configure,
   consolidateMemories: () => consolidateMemories,
-  cosineSimilarity: () => cosineSimilarity,
-  countNotes: () => countNotes,
   createStorageContext: () => createStorageContext,
   deleteNote: () => deleteNote,
   encode: () => encode,
   ensureCollection: () => ensureCollection,
-  findByHash: () => findByHash,
   generateReviewBatch: () => generateReviewBatch,
-  getDataDir: () => getDataDir,
-  getEvoCount: () => getEvoCount,
   getNote: () => getNote,
-  getNotesByDatePrefix: () => getNotesByDatePrefix,
-  incrementEvoCount: () => incrementEvoCount,
   invalidateNote: () => invalidateNote,
   isModelLoaded: () => isModelLoaded,
   listMemories: () => listMemories,
   listNotes: () => listNotes,
-  llmCall: () => llmCall,
-  llmConstructNote: () => llmConstructNote,
   llmCrudDecision: () => llmCrudDecision,
-  llmEvolutionJudge: () => llmEvolutionJudge,
-  llmEvolveNote: () => llmEvolveNote,
-  llmShouldLink: () => llmShouldLink,
-  llmShouldMerge: () => llmShouldMerge,
   loadModel: () => loadModel,
   mergeSimilarNotes: () => mergeSimilarNotes,
   patchNotePayload: () => patchNotePayload,
   pingQdrant: () => pingQdrant,
-  queryByEmbedding: () => queryByEmbedding,
-  replaceLinkReferences: () => replaceLinkReferences,
-  resetCollectionReady: () => resetCollectionReady,
-  rrfMerge: () => rrfMerge,
   scanLowQuality: () => scanLowQuality,
   searchMemory: () => searchMemory,
-  shouldRunEvolution: () => shouldRunEvolution,
-  simpleTokenize: () => simpleTokenize,
-  t: () => t,
-  updateNote: () => updateNote,
-  updateNoteContent: () => updateNoteContent,
-  updateNoteLinks: () => updateNoteLinks
+  updateNote: () => updateNote
 });
 var init_src = __esm({
   "../amem-core/src/index.ts"() {
     "use strict";
     init_config();
     init_embedding();
-    init_evo_counter();
-    init_llm();
     init_memory();
-    init_prompts();
     init_quality();
     init_storage();
+    init_llm();
   }
 });
 
@@ -1907,6 +1883,28 @@ function hookNeverFiredWarning(now = Date.now()) {
   return HOOK_WARNING_TEXT;
 }
 
+// src/scope.ts
+function parseAgentIdFromSessionKey(sessionKey) {
+  if (!sessionKey) return void 0;
+  const parts = sessionKey.split(":").filter(Boolean);
+  if (parts.length >= 3 && parts[0] === "agent") return parts[1] || void 0;
+  return void 0;
+}
+function resolveAgentId(ctx, pluginConfig) {
+  return ctx?.agentId ?? parseAgentIdFromSessionKey(ctx?.sessionKey) ?? pluginConfig.agentId ?? "main";
+}
+function buildScope(rawAgentId, pluginConfig, createStorageContext2) {
+  const agentCfg = pluginConfig.agents?.[rawAgentId] ?? {};
+  const effectiveAgentId = agentCfg.agentId ?? rawAgentId;
+  const effectiveCollection = agentCfg.collection ?? pluginConfig.collection ?? void 0;
+  const modeBIsolated = !!agentCfg.collection;
+  return {
+    agentId: effectiveAgentId,
+    collection: effectiveCollection,
+    storageCtx: createStorageContext2(effectiveCollection, modeBIsolated)
+  };
+}
+
 // src/index.ts
 init_src();
 var _config = {};
@@ -1916,27 +1914,9 @@ function register(api) {
   _config = api.pluginConfig || {};
   const pluginConfig = _config;
   configure({ dataDir: path5.join(os2.homedir(), ".openclaw") });
-  function parseAgentIdFromSessionKey(sessionKey) {
-    if (!sessionKey) return void 0;
-    const parts = sessionKey.split(":").filter(Boolean);
-    if (parts.length >= 3 && parts[0] === "agent") return parts[1] || void 0;
-    return void 0;
-  }
-  function resolveAgentId(ctx) {
-    return ctx?.agentId ?? parseAgentIdFromSessionKey(ctx?.sessionKey) ?? pluginConfig.agentId ?? "main";
-  }
-  function buildScope(rawAgentId) {
-    const agentCfg = pluginConfig.agents?.[rawAgentId] ?? {};
-    const effectiveAgentId = agentCfg.agentId ?? rawAgentId;
-    const effectiveCollection = agentCfg.collection ?? pluginConfig.collection ?? void 0;
-    const modeBIsolated = !!agentCfg.collection;
-    return {
-      agentId: effectiveAgentId,
-      collection: effectiveCollection,
-      storageCtx: createStorageContext(effectiveCollection, modeBIsolated)
-    };
-  }
-  const defaultScope = buildScope(resolveAgentId());
+  const resolveAgentId2 = (ctx) => resolveAgentId(ctx, pluginConfig);
+  const buildScope2 = (rawAgentId) => buildScope(rawAgentId, pluginConfig, createStorageContext);
+  const defaultScope = buildScope2(resolveAgentId2());
   const dbPath = path5.join(os2.homedir(), ".openclaw", "amem_db");
   logger.info(
     `openclaw-amem: registered (native TS, Qdrant, default agent_id=${defaultScope.agentId}, default collection=${pluginConfig.collection ?? "amem_notes (default)"}, per-agent scope resolved per call)`
@@ -1957,7 +1937,7 @@ function register(api) {
       runtime: {
         async getMemorySearchManager(params) {
           try {
-            const scope = buildScope(resolveAgentId(params));
+            const scope = buildScope2(resolveAgentId2(params));
             return {
               manager: {
                 status() {
@@ -2007,7 +1987,7 @@ function register(api) {
           }
         },
         resolveMemoryBackendConfig(params) {
-          const scope = buildScope(resolveAgentId(params));
+          const scope = buildScope2(resolveAgentId2(params));
           return { backend: "amem-qdrant", baseUrl: "", userId: scope.agentId };
         },
         async closeAllMemorySearchManagers() {
@@ -2020,7 +2000,7 @@ function register(api) {
   if (typeof api.registerTool === "function") {
     api.registerTool(
       (ctx) => {
-        const scope = buildScope(resolveAgentId(ctx));
+        const scope = buildScope2(resolveAgentId2(ctx));
         return {
           name: "memory_search",
           label: "Memory Search (A-MEM)",
@@ -2077,7 +2057,7 @@ ${text}${hookWarning}` }],
     );
     api.registerTool(
       (ctx) => {
-        const scope = buildScope(resolveAgentId(ctx));
+        const scope = buildScope2(resolveAgentId2(ctx));
         return {
           name: "memory_add",
           label: "Memory Add (A-MEM)",
@@ -2113,7 +2093,7 @@ ${text}${hookWarning}` }],
     );
     api.registerTool(
       (ctx) => {
-        const scope = buildScope(resolveAgentId(ctx));
+        const scope = buildScope2(resolveAgentId2(ctx));
         return {
           name: "memory_list",
           label: "Memory List (A-MEM)",
@@ -2143,7 +2123,7 @@ ${text}${hookWarning}` }],
     );
     api.registerTool(
       (ctx) => {
-        const scope = buildScope(resolveAgentId(ctx));
+        const scope = buildScope2(resolveAgentId2(ctx));
         return {
           name: "memory_consolidate",
           label: "Memory Consolidate (A-MEM)",
@@ -2176,7 +2156,7 @@ ${text}${hookWarning}` }],
     );
     api.registerTool(
       (ctx) => {
-        const scope = buildScope(resolveAgentId(ctx));
+        const scope = buildScope2(resolveAgentId2(ctx));
         return {
           name: "memory_quality_scan",
           label: "Memory Quality Scan (A-MEM)",
@@ -2224,7 +2204,7 @@ ${text}${hookWarning}` }],
       "agent_end",
       async (event, ctx) => {
         markHookFired();
-        const scope = buildScope(resolveAgentId(ctx));
+        const scope = buildScope2(resolveAgentId2(ctx));
         const agentId = scope.agentId;
         const storageCtx = scope.storageCtx;
         logger.info(

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-amem",
   "name": "Memory (A-MEM v2)",
   "description": "OpenClaw memory plugin implementing A-MEM — memories evolve, not just accumulate. Graph linking, hybrid retrieval, LLM-driven evolution. No Python.",
-  "version": "1.1.5",
+  "version": "1.2.0",
   "kind": "memory",
   "openclaw": {
     "compat": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-amem",
-  "version": "1.1.5",
+  "version": "1.2.0",
   "description": "OpenClaw memory plugin implementing A-MEM — memories evolve, not just accumulate. Graph linking, hybrid retrieval, LLM-driven evolution. No Python.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -21,16 +21,17 @@
     "@node-rs/jieba": "^2.0.1",
     "@qdrant/js-client-rest": "^1.18.0",
     "@types/uuid": "^11.0.0",
+    "openai": "^6.48.0",
     "uuid": "^14.0.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/node": "^26.1.1",
-    "eslint": "^10.4.1",
-    "prettier": "^3.8.3",
+    "eslint": "^10.7.0",
+    "prettier": "^3.9.5",
     "tsup": "^8.4.0",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
+    "tsx": "^4.23.1",
+    "typescript": "^6.0.3",
     "typescript-eslint": "^8.60.1",
     "vitest": "^4.1.10"
   },
@@ -73,6 +74,7 @@
     "format": "prettier --check \"src/**/*.ts\"",
     "format:fix": "prettier --write \"src/**/*.ts\"",
     "test": "vitest run",
+    "test:unit": "vitest run test/unit",
     "test:watch": "vitest",
     "check": "npm run format && npm run lint && npm run test"
   }