@memtensor/memos-local-openclaw-plugin 0.1.2 → 0.1.4

package/.env.example

@@ -1,11 +1,19 @@
-# Embedding API
-# Use any OpenAI-compatible embedding service, or leave blank for local offline model
+# ─── Embedding API ───
+# Use any OpenAI-compatible embedding service, or leave blank for local offline model (Xenova/all-MiniLM-L6-v2)
+EMBEDDING_PROVIDER=openai_compatible
 EMBEDDING_API_KEY=your-embedding-api-key
-EMBEDDING_ENDPOINT=https://api.openai.com/v1
-EMBEDDING_MODEL=text-embedding-3-small
+EMBEDDING_ENDPOINT=https://your-embedding-api.com/v1
+EMBEDDING_MODEL=bge-m3
 
-# Summarizer API (OpenAI-compatible)
+# ─── Summarizer API ───
+# OpenAI-compatible LLM for one-sentence chunk summaries
 # Leave blank to use rule-based fallback (no LLM needed)
+SUMMARIZER_PROVIDER=openai_compatible
 SUMMARIZER_API_KEY=your-summarizer-api-key
 SUMMARIZER_ENDPOINT=https://api.openai.com/v1
 SUMMARIZER_MODEL=gpt-4o-mini
+SUMMARIZER_TEMPERATURE=0
+
+# ─── Memory Viewer ───
+# Port for the web-based Memory Viewer (default: 18799)
+# VIEWER_PORT=18799

package/README.md

@@ -6,12 +6,17 @@ Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/o
 
 ## Features
 
-- **Auto-capture** — Stores user, assistant, and tool messages after each agent turn
-- **Semantic chunking** — Preserves complete code blocks, function bodies, and paragraph boundaries
+- **Auto-capture** — Stores user, assistant, and tool messages after each agent turn via `agent_end` event
+- **Content deduplication** — SHA-256 content hashing prevents duplicate chunks across repeated ingestion
+- **Task-level organization** — Conversations auto-grouped into tasks by topic shift (LLM-judged) or 2-hour idle timeout; each completed task gets a detailed LLM summary
+- **Task status** — `active` (in progress), `completed` (with LLM summary), `skipped` (too brief, excluded from search)
 - **Hybrid retrieval** — FTS5 keyword + vector semantic dual-channel search with RRF fusion
-- **LLM summarization** — One-sentence summary per chunk for fast browsing
-- **Multi-provider** — OpenAI, Anthropic, Gemini, Cohere, Voyage, Mistral, Bedrock, or local offline
-- **Web viewer** — Built-in dashboard at `http://127.0.0.1:18799` with CRUD, search, filters, pagination
+- **LLM summarization** — Detailed task summaries preserving code, commands, URLs, file paths; chunk-level short summaries for search indexing
+- **Multi-provider embedding** — OpenAI-compatible, Gemini, Cohere, Voyage, Mistral, or local offline (Xenova/all-MiniLM-L6-v2)
+- **Multi-provider summarizer** — OpenAI-compatible, Anthropic, Gemini, AWS Bedrock
+- **Web viewer** — Built-in dashboard at `http://127.0.0.1:18799` with CRUD, search, analytics, task browser, chat-bubble chunk view
+- **Skill-based retrieval** — Agent learns when and how to use memory tools via a bundled Skill (no system prompt injection)
+- **i18n** — Memory Viewer supports Chinese / English with one-click toggle
 - **Privacy first** — All data in local SQLite, no cloud uploads, password-protected viewer
 
 ## Quick Start
@@ -24,9 +29,9 @@ Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/o
 openclaw plugins install @memtensor/memos-local-openclaw-plugin
 ```
 
-The plugin is installed under `~/.openclaw/extensions/` and registered as `memos-local`. No clone or build required.
+The plugin is installed under `~/.openclaw/extensions/memos-local` and registered as `memos-local`.
 
-> **Important:** Installing the plugin does **not** start the Memory Viewer. The viewer HTTP service is started only when the **OpenClaw gateway** is running. After install, you must **configure** `openclaw.json` (step 2) and **start or restart the gateway** (step 3); then the viewer will be available at `http://127.0.0.1:18799`.
+> **Important:** The Memory Viewer starts only when the **OpenClaw gateway** is running. After install, **configure** `openclaw.json` (step 2) and **start the gateway** (step 3); the viewer will then be available at `http://127.0.0.1:18799`.
 
 **From source (development):**
 
@@ -43,6 +48,14 @@ Add the plugin config to `~/.openclaw/openclaw.json`:
 
 ```jsonc
 {
+  "agents": {
+    "defaults": {
+      // IMPORTANT: Disable OpenClaw's built-in memory to avoid conflicts
+      "memorySearch": {
+        "enabled": false
+      }
+    }
+  },
   "plugins": {
     "slots": {
       "memory": "memos-local"
@@ -71,6 +84,8 @@ Add the plugin config to `~/.openclaw/openclaw.json`:
 }
 ```
 
+> **Critical:** You must set `agents.defaults.memorySearch.enabled` to `false`. Otherwise OpenClaw's built-in memory search runs alongside this plugin, causing duplicate retrieval and wasted tokens.
+
 #### Embedding Provider Options
 
 | Provider | `provider` value | Example `model` | Notes |
@@ -107,8 +122,6 @@ Use `${ENV_VAR}` placeholders in config to avoid hardcoding keys:
 
 ### 3. Start or Restart the Gateway
 
-The Memory Viewer and all plugin features only run when the OpenClaw gateway is running. After installing and configuring the plugin, start (or restart) the gateway:
-
 ```bash
 openclaw gateway stop    # if already running
 openclaw gateway install # ensure LaunchAgent is installed (macOS)
@@ -120,7 +133,6 @@ Once the gateway is up, the plugin loads and starts the Memory Viewer at `http:/
 ### 4. Verify Installation
 
 ```bash
-# Check the gateway log
 tail -20 ~/.openclaw/logs/gateway.log
 ```
 
@@ -145,73 +157,113 @@ memos-local: started (embedding: openai_compatible)
 **Step C** — In a new conversation, ask the agent to recall what you discussed:
 
 ```
-You: Do you remember what we talked about?
-Agent: (calls memory_search) Yes, we discussed...
-```
-
-**Step D** — Check the gateway log for ingest activity:
-
-```bash
-grep -E "Stored chunk|Chunked turn|Dedup" ~/.openclaw/logs/gateway.log | tail -10
+You: 你还记得我之前让你帮我处理过什么事情吗？
+Agent: (calls memory_search) 是的，我们之前讨论过...
 ```
 
-You should see lines like:
+## Retrieval Strategy
 
-```
-Chunked turn=1772459198930-839rr3 into 3 chunks
-Stored chunk=667f289e kind=paragraph len=392 hasVec=true
-Stored chunk=107d7f32 kind=tool_result role=tool len=210 hasVec=true
-```
+The plugin uses a **Skill-based** approach to teach the agent when and how to use memory tools. A `SKILL.md` file is automatically installed into the workspace skills directory (`~/.openclaw/workspace/skills/memos-local/`).
 
-### 6. Run the Smoke Test (Optional)
+The Skill instructs the agent to follow a **layered retrieval strategy**:
 
-If you have the source (e.g. cloned the repo or develop locally):
-
-```bash
-cd MemOS/apps/memos-local-openclaw   # or the path where the plugin source is
-cp .env.example .env
-# Edit .env with your actual API keys
-npx tsx scripts/smoke-test.ts
-```
+1. **`memory_search`** — Lightweight search returning hit summaries + IDs. Always the first step.
+2. **Sufficiency check** — If summaries are enough, answer directly without drilling down.
+3. **`memory_get`** — Read the full original text of a specific hit when the summary is truncated or insufficient.
+4. **`task_summary`** — Get the complete task-level summary when the answer may be spread across multiple turns of the same task.
+5. **`memory_timeline`** — Expand surrounding conversation context when cause-and-effect or chronological details are needed.
+6. **Ask user** — Only after exhausting search budget, ask the user a minimal follow-up question.
 
-The smoke test writes test conversations, searches for them, verifies timeline and get operations, and checks anti-writeback protection. If you installed only from npm, you can skip this step.
+The Skill triggers when:
+- The current context is insufficient to answer definitively
+- The agent is about to ask the user for information (search memory first)
+- The user references past conversations
+- User-specific information is needed (identity, preferences, project config, etc.)
 
 ## Agent Tools
 
-The plugin registers 4 tools that your agent can use:
+The plugin registers 5 tools:
 
-| Tool | Purpose |
-|---|---|
-| `memory_search` | Search memories by natural language query |
-| `memory_timeline` | Get surrounding context for a search hit |
-| `memory_get` | Get full original text of a memory chunk |
-| `memory_viewer` | Get the URL of the web dashboard |
+| Tool | Purpose | When to Use |
+|---|---|---|
+| `memory_search` | Search memories by natural language query | When current context lacks needed facts; before asking the user for information |
+| `memory_get` | Get full original text of a memory chunk | When exact details (commands, code, errors) are needed from a specific hit |
+| `task_summary` | Get detailed summary of a completed task | When the answer may be spread across multiple turns of the same task |
+| `memory_timeline` | Get surrounding context for a search hit | When a search hit needs cause-and-effect or chronological context |
+| `memory_viewer` | Get the URL of the web dashboard | When user asks where to view/manage memories |
 
-The agent uses these automatically via the SKILL.md prompt guide.
+### Search Parameters
+
+| Parameter | Default | Range | Description |
+|---|---|---|---|
+| `query` | — | — | Natural language search query |
+| `maxResults` | 6 | 1–20 | Maximum number of results |
+| `minScore` | 0.45 | 0.35–1.0 | Minimum relevance score |
+| `role` | — | `user` / `assistant` / `tool` | Filter by message role |
 
 ## Memory Viewer
 
-Open `http://127.0.0.1:18799` in your browser:
+Open `http://127.0.0.1:18799` in your browser after starting the gateway.
+
+**Features:**
+- Browse all stored memories with timeline view
+- Semantic search powered by your embedding model
+- Create, edit, and delete memories (CRUD)
+- Task browser with status filters (active / completed / skipped)
+- Chat-bubble style chunk view in task details
+- Filter by session, role (user/assistant/tool), time range
+- Analytics dashboard — daily write/read activity charts, memory breakdown
+- Light / Dark theme toggle
+- Chinese / English language toggle
+- Pagination (30 per page)
 
-**Viewer won't open or page not loading?**
+**Viewer won't open?**
 
 - The viewer is started by the plugin when the **gateway** starts. It does **not** run at install time.
-- Ensure the gateway is running: `openclaw gateway start` (or restart with `openclaw gateway stop` then `openclaw gateway start`).
-- Ensure the plugin is enabled in `~/.openclaw/openclaw.json`: `plugins.slots.memory` = `"memos-local"` and `plugins.entries.memos-local.enabled` = `true`.
-- Check the gateway log: `tail -30 ~/.openclaw/logs/gateway.log` — you should see `MemOS Memory Viewer` and `→ http://127.0.0.1:18799`. If the viewer fails to bind (e.g. port in use), the log will show a warning.
-
-- First visit: set a password (min 4 chars)
-- Browse, search, create, edit, delete memories
-- Filter by role (user/assistant/tool), type, time range (down to seconds)
-- Pagination (30 per page)
+- Ensure the gateway is running: `openclaw gateway start`
+- Ensure the plugin is enabled in `~/.openclaw/openclaw.json`
+- Check the log: `tail -30 ~/.openclaw/logs/gateway.log` — look for `MemOS Memory Viewer`
 
-**Forgot password?** Click "Forgot password?" on the login page and use the reset token from the gateway log:
+**Forgot password?** Click "Forgot password?" on the login page and use the reset token:
 
 ```bash
-# 必须用 "password reset token:" 才能匹配到带 token 的那一行（不要用 "reset token"）
-grep "password reset token:" /tmp/openclaw/openclaw-*.log ~/.openclaw/logs/gateway.log 2>/dev/null | tail -1
+grep "password reset token:" ~/.openclaw/logs/gateway.log 2>/dev/null | tail -1
+```
+
+Copy the 32-character hex string after `password reset token:`.
+
+## How It Works
+
+**Write path** (automatic on every agent turn via `agent_end` event):
+
+```
+Conversation → Capture (filter roles, strip system prompts)
+→ Content hash dedup check → Store chunk (SQLite + FTS5 + Embed)
+→ Associate to Task → Task boundary detected?
+  → Yes: Finalize previous task
+    → Chunks ≥ 4 & turns ≥ 2: LLM summarize → status = "completed"
+    → Otherwise: status = "skipped" (excluded from search)
+  → No: Continue accumulating in current task
+```
+
+Key details:
+- System messages are skipped; tool results from the plugin's own tools are not re-stored
+- Evidence wrapper blocks (`[STORED_MEMORY]...[/STORED_MEMORY]`) are stripped to prevent feedback loops
+- Content hash (SHA-256, first 16 hex chars) prevents duplicate chunk ingestion within the same session+role
+- Task boundaries are detected by LLM topic judgment or 2-hour idle timeout
+
+**Read path** (when agent calls `memory_search`):
+
+```
+Query → FTS5 + Vector dual recall → RRF Fusion → MMR Rerank
+→ Recency Decay → Score Filter → Top-K Results
 ```
-输出可能是纯文本一行，或一段 JSON；从中复制 `password reset token:` 后面的 32 位 hex 即可。
+
+Key details:
+- **RRF (Reciprocal Rank Fusion):** Merges FTS5 and vector search rankings into a unified score
+- **MMR (Maximal Marginal Relevance):** Re-ranks to balance relevance with diversity, preventing redundant results
+- **Recency Decay:** Recent memories get a boost (half-life: 14 days by default)
+- **Score Filter:** Relative threshold based on the top hit's score, preventing over-filtering with RRF's compressed score range
 
 ## Advanced Configuration
 
@@ -237,34 +289,94 @@ All optional — shown with defaults:
 }
 ```
 
-## How It Works
+## Reinstall / Upgrade
 
-**Write path** (automatic on every agent turn):
+If you see **"plugin already exists"** or **"plugin not found"**:
 
+**Option A — Clean reinstall via OpenClaw CLI:**
+```bash
+rm -rf ~/.openclaw/extensions/memos-local
+openclaw plugins install @memtensor/memos-local-openclaw-plugin
+cd ~/.openclaw/extensions/memos-local && npm install --omit=dev
+openclaw gateway stop && openclaw gateway start
 ```
-Conversation → Capture (filter roles) → Semantic Chunk → LLM Summarize
-→ Embed → Dedup Check → Store (SQLite + FTS5 + Vector)
+
+**Option B — Manual install (when config already references memos-local):**
+```bash
+rm -rf ~/.openclaw/extensions/memos-local
+cd /tmp
+npm pack @memtensor/memos-local-openclaw-plugin
+tar -xzf memtensor-memos-local-openclaw-plugin-*.tgz
+mv package ~/.openclaw/extensions/memos-local
+cd ~/.openclaw/extensions/memos-local && npm install --omit=dev
+openclaw gateway stop && openclaw gateway start
 ```
 
-**Read path** (when agent calls `memory_search`):
+**Plugin shows as "error" in `openclaw plugins list`?** (e.g. `Cannot find module '@sinclair/typebox'`)
 
-```
-Query → FTS5 + Vector dual recall → RRF Fusion → MMR Rerank
-→ Recency Decay → Score Filter → Top-K Results
+```bash
+cd ~/.openclaw/extensions/memos-local && npm install --omit=dev
 ```
 
-See the [full documentation](www/docs/) in the repo for detailed architecture and algorithm explanations.
+Then restart the gateway.
 
-## Data Location
+## Troubleshooting
 
-Whether you install from npm or from source, the plugin stores data under your OpenClaw state directory:
+### 常见问题排查
+
+1. **确认报错内容** — 记下完整报错，例如：`plugin not found`、`Cannot find module 'xxx'`、`Invalid config` 等。
+
+2. **看插件状态**
+   ```bash
+   openclaw plugins list
+   ```
+   - Status 为 **error** → 记下错误信息
+   - 列表中没有 MemOS Local → 未安装或未放到 `~/.openclaw/extensions/memos-local`
+
+3. **看网关日志**
+   ```bash
+   tail -50 ~/.openclaw/logs/gateway.log
+   ```
+   搜索 `memos-local`、`failed to load`、`Error`、`Cannot find module`。
+
+4. **检查环境**
+   - Node 版本：`node -v`（需要 **>= 18**）
+   - 插件目录存在：`ls ~/.openclaw/extensions/memos-local/package.json`
+   - 依赖已安装：`ls ~/.openclaw/extensions/memos-local/node_modules/@sinclair/typebox`
+     若不存在：`cd ~/.openclaw/extensions/memos-local && npm install --omit=dev`
+
+5. **检查配置** — 打开 `~/.openclaw/openclaw.json`，确认：
+   - `agents.defaults.memorySearch.enabled` = `false`（关闭内置记忆）
+   - `plugins.slots.memory` = `"memos-local"`
+   - `plugins.entries.memos-local.enabled` = `true`
+
+6. **记忆和 OpenClaw 内置记忆冲突** — 如果看到 agent 同时调用了内置的 memory 搜索和插件的 `memory_search`，说明 `agents.defaults.memorySearch.enabled` 没有设为 `false`。
+
+## Data Location
 
 | File | Path |
 |---|---|
 | Database | `~/.openclaw/memos-local/memos.db` |
 | Viewer auth | `~/.openclaw/memos-local/viewer-auth.json` |
 | Gateway log | `~/.openclaw/logs/gateway.log` |
-| Plugin code (npm install) | `~/.openclaw/extensions/` (managed by OpenClaw) |
+| Plugin code | `~/.openclaw/extensions/memos-local/` |
+| Skill | `~/.openclaw/workspace/skills/memos-local/SKILL.md` |
+
+## Testing
+
+Run the test suite:
+
+```bash
+cd MemOS/apps/memos-local-openclaw
+npm test
+```
+
+Test coverage includes:
+- **Policy tests** — Verifies retrieval strategy, search filtering, evidence extraction, instruction stripping
+- **Recall tests** — RRF fusion, recency decay correctness
+- **Capture tests** — Message filtering, evidence block stripping, self-tool exclusion
+- **Storage tests** — SQLite CRUD, FTS5, vector storage, content hash dedup
+- **Task processor tests** — Task boundary detection, skip logic, summary generation
 
 ## License
 

package/dist/capture/index.d.ts

@@ -1,16 +1,14 @@
 import type { ConversationMessage, Logger } from "../types";
 /**
- * Filter and extract writable messages from a conversation turn.
+ * Extract writable messages from a conversation turn.
  *
- * - Keep user, assistant, and tool messages
- * - Skip system prompts
- * - Skip tool results from our own memory tools (prevents memory loop)
- * - Truncate long tool results to avoid storage bloat
- * - Strip injected evidence blocks wrapped in [STORED_MEMORY]...[/STORED_MEMORY]
+ * Stores the user's actual text — strips only OpenClaw's injected metadata
+ * prefixes (Sender info, conversation context, etc.) which are not user content.
+ * Only skips: system prompts and our own memory tool results (prevents loop).
  */
 export declare function captureMessages(messages: Array<{
     role: string;
     content: string;
     toolName?: string;
-}>, sessionKey: string, turnId: string, evidenceTag: string, log: Logger): ConversationMessage[];
+}>, sessionKey: string, turnId: string, _evidenceTag: string, log: Logger): ConversationMessage[];
 //# sourceMappingURL=index.d.ts.map

package/dist/capture/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAQ,MAAM,EAAE,MAAM,UAAU,CAAC;AAYlE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACrE,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACV,mBAAmB,EAAE,CA+CvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAQ,MAAM,EAAE,MAAM,UAAU,CAAC;AA0BlE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACrE,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,GACV,mBAAmB,EAAE,CAgCvB"}

package/dist/capture/index.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.captureMessages = captureMessages;
-const types_1 = require("../types");
 const SKIP_ROLES = new Set(["system"]);
 const SELF_TOOLS = new Set([
     "memory_search",
@@ -9,16 +8,25 @@ const SELF_TOOLS = new Set([
     "memory_get",
     "memory_viewer",
 ]);
+// OpenClaw inbound metadata sentinels — these are AI-facing prefixes,
+// not user content. Must be stripped before storing as memory.
+const INBOUND_META_SENTINELS = [
+    "Conversation info (untrusted metadata):",
+    "Sender (untrusted metadata):",
+    "Thread starter (untrusted, for context):",
+    "Replied message (untrusted, for context):",
+    "Forwarded message context (untrusted metadata):",
+    "Chat history since last reply (untrusted, for context):",
+];
+const SENTINEL_FAST_RE = new RegExp(INBOUND_META_SENTINELS.map(s => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|"));
 /**
- * Filter and extract writable messages from a conversation turn.
+ * Extract writable messages from a conversation turn.
  *
- * - Keep user, assistant, and tool messages
- * - Skip system prompts
- * - Skip tool results from our own memory tools (prevents memory loop)
- * - Truncate long tool results to avoid storage bloat
- * - Strip injected evidence blocks wrapped in [STORED_MEMORY]...[/STORED_MEMORY]
+ * Stores the user's actual text — strips only OpenClaw's injected metadata
+ * prefixes (Sender info, conversation context, etc.) which are not user content.
+ * Only skips: system prompts and our own memory tool results (prevents loop).
  */
-function captureMessages(messages, sessionKey, turnId, evidenceTag, log) {
+function captureMessages(messages, sessionKey, turnId, _evidenceTag, log) {
     const now = Date.now();
     const result = [];
     for (const msg of messages) {
@@ -27,54 +35,75 @@ function captureMessages(messages, sessionKey, turnId, evidenceTag, log) {
             continue;
         if (!msg.content || msg.content.trim().length === 0)
             continue;
-        if (role === "tool") {
-            if (msg.toolName && SELF_TOOLS.has(msg.toolName)) {
-                log.debug(`Skipping self-tool result: ${msg.toolName}`);
-                continue;
-            }
-            let content = msg.content.trim();
-            const maxChars = types_1.DEFAULTS.toolResultMaxChars;
-            if (content.length > maxChars) {
-                content = content.slice(0, maxChars) + `\n\n[truncated — original ${content.length} chars]`;
-            }
-            const toolLabel = msg.toolName ? `[tool:${msg.toolName}] ` : "[tool] ";
-            result.push({
-                role: "tool",
-                content: toolLabel + content,
-                timestamp: now,
-                turnId,
-                sessionKey,
-                toolName: msg.toolName,
-            });
+        if (role === "tool" && msg.toolName && SELF_TOOLS.has(msg.toolName)) {
+            log.debug(`Skipping self-tool result: ${msg.toolName}`);
             continue;
         }
-        const cleaned = stripEvidenceBlocks(msg.content, evidenceTag);
-        if (cleaned.trim().length === 0)
+        let content = msg.content;
+        if (role === "user") {
+            content = stripInboundMetadata(content);
+        }
+        if (!content.trim())
             continue;
         result.push({
             role,
-            content: cleaned,
+            content,
             timestamp: now,
             turnId,
             sessionKey,
+            toolName: role === "tool" ? msg.toolName : undefined,
         });
     }
     log.debug(`Captured ${result.length}/${messages.length} messages for session=${sessionKey} turn=${turnId}`);
     return result;
 }
-function stripEvidenceBlocks(text, tag) {
-    const openTag = `[${tag}]`;
-    const closeTag = `[/${tag}]`;
-    let result = text;
-    let safety = 0;
-    while (result.includes(openTag) && result.includes(closeTag) && safety < 50) {
-        const start = result.indexOf(openTag);
-        const end = result.indexOf(closeTag, start);
-        if (end === -1)
-            break;
-        result = result.slice(0, start) + result.slice(end + closeTag.length);
-        safety++;
+/**
+ * Strip OpenClaw-injected inbound metadata blocks from user messages.
+ *
+ * These blocks have the shape:
+ *   Sender (untrusted metadata):
+ *   ```json
+ *   { "label": "...", "id": "..." }
+ *   ```
+ *
+ * Also strips the envelope timestamp prefix like "[Tue 2026-03-03 21:58 GMT+8] "
+ */
+function stripInboundMetadata(text) {
+    if (!SENTINEL_FAST_RE.test(text))
+        return text;
+    const lines = text.split("\n");
+    const result = [];
+    let inMetaBlock = false;
+    let inFencedJson = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (!inMetaBlock && INBOUND_META_SENTINELS.some(s => s === trimmed)) {
+            if (lines[i + 1]?.trim() === "```json") {
+                inMetaBlock = true;
+                inFencedJson = false;
+                continue;
+            }
+            // Sentinel without fenced JSON — skip this line only
+            continue;
+        }
+        if (inMetaBlock) {
+            if (!inFencedJson && trimmed === "```json") {
+                inFencedJson = true;
+                continue;
+            }
+            if (inFencedJson && trimmed === "```") {
+                inMetaBlock = false;
+                inFencedJson = false;
+                continue;
+            }
+            continue;
+        }
+        result.push(line);
     }
-    return result;
+    let cleaned = result.join("\n").trim();
+    // Strip envelope timestamp prefix: "[Tue 2026-03-03 21:58 GMT+8] actual message"
+    cleaned = cleaned.replace(/^\[(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)\s+\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}(?::\d{2})?\s+[A-Z]{3}[+-]\d{1,2}\]\s*/, "");
+    return cleaned;
 }
 //# sourceMappingURL=index.js.map

package/dist/capture/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"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"}

package/dist/ingest/providers/anthropic.d.ts

@@ -1,3 +1,5 @@
 import type { SummarizerConfig, Logger } from "../../types";
+export declare function summarizeTaskAnthropic(text: string, cfg: SummarizerConfig, log: Logger): Promise<string>;
+export declare function judgeNewTopicAnthropic(currentContext: string, newMessage: string, cfg: SummarizerConfig, log: Logger): Promise<boolean>;
 export declare function summarizeAnthropic(text: string, cfg: SummarizerConfig, log: Logger): Promise<string>;
 //# sourceMappingURL=anthropic.d.ts.map

package/dist/ingest/providers/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ingest/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI5D,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAgCjB"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/ingest/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAyC5D,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAeD,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAkClB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAgCjB"}