@memtensor/memos-local-openclaw-plugin 0.3.20 → 1.0.1

package/README.md

@@ -1,9 +1,16 @@
 # 🧠 MemOS — OpenClaw Memory Plugin
 
+[![npm version](https://img.shields.io/npm/v/@memtensor/memos-local-openclaw-plugin)](https://www.npmjs.com/package/@memtensor/memos-local-openclaw-plugin)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/MemTensor/MemOS/blob/main/LICENSE)
+[![Node.js >= 18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)
+[![GitHub](https://img.shields.io/badge/GitHub-Source-181717?logo=github)](https://github.com/MemTensor/MemOS/tree/main/apps/memos-local-openclaw)
+
 Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/openclaw) AI Agents. Every conversation is automatically captured, semantically indexed, and instantly recallable — with **task summarization & skill evolution**, and **multi-agent collaborative memory**.
 
 **Full-write | Hybrid Search | Task Summarization & Skill Evolution | Multi-Agent Collaboration | Memory Viewer**
 
+> **Homepage:** [Website](https://memtensor.github.io/MemOS/apps/memos-local-openclaw/www/) · [Documentation](https://memtensor.github.io/MemOS/apps/memos-local-openclaw/docs/) · [NPM](https://www.npmjs.com/package/@memtensor/memos-local-openclaw-plugin) · [GitHub](https://github.com/MemTensor/MemOS/tree/main/apps/memos-local-openclaw)
+
 ## Why MemOS
 
 | Problem | Solution |
@@ -26,11 +33,12 @@ Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/o
 - **Multi-provider embedding** — OpenAI-compatible, Gemini, Cohere, Voyage, Mistral, or local offline (Xenova/all-MiniLM-L6-v2)
 
 ### Task Summarization & Skill Evolution
-- **Auto task boundary detection** — LLM topic judgment + 2-hour idle timeout segments conversations into tasks
+- **Auto task boundary detection** — Per-turn LLM topic judgment (warm-up: 1 user turn) + 2-hour idle timeout segments conversations into tasks. Strongly biased toward SAME to avoid over-splitting related topics
 - **Structured summaries** — LLM generates Goal, Key Steps, Result, Key Details for each completed task
 - **Key detail preservation** — Code, commands, URLs, file paths, error messages retained in summaries
 - **Quality filtering** — Tasks with too few chunks, too few turns, or trivial content are auto-skipped
 - **Task status** — `active` (in progress), `completed` (with LLM summary), `skipped` (too brief, excluded from search)
+- **Task/Skill CRUD** — Edit title/summary, delete tasks and skills, retry skill generation from task cards
 - **Automatic evaluation** — After task completion, rule filter + LLM evaluates if the task is worth distilling into a skill
 - **Skill generation** — Multi-step LLM pipeline creates SKILL.md + scripts + references + evals from real execution records
 - **Skill upgrading** — When similar tasks appear, existing skills are auto-upgraded (refine / extend / fix)
@@ -38,6 +46,7 @@ Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/o
 - **Version management** — Full version history with changelog, change summary, and upgrade type tracking
 - **Auto-install** — Generated skills can be auto-installed into the workspace for immediate use
 - **Dedicated model** — Optional separate LLM model for skill generation (e.g., Claude 4.6 for higher quality)
+- **LLM fallback chain** — `skillSummarizer` → `summarizer` → OpenClaw native model (auto-detected from `openclaw.json`). If all configured models fail, the next in chain is tried automatically
 
 ### Multi-Agent Collaboration
 - **Memory isolation** — Each agent's memories are tagged with `owner`. During search, agents only see their own private memories and explicitly shared `public` memories
@@ -51,15 +60,16 @@ Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/o
 - **One-click import** — Seamlessly migrate OpenClaw's native built-in memories (SQLite + JSONL) into the MemOS intelligent memory system
 - **Smart deduplication** — Vector similarity + LLM judgment prevents duplicate imports; similar content auto-merged
 - **Resume anytime** — Pause and resume at any time; refreshing the page auto-restores progress; already processed items are skipped
-- **Post-import processing** — Optionally generate task summaries and evolve skills from imported memories, with serial processing per session
+- **Post-import processing** — Optionally generate task summaries and evolve skills from imported memories; serial processing within each agent, parallel across agents
+- **Agent parallelism** — Configurable concurrency (1–8) for parallel processing across agents; sessions within each agent are processed serially
 - **Source tagging** — All migrated memories are tagged with 🦐, visually distinguishing them from conversation-generated memories
 - **Real-time progress** — Live progress bar, stats (stored/skipped/merged/errors), and scrolling log via SSE
 
 ### Memory Viewer
 - **7 management pages** — Memories, Tasks, Skills, Analytics, **Logs**, **Import**, Settings
 - **Full CRUD** — Create, edit, delete, search memories; evolution badges and merge history on memory cards
-- **Task browser** — Status filters, chat-bubble chunk view, structured summaries, skill generation status
-- **Skill browser** — Version history, quality scores, one-click download as ZIP
+- **Task browser** — Status filters, chat-bubble chunk view, structured summaries, skill generation status; edit/delete/retry-skill buttons on cards
+- **Skill browser** — Version history, quality scores, visibility toggle, one-click download as ZIP; edit/delete/publish buttons on cards
 - **Analytics dashboard** — Daily read/write activity, memory breakdown charts
 - **Logs** — Tool call log (memory_search, auto_recall, memory_add, etc.) with input/output and duration; filter by tool, auto-refresh
 - **Online configuration** — Modify embedding, summarizer, skill evolution settings via web UI
@@ -77,17 +87,38 @@ Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/o
 
 ### 1. Install
 
-**From npm (recommended):**
+**Step 0 — Prepare build environment (macOS / Linux):**
+
+This plugin uses `better-sqlite3`, a native C/C++ module. On **macOS** and **Linux**, prebuilt binaries may not be available, so **install C++ build tools first** to ensure a smooth installation:
+
+```bash
+# macOS
+xcode-select --install
+
+# Linux (Ubuntu / Debian)
+sudo apt install build-essential python3
+```
+
+> **Windows users:** `better-sqlite3` ships prebuilt binaries for Windows + Node.js LTS, so you can usually skip this step and go directly to Step 1. If installation still fails, install [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) (select "C++ build tools" workload).
+>
+> Already have build tools? Skip to Step 1. Not sure? Run the install command above — it's safe to re-run.
+>
+> **Still having issues?** See the [Troubleshooting](#troubleshooting) section, the [detailed troubleshooting guide](https://memtensor.github.io/MemOS/apps/memos-local-openclaw/docs/troubleshooting.html), or the [official better-sqlite3 troubleshooting docs](https://github.com/WiseLibs/better-sqlite3/blob/master/docs/troubleshooting.md).
+
+**Step 1 — Install the plugin:**
 
 ```bash
 openclaw plugins install @memtensor/memos-local-openclaw-plugin
 ```
 
-The plugin is installed under `~/.openclaw/extensions/memos-local-openclaw-plugin` and registered as `memos-local-openclaw-plugin`. Dependencies and native modules are built automatically during installation.
+The plugin is installed under `~/.openclaw/extensions/memos-local-openclaw-plugin` and registered as `memos-local-openclaw-plugin`. Dependencies and `better-sqlite3` native module are built automatically during installation.
 
 > **Note:** 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`.
 >
-> If better-sqlite3 fails to build automatically, ensure you have C++ build tools installed: macOS: `xcode-select --install`, Linux: `sudo apt install build-essential`.
+> **Installation failed?** If `better-sqlite3` compilation fails during install, manually rebuild after ensuring build tools are installed:
+> ```bash
+> cd ~/.openclaw/extensions/memos-local-openclaw-plugin && npm rebuild better-sqlite3
+> ```
 
 **From source (development):**
 
@@ -164,7 +195,7 @@ Add the plugin config to `~/.openclaw/openclaw.json`:
 | Gemini | `gemini` | `gemini-1.5-flash` |
 | AWS Bedrock | `bedrock` | `anthropic.claude-3-haiku-20240307-v1:0` |
 
-> **No summarizer config?** A rule-based fallback generates summaries from the first sentence + key entities. Good enough to start.
+> **No summarizer config?** The plugin automatically falls back to the OpenClaw native model (auto-detected from `~/.openclaw/openclaw.json`). If that is also unavailable, a rule-based fallback generates summaries from the first sentence + key entities. Good enough to start.
 
 #### Skill Evolution Configuration (Optional)
 
@@ -188,7 +219,7 @@ You can optionally configure a dedicated model for skill generation (for higher
 }
 ```
 
-If `skillSummarizer` is not configured, the plugin uses the regular `summarizer` model for skill generation.
+**LLM fallback chain:** `skillSummarizer` → `summarizer` → OpenClaw native model (auto-detected from `~/.openclaw/openclaw.json`). If `skillSummarizer` is not configured, the plugin tries the regular `summarizer`, then falls back to the OpenClaw native model. Each step in the chain is tried automatically if the previous one fails.
 
 #### Environment Variable Support
 
@@ -269,9 +300,13 @@ Conversation → Capture (filter roles, strip system prompts)
 ### Pipeline 2: Task Generation (auto after memory write)
 
 ```
-New chunks → Task boundary detection (LLM topic judge / 2h idle / session change)
-→ Boundary crossed? → Finalize previous task
-  → Chunks ≥ 4 & turns ≥ 2? → LLM structured summary → status = "completed"
+New chunks → Group into user-turns → Process one turn at a time
+→ Warm-up (first user turn): assign directly
+→ Each subsequent user turn: LLM topic judge (context vs new message)
+  → "NEW"? → Finalize current task, create new task
+  → "SAME"? → Assign to current task
+→ Time gap > 2h? → Always split regardless of topic
+→ Finalize: Chunks ≥ 4 & turns ≥ 2? → LLM structured summary → status = "completed"
   → Otherwise → status = "skipped" (excluded from search)
 ```
 
@@ -352,6 +387,8 @@ The plugin provides **12 smart tools** (11 registered tools + auto-recall) and a
 | `minScore` | 0.45 | 0.35–1.0 | Minimum relevance score |
 | `role` | — | `user` / `assistant` / `tool` | Filter by message role (e.g. `user` to find what the user said) |
 
+> **Viewer search** uses a stricter threshold (`minScore` 0.64) for vector results. When no semantic matches are found, it falls back to FTS5 keyword search and returns the top 20 keyword-based results.
+
 ## Memory Viewer
 
 Open `http://127.0.0.1:18799` in your browser after starting the gateway.
@@ -498,6 +535,8 @@ openclaw plugins install @memtensor/memos-local-openclaw-plugin
 ## Troubleshooting
 
 > 📖 **详细排查指南 / Detailed troubleshooting guide:** [docs/troubleshooting.html](https://memtensor.github.io/MemOS/apps/memos-local-openclaw/docs/troubleshooting.html) — 包含逐步排查流程、日志查看方法、完全重装步骤等。
+>
+> 📦 **better-sqlite3 official troubleshooting:** [better-sqlite3 Troubleshooting](https://github.com/WiseLibs/better-sqlite3/blob/master/docs/troubleshooting.md) — the upstream guide for native module build issues.
 
 ### Common Issues
 
@@ -533,19 +572,25 @@ openclaw plugins install @memtensor/memos-local-openclaw-plugin
    npm rebuild better-sqlite3
    ```
    If rebuild fails, install C++ build tools first:
-   - **macOS:** `xcode-select --install`
+   - **macOS:** `xcode-select --install` (if you see `xcrun: error: invalid active developer path`, run this first)
    - **Linux:** `sudo apt install build-essential python3`
-   - **Windows:** Install [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
+   - **Windows:** Usually not needed — `better-sqlite3` provides prebuilt binaries for Windows + Node.js LTS. If it still fails, install [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) (select "C++ build tools" workload)
 
    Then retry `npm rebuild better-sqlite3` and restart the gateway.
 
+   > **Still failing?** Check the official [better-sqlite3 troubleshooting guide](https://github.com/WiseLibs/better-sqlite3/blob/master/docs/troubleshooting.md) for platform-specific solutions. For non-LTS Node.js versions (e.g., v25.x), prebuilt binaries may not be available and compilation from source is required.
+
 7. **Memory conflict with built-in search** — If the agent calls both the built-in memory search and the plugin's `memory_search`, it means `agents.defaults.memorySearch.enabled` is not set to `false`.
 
 8. **Skills not generating** — Check:
    - `skillEvolution.enabled` is `true`
    - Tasks have enough content (default requires >= 6 chunks)
+   - LLM model is accessible (check gateway log for `judgeNewTopic failed` or `SkillEvolver` errors)
+   - The LLM fallback chain will try: `skillSummarizer` → `summarizer` → OpenClaw native model. If all fail, skill generation is skipped
    - Look for `SkillEvolver` output in the gateway log
 
+9. **LLM calls failing** — All LLM-dependent features (summarization, topic detection, skill generation) use a fallback chain. If the configured model returns an error, the next model in the chain is tried automatically. Check the gateway log for messages like `failed (model), trying next`. If all models fail, the operation falls back to rule-based logic or is skipped.
+
 ## Data Location
 
 | File | Path |
@@ -558,21 +603,193 @@ openclaw plugins install @memtensor/memos-local-openclaw-plugin
 | Generated skills | `~/.openclaw/memos-local/skills-store/<skill-name>/` |
 | Installed skills | `~/.openclaw/workspace/skills/<skill-name>/` |
 
-## Testing
+## Development Guide
+
+This section is for contributors who want to develop, test, or modify the plugin from source.
+
+### Prerequisites
+
+- **Node.js >= 18** (`node -v`)
+- **npm >= 9** (`npm -v`)
+- **C++ build tools** (for `better-sqlite3` native module):
+  - macOS: `xcode-select --install`
+  - Linux: `sudo apt install build-essential python3`
+  - Windows: usually not needed (prebuilt binaries available for LTS Node.js); if build fails, install [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)
+- **OpenClaw CLI** installed and available in PATH (`openclaw --version`)
 
-Run the test suite:
+> **`better-sqlite3` build issues?** This is the most common installation problem on macOS and Linux. If `npm install` fails, first install the C++ build tools above, then run `npm rebuild better-sqlite3`. For detailed platform-specific solutions, see the [official better-sqlite3 troubleshooting guide](https://github.com/WiseLibs/better-sqlite3/blob/master/docs/troubleshooting.md) and our [installation troubleshooting page](https://memtensor.github.io/MemOS/apps/memos-local-openclaw/docs/troubleshooting.html).
+
+### Clone & Setup
 
 ```bash
+git clone https://github.com/MemTensor/MemOS.git
 cd MemOS/apps/memos-local-openclaw
-npm test
+npm install
+```
+
+> `npm install` triggers the `postinstall` script which automatically rebuilds `better-sqlite3` for your Node.js version.
+
+### Project Structure
+
+```
+apps/memos-local-openclaw/
+├── index.ts                 # Plugin entry — hooks, tool registration, lifecycle
+├── plugin-impl.ts           # OpenClaw plugin SDK implementation
+├── src/
+│   ├── index.ts             # Module re-exports
+│   ├── config.ts            # Configuration schema & defaults
+│   ├── types.ts             # TypeScript type definitions
+│   ├── capture/index.ts     # Message capture & filtering logic
+│   ├── embedding/           # Embedding providers (OpenAI, Gemini, Cohere, etc.)
+│   ├── ingest/
+│   │   ├── chunker.ts       # Semantic chunking (code blocks, paragraphs)
+│   │   ├── dedup.ts         # Content-hash + vector deduplication
+│   │   ├── worker.ts        # Async ingestion pipeline
+│   │   ├── task-processor.ts # Task boundary detection & summarization
+│   │   └── providers/       # LLM providers for summarization
+│   ├── recall/
+│   │   ├── engine.ts        # Hybrid retrieval engine (FTS5 + Vector)
+│   │   ├── rrf.ts           # Reciprocal Rank Fusion
+│   │   ├── mmr.ts           # Maximal Marginal Relevance
+│   │   └── recency.ts       # Time-decay scoring
+│   ├── shared/
+│   │   └── llm-call.ts      # LLM fallback chain utility (callLLMWithFallback, buildSkillConfigChain)
+│   ├── skill/               # Skill evolution pipeline (evaluator, generator, upgrader)
+│   ├── storage/
+│   │   ├── sqlite.ts        # SQLite database layer (chunks, tasks, skills, FTS5)
+│   │   └── vector.ts        # Vector similarity search
+│   ├── tools/               # Tool implementations (memory-search, memory-get, etc.)
+│   ├── viewer/              # Memory Viewer web server & HTML templates
+│   └── telemetry.ts         # Anonymous usage analytics
+├── tests/                   # Test suite (vitest)
+├── scripts/                 # Utility scripts (seed data, smoke test, viewer)
+├── skill/                   # Bundled skill definitions (SKILL.md files)
+├── openclaw.plugin.json     # Plugin metadata for OpenClaw registry
+├── package.json             # Dependencies & scripts
+├── tsconfig.json            # TypeScript configuration
+└── vitest.config.ts         # Test runner configuration
+```
+
+**Files NOT in the repository** (generated locally, excluded via `.gitignore`):
+
+| Directory / File | Purpose | How to generate |
+|---|---|---|
+| `node_modules/` | npm dependencies | `npm install` |
+| `dist/` | Compiled JavaScript output | `npm run build` |
+| `package-lock.json` | Dependency lock file | `npm install` (auto-generated) |
+| `www/` | Memory Viewer static site (local preview) | Started automatically by the plugin |
+| `docs/` | Documentation HTML pages | Built from source or viewed at the hosted URL |
+| `ppt/` | Presentation files (internal use) | Not needed for development |
+| `.env` | Local environment variables | Copy from `.env.example` |
+
+### Build
+
+```bash
+npm run build       # Compile TypeScript → dist/
+npm run dev         # Watch mode — auto-recompile on save
+```
+
+The build output goes to `dist/` (CommonJS modules with declarations and source maps).
+
+### Configure for Local Development
+
+1. **Copy the environment template:**
+
+```bash
+cp .env.example .env
+```
+
+2. **Edit `.env`** with your API keys (or leave blank for local-only mode):
+
+```bash
+# Embedding — leave blank to use local offline model
+EMBEDDING_PROVIDER=openai_compatible
+EMBEDDING_API_KEY=your-key
+EMBEDDING_ENDPOINT=https://your-api.com/v1
+EMBEDDING_MODEL=bge-m3
+
+# Summarizer — leave blank for rule-based fallback
+SUMMARIZER_PROVIDER=openai_compatible
+SUMMARIZER_API_KEY=your-key
+SUMMARIZER_ENDPOINT=https://api.openai.com/v1
+SUMMARIZER_MODEL=gpt-4o-mini
+```
+
+3. **Install the plugin locally into OpenClaw:**
+
+```bash
+npm run build
+openclaw plugins install .
+```
+
+4. **Configure OpenClaw** — Add the plugin to `~/.openclaw/openclaw.json` (see [Configure](#2-configure) section above).
+
+5. **Start the gateway:**
+
+```bash
+openclaw gateway stop    # stop existing
+openclaw gateway start   # start with new plugin
+```
+
+### Testing
+
+Run the full test suite:
+
+```bash
+npm test              # Run all tests once
+npm run test:watch    # Watch mode — re-run on file changes
 ```
 
 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
+
+| Test File | Coverage |
+|---|---|
+| `tests/policy.test.ts` | Retrieval strategy, search filtering, evidence extraction, instruction stripping |
+| `tests/recall.test.ts` | RRF fusion, recency decay correctness |
+| `tests/capture.test.ts` | Message filtering, evidence block stripping, self-tool exclusion |
+| `tests/storage.test.ts` | SQLite CRUD, FTS5, vector storage, content hash dedup |
+| `tests/chunker.test.ts` | Semantic chunking for code blocks, paragraphs, function bodies |
+| `tests/task-processor.test.ts` | Task boundary detection, skip logic, summary generation |
+| `tests/multi-agent.test.ts` | Multi-agent memory isolation, owner filtering, public sharing |
+| `tests/integration.test.ts` | End-to-end ingestion and retrieval pipeline |
+
+> Tests use an **in-memory SQLite database** — no external services or API keys required.
+
+### Development Workflow
+
+1. **Make changes** to files in `src/` or `index.ts`
+2. **Run tests** to verify: `npm test`
+3. **Build** to check TypeScript compilation: `npm run build`
+4. **Test with OpenClaw** locally:
+   ```bash
+   openclaw plugins install .   # re-install from local source
+   openclaw gateway stop && openclaw gateway start
+   tail -f ~/.openclaw/logs/gateway.log   # watch logs
+   ```
+5. **Open Memory Viewer** at `http://127.0.0.1:18799` to verify UI changes
+
+### Publishing to npm
+
+```bash
+npm run build                    # Compile TypeScript
+npm publish --access public      # Publish to npm registry
+```
+
+After publishing, users can install with:
+```bash
+openclaw plugins install @memtensor/memos-local-openclaw-plugin
+```
+
+### Utility Scripts
+
+| Script | Command | Purpose |
+|---|---|---|
+| Seed test data | `npx tsx scripts/seed-test-data.ts` | Populate local DB with sample memories, tasks, and skills |
+| Smoke test | `npx tsx scripts/smoke-test.ts` | Quick end-to-end verification of plugin functionality |
+| Start viewer | `npx tsx scripts/start-viewer.ts` | Start Memory Viewer standalone (without gateway) |
+| Refresh skills | `npx tsx scripts/refresh-skill.ts` | Re-evaluate and regenerate skills from existing tasks |
+| Refresh summaries | `npx tsx scripts/refresh-summaries.ts` | Re-generate task summaries for completed tasks |
+| Mock skills | `npx tsx scripts/mock-skills.ts` | Generate mock skill data for testing |
 
 ## License
 

package/dist/capture/index.d.ts

@@ -10,7 +10,7 @@ export declare function captureMessages(messages: Array<{
     role: string;
     content: string;
     toolName?: string;
-}>, sessionKey: string, turnId: string, _evidenceTag: string, log: Logger, owner?: string): ConversationMessage[];
+}>, sessionKey: string, turnId: string, evidenceTag: string, log: Logger, owner?: string): ConversationMessage[];
 /**
  * Strip OpenClaw-injected inbound metadata blocks from user messages.
  *

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;AA8BlE;;;;;;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,EACX,KAAK,CAAC,EAAE,MAAM,GACb,mBAAmB,EAAE,CAiCvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgDzD"}
+{"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;AAmClE;;;;;;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,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,mBAAmB,EAAE,CAwCvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8CzD"}

package/dist/capture/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.captureMessages = captureMessages;
 exports.stripInboundMetadata = stripInboundMetadata;
 const SKIP_ROLES = new Set(["system"]);
+const SYSTEM_BOILERPLATE_RE = /^A new session was started via \/new or \/reset\b/;
 const SELF_TOOLS = new Set([
     "memory_search",
     "memory_timeline",
@@ -23,7 +24,8 @@ const INBOUND_META_SENTINELS = [
     "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("|"));
+const SENTINEL_FAST_RE = new RegExp(INBOUND_META_SENTINELS.map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|"));
+const ENVELOPE_PREFIX_RE = /^\s*\[(?: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*/;
 /**
  * Extract writable messages from a conversation turn.
  *
@@ -31,7 +33,7 @@ const SENTINEL_FAST_RE = new RegExp(INBOUND_META_SENTINELS.map(s => s.replace(/[
  * 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, owner) {
+function captureMessages(messages, sessionKey, turnId, evidenceTag, log, owner) {
     const now = Date.now();
     const result = [];
     for (const msg of messages) {
@@ -44,10 +46,17 @@ function captureMessages(messages, sessionKey, turnId, _evidenceTag, log, owner)
             log.debug(`Skipping self-tool result: ${msg.toolName}`);
             continue;
         }
+        if (role === "user" && SYSTEM_BOILERPLATE_RE.test(msg.content.trim())) {
+            log.debug(`Skipping system boilerplate: ${msg.content.slice(0, 60)}...`);
+            continue;
+        }
         let content = msg.content;
         if (role === "user") {
             content = stripInboundMetadata(content);
         }
+        else {
+            content = stripEvidenceWrappers(content, evidenceTag);
+        }
         if (!content.trim())
             continue;
         result.push({
@@ -75,13 +84,13 @@ function captureMessages(messages, sessionKey, turnId, _evidenceTag, log, owner)
  * Also strips the envelope timestamp prefix like "[Tue 2026-03-03 21:58 GMT+8] "
  */
 function stripInboundMetadata(text) {
-    // Strip envelope timestamp prefix: "[Tue 2026-03-03 21:58 GMT+8] actual message"
-    let cleaned = text.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*/, "");
+    let cleaned = stripEnvelopePrefix(text);
     // Strip OpenClaw envelope tags: [message_id: ...], [[reply_to_current]], etc.
     cleaned = cleaned.replace(/\[message_id:\s*[a-f0-9-]+\]/gi, "");
     cleaned = cleaned.replace(/\[\[reply_to_current\]\]/gi, "");
-    if (!SENTINEL_FAST_RE.test(cleaned))
-        return cleaned.trim();
+    if (!SENTINEL_FAST_RE.test(cleaned)) {
+        return stripEnvelopePrefix(cleaned).trim();
+    }
     const lines = cleaned.split("\n");
     const result = [];
     let inMetaBlock = false;
@@ -89,7 +98,7 @@ function stripInboundMetadata(text) {
     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 (!inMetaBlock && INBOUND_META_SENTINELS.some((s) => s === trimmed)) {
             if (lines[i + 1]?.trim() === "```json") {
                 inMetaBlock = true;
                 inFencedJson = false;
@@ -111,6 +120,22 @@ function stripInboundMetadata(text) {
         }
         result.push(line);
     }
-    return result.join("\n").trim();
+    return stripEnvelopePrefix(result.join("\n")).trim();
+}
+function stripEnvelopePrefix(text) {
+    return text.replace(ENVELOPE_PREFIX_RE, "");
+}
+function stripEvidenceWrappers(text, evidenceTag) {
+    const tag = evidenceTag.trim();
+    if (!tag)
+        return text;
+    const escapedTag = tag.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const wrapperRe = new RegExp(`\\[${escapedTag}\\][\\s\\S]*?\\[\\/${escapedTag}\\]`, "g");
+    return text
+        .replace(wrapperRe, "")
+        .replace(/[ \t]{2,}/g, " ")
+        .replace(/\s+([,.;:!?])/g, "$1")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
 }
 //# 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/index.d.ts

@@ -8,7 +8,7 @@ export interface MemosLocalPlugin {
     }>, sessionKey?: string, owner?: string) => void;
     /** Wait for all pending ingest operations to complete. */
     flush: () => Promise<void>;
-    shutdown: () => void;
+    shutdown: () => Promise<void>;
 }
 export interface PluginInitOptions {
     stateDir?: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,kBAAkB,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtH,0DAA0D;IAC1D,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,gBAAgB,CAiDzE;AAQD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,kBAAkB,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtH,0DAA0D;IAC1D,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,gBAAgB,CAkDzE;AAQD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -62,8 +62,9 @@ function initPlugin(opts = {}) {
         async flush() {
             await worker.flush();
         },
-        shutdown() {
+        async shutdown() {
             ctx.log.info("Shutting down memos-local plugin...");
+            await worker.flush();
             store.close();
         },
     };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAiDA,gCAiDC;AAlGD,+BAAkC;AAClC,qCAAwC;AACxC,6CAA+C;AAC/C,2CAAuC;AACvC,4CAA+C;AAC/C,4CAA+C;AAC/C,uCAA4C;AAC5C,mCAAgG;AAmBhG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,UAAU,CAAC,OAA0B,EAAE;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxD,MAAM,GAAG,GAAG,IAAA,qBAAY,EAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAExE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,IAAI,oBAAW,CAAC,GAAG,CAAC,MAAM,CAAC,OAAQ,CAAC,MAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,oBAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,qBAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,qBAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAqB;QAC9B,IAAA,8BAAsB,EAAC,MAAM,CAAC;QAC9B,IAAA,gCAAwB,EAAC,KAAK,CAAC;QAC/B,IAAA,2BAAmB,EAAC,KAAK,CAAC;KAC3B,CAAC;IAEF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,GAAG,CAAC,MAAM,CAAC,OAAQ,CAAC,MAAM,gBAAgB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEjG,OAAO;QACL,EAAE,EAAE,aAAa;QAEjB,KAAK;QAEL,kBAAkB,CAChB,QAAkD,EAClD,UAAmB,EACnB,KAAc;YAEd,MAAM,OAAO,GAAG,UAAU,IAAI,SAAS,CAAC;YACxC,MAAM,MAAM,GAAG,IAAA,SAAI,GAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,IAAI,eAAe,CAAC;YAEtE,MAAM,QAAQ,GAAG,IAAA,yBAAe,EAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACjF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,QAAQ;YACN,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YACpD,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IACnE,OAAO,GAAG,IAAI,YAAY,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAiDA,gCAkDC;AAnGD,+BAAkC;AAClC,qCAAwC;AACxC,6CAA+C;AAC/C,2CAAuC;AACvC,4CAA+C;AAC/C,4CAA+C;AAC/C,uCAA4C;AAC5C,mCAAgG;AAmBhG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,UAAU,CAAC,OAA0B,EAAE;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxD,MAAM,GAAG,GAAG,IAAA,qBAAY,EAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAExE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,IAAI,oBAAW,CAAC,GAAG,CAAC,MAAM,CAAC,OAAQ,CAAC,MAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,oBAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,qBAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,qBAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAqB;QAC9B,IAAA,8BAAsB,EAAC,MAAM,CAAC;QAC9B,IAAA,gCAAwB,EAAC,KAAK,CAAC;QAC/B,IAAA,2BAAmB,EAAC,KAAK,CAAC;KAC3B,CAAC;IAEF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,GAAG,CAAC,MAAM,CAAC,OAAQ,CAAC,MAAM,gBAAgB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEjG,OAAO;QACL,EAAE,EAAE,aAAa;QAEjB,KAAK;QAEL,kBAAkB,CAChB,QAAkD,EAClD,UAAmB,EACnB,KAAc;YAEd,MAAM,OAAO,GAAG,UAAU,IAAI,SAAS,CAAC;YACxC,MAAM,MAAM,GAAG,IAAA,SAAI,GAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,IAAI,eAAe,CAAC;YAEtE,MAAM,QAAQ,GAAG,IAAA,yBAAe,EAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACjF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YACpD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IACnE,OAAO,GAAG,IAAI,YAAY,CAAC;AAC7B,CAAC"}

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;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;AAwBD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACnE,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,YAAY,CAAC,CAmCvB;AAmBD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAKD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACtE,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,CAAC,CAiCtB"}
+{"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;AA6BD,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAkClB;AAwBD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACnE,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,YAAY,CAAC,CAmCvB;AAmBD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAKD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACtE,GAAG,EAAE,gBAAgB,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,CAAC,CAiCtB"}

package/dist/ingest/providers/anthropic.js

@@ -70,16 +70,30 @@ async function summarizeTaskAnthropic(text, cfg, log) {
     const json = (await resp.json());
     return json.content.find((c) => c.type === "text")?.text?.trim() ?? "";
 }
-const TOPIC_JUDGE_PROMPT = `You are a conversation topic boundary detector. Given a summary of the CURRENT conversation and a NEW user message, determine if the new message starts a DIFFERENT topic/task.
+const TOPIC_JUDGE_PROMPT = `You are a conversation topic boundary detector. Given the CURRENT task context (may include opening topic + recent exchanges) and a single NEW user message, decide if the new message belongs to the SAME task or starts a NEW one.
 
 Answer ONLY "NEW" or "SAME".
 
-Rules:
-- "NEW" = the new message is about a completely different subject, project, or task
-- "SAME" = the new message continues, follows up on, or is closely related to the current topic
-- Follow-up questions, clarifications, refinements, bug fixes, or next steps on the same task = SAME
-- Greetings or meta-questions like "你好" or "谢谢" without new substance = SAME
-- A clearly unrelated request (e.g., current topic is deployment, new message asks about cooking) = NEW
+SAME — the new message:
+- Continues, follows up on, refines, or corrects the same subject/project/task
+- Asks a clarification or next-step question about what was just discussed
+- Reports a result, error, or feedback about the current task
+- Discusses different tools, methods, or approaches for the SAME goal (e.g., learning English via BBC → via ChatGPT → via AI tools = all SAME "learning English" task)
+- Mentions a related technology or platform in the context of the current goal
+- Is a short acknowledgment (ok, thanks, 好的, 嗯) in direct response to the current flow
+
+NEW — the new message:
+- Introduces a clearly UNRELATED subject with NO logical connection to the current task
+- The topic has ZERO overlap with any aspect of the current conversation (e.g., from "learning English" to "what's the weather tomorrow")
+- Starts a request about a completely different domain or life area
+- Begins with a new greeting/reset followed by a different topic
+
+Key principles:
+- STRONGLY lean toward SAME — only mark NEW for obvious, unambiguous topic shifts
+- Different aspects, tools, or methods related to the same overall goal are SAME
+- If the new message could reasonably be interpreted as part of the ongoing discussion, choose SAME
+- Only choose NEW when there is absolutely no thematic connection to the current task
+- Examples: "学英语" → "用AI工具学英语" = SAME; "学英语" → "明天天气" = NEW
 
 Output exactly one word: NEW or SAME`;
 async function judgeNewTopicAnthropic(currentContext, newMessage, cfg, log) {
@@ -91,7 +105,7 @@ async function judgeNewTopicAnthropic(currentContext, newMessage, cfg, log) {
         "anthropic-version": "2023-06-01",
         ...cfg.headers,
     };
-    const userContent = `CURRENT CONVERSATION SUMMARY:\n${currentContext}\n\nNEW USER MESSAGE:\n${newMessage}`;
+    const userContent = `CURRENT TASK CONTEXT:\n${currentContext}\n\n---\n\nNEW USER MESSAGE:\n${newMessage}`;
     const resp = await fetch(endpoint, {
         method: "POST",
         headers,