@memoryrelay/plugin-memoryrelay-ai 0.15.0 → 0.15.2

package/README.md

@@ -22,7 +22,7 @@ MemoryRelay is designed for engineering teams managing complex, long-running pro
 | Multi-agent collaboration | Yes (agent scoping, subagent tracking) | Limited | No |
 | Auto-capture with privacy tiers | Yes (off/conservative/smart/aggressive) | Basic | No |
 | V2 Async Storage | Yes | No | No |
-| Direct commands | 16 | ~5 | 0 |
+| Direct commands | 17 | ~5 | 0 |
 | Lifecycle hooks | 13 | 0 | 0 |
 | Tools | 42 | ~10 | 0 |
 
@@ -314,10 +314,31 @@ The plugin registers 14 lifecycle hooks:
 
 ### Skills
 
-The plugin ships with 9 skills providing guided workflows on top of the raw tools:
+The plugin ships with 5 skills providing guided workflows on top of the raw tools:
 
-- **Agent-facing**: `memory-workflow`, `decision-tracking`, `pattern-management`, `project-orchestration`, `entity-and-context`
-- **Developer-facing**: `codebase-navigation`, `testing-memoryrelay`, `release-process`
+- `memory-workflow` — Session lifecycle, storing/retrieving memories
+- `decision-tracking` — ADR management, checking before deciding
+- `pattern-management` — Reusable conventions, search before create
+- `project-orchestration` — Multi-project context loading and impact analysis
+- `entity-and-context` — Knowledge graph, linking entities to memories
+
+## Updating
+
+To update to the latest version:
+
+```bash
+openclaw plugins update plugin-memoryrelay-ai
+```
+
+Or from within a conversation, run `/memory-update` to see the exact command.
+
+**Important:** The plugin ID is `plugin-memoryrelay-ai` (not `memory-memoryrelay`). Using the wrong ID will fail with "No install record."
+
+After updating, restart the gateway:
+
+```bash
+openclaw restart
+```
 
 ## Troubleshooting
 

package/index.ts

@@ -1,10 +1,11 @@
 /**
  * OpenClaw Memory Plugin - MemoryRelay
- * Version: 0.13.0 (SDK Enhancements)
+ * Version: 0.15.2
  *
  * Long-term memory with vector search using MemoryRelay API.
  * Provides auto-recall and auto-capture via lifecycle hooks.
  * Includes: memories, entities, agents, sessions, decisions, patterns, projects.
+ * New in v0.15.0: V2 async API, context_build with AI-enhanced search modes
  * New in v0.13.0: External session IDs, get-or-create sessions, multi-agent collaboration
  * New in v0.12.7: OpenClaw session context integration for session tracking
  * New in v0.12.0: Smart auto-capture, daily stats, CLI commands, onboarding
@@ -67,6 +68,7 @@ interface DebugLoggerConfig {
   enabled: boolean;
   verbose: boolean;
   maxEntries: number;
+  logFile?: string; // Deprecated: File logging removed for security compliance
 }
 
 class DebugLogger {
@@ -709,7 +711,7 @@ class MemoryRelayClient {
           headers: {
             "Content-Type": "application/json",
             Authorization: `Bearer ${this.apiKey}`,
-            "User-Agent": "openclaw-memory-memoryrelay/0.15.0",
+            "User-Agent": "openclaw-memory-memoryrelay/0.15.2",
           },
           body: body ? JSON.stringify(body) : undefined,
         },
@@ -1666,7 +1668,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
   }
 
   // ========================================================================
-  // Tools (39 total)
+  // Tools (42 total)
   // ========================================================================
 
   // --------------------------------------------------------------------------
@@ -4490,7 +4492,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
   });
 
   api.logger.info?.(
-    `memory-memoryrelay: plugin v0.15.0 loaded (${Object.values(TOOL_GROUPS).flat().length} tools, autoRecall: ${cfg?.autoRecall}, autoCapture: ${autoCaptureConfig.enabled ? autoCaptureConfig.tier : 'off'}, debug: ${debugEnabled})`,
+    `memory-memoryrelay: plugin v0.15.2 loaded (${Object.values(TOOL_GROUPS).flat().length} tools, autoRecall: ${cfg?.autoRecall}, autoCapture: ${autoCaptureConfig.enabled ? autoCaptureConfig.tier : 'off'}, debug: ${debugEnabled})`,
   );
 
   // ========================================================================
@@ -4551,7 +4553,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
         }
 
         const formatted = logs.map((l) =>
-          `[${new Date(l.timestamp).toISOString()}] ${l.level.toUpperCase()} ${l.tool ?? "-"}: ${l.message}`
+          `[${new Date(l.timestamp).toISOString()}] ${l.status.toUpperCase()} ${l.tool ?? "-"}: ${l.method} ${l.path} (${l.duration}ms)${l.error ? ` - ${l.error}` : ""}`
         ).join("\n");
         respond(true, {
           logs,
@@ -4898,7 +4900,7 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
   }
 
   // ========================================================================
-  // Direct Commands (16 total) — bypass LLM, execute immediately
+  // Direct Commands (17 total) — bypass LLM, execute immediately
   // ========================================================================
 
   // /memory-status — Show full plugin status report
@@ -5580,6 +5582,33 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
     },
   });
 
+  // /memory-update — Show update instructions (v0.15.0)
+  api.registerCommand?.({
+    name: "memory-update",
+    description: "Show how to update the MemoryRelay plugin to the latest version",
+    requireAuth: true,
+    handler: async (_ctx) => {
+      const currentVersion = "0.15.2";
+      const lines: string[] = [
+        "MemoryRelay Plugin Update",
+        "━".repeat(50),
+        `Current version: ${currentVersion}`,
+        "",
+        "To update to the latest version, run:",
+        "",
+        "  openclaw plugins update plugin-memoryrelay-ai",
+        "",
+        "Then restart the gateway:",
+        "",
+        "  openclaw restart",
+        "",
+        "Note: The plugin ID is 'plugin-memoryrelay-ai'",
+        "(not 'memory-memoryrelay').",
+      ];
+      return { text: lines.join("\n") };
+    },
+  });
+
   // ========================================================================
   // Stale Session Cleanup Service (v0.13.0)
   // ========================================================================

package/openclaw.plugin.json

@@ -2,8 +2,8 @@
   "id": "plugin-memoryrelay-ai",
   "kind": "memory",
   "name": "MemoryRelay AI",
-  "description": "MemoryRelay v0.15.0 - Long-term memory with 42 tools, 16 commands, V2 async, sessions, decisions, patterns & projects (api.memoryrelay.net)",
-  "version": "0.15.0",
+  "description": "MemoryRelay v0.15.2 - Long-term memory with 42 tools, 17 commands, V2 async, sessions, decisions, patterns & projects (api.memoryrelay.net)",
+  "version": "0.15.2",
   "uiHints": {
     "apiKey": {
       "label": "MemoryRelay API Key",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memoryrelay/plugin-memoryrelay-ai",
-  "version": "0.15.0",
-  "description": "OpenClaw memory plugin for MemoryRelay API - 42 tools, 16 commands, V2 async, sessions, decisions, patterns, projects & semantic search",
+  "version": "0.15.2",
+  "description": "OpenClaw memory plugin for MemoryRelay API - 42 tools, 17 commands, V2 async, sessions, decisions, patterns, projects & semantic search",
   "type": "module",
   "main": "index.ts",
   "scripts": {

package/src/status-reporter.ts

@@ -34,10 +34,25 @@ export interface MemoryStats {
   search_count_24h?: number;
 }
 
+export type AutoCaptureTier = "off" | "conservative" | "smart" | "aggressive";
+
+export interface AutoCaptureConfig {
+  enabled: boolean;
+  tier: AutoCaptureTier;
+  confirmFirst?: number;
+  categories?: {
+    credentials?: boolean;
+    preferences?: boolean;
+    technical?: boolean;
+    personal?: boolean;
+  };
+  blocklist?: string[];
+}
+
 export interface PluginConfig {
   agentId: string;
   autoRecall: boolean;
-  autoCapture: boolean;
+  autoCapture: AutoCaptureConfig;
   recallLimit: number;
   recallThreshold: number;
   excludeChannels: string[];
@@ -189,7 +204,10 @@ export class StatusReporter {
       ? `✓ Enabled (limit: ${report.config.recallLimit}, threshold: ${report.config.recallThreshold})`
       : "✗ Disabled";
     lines.push(`  Auto-Recall:   ${recallStatus}`);
-    lines.push(`  Auto-Capture:  ${report.config.autoCapture ? "✓ Enabled" : "✗ Disabled"}`);
+    const captureStatus = report.config.autoCapture.enabled
+      ? `✓ Enabled (tier: ${report.config.autoCapture.tier})`
+      : "✗ Disabled";
+    lines.push(`  Auto-Capture:  ${captureStatus}`);
     if (report.config.defaultProject) {
       lines.push(`  Default Project: ${report.config.defaultProject}`);
     }

package/skills/codebase-navigation/SKILL.md

@@ -1,105 +0,0 @@
----
-name: codebase-navigation
-description: "Use when navigating the openclaw-plugin codebase for the first time, looking for where a tool is registered, understanding the monolithic index.ts structure, or adding a new tool or hook."
----
-
-# Codebase Navigation
-
-The plugin is a single monolithic `index.ts` (4839 lines) plus a few extracted modules.
-
-## index.ts File Map
-
-| Lines | Section |
-|-------|---------|
-| 1--14 | Header comments and version info |
-| 16--36 | Imports (plugin SDK, heartbeat, CLI stats, onboarding) |
-| 38--47 | Constants (`DEFAULT_API_URL`, `REQUEST_TIMEOUT_MS`, `MAX_RETRIES`) |
-| 48--121 | `DebugLogger` class (inlined) with `LogEntry`, `DebugLoggerConfig` |
-| 123--404 | `StatusReporter` class (inlined) with `ToolStatus`, `ConnectionStatus`, `MemoryStats` |
-| 406--461 | Types: `AutoCaptureConfig`, `MemoryRelayConfig`, `Memory`, `SearchResult`, `Stats` |
-| 463--648 | Utility functions: `sleep`, `isRetryableError`, `fetchWithTimeout`, auto-capture helpers, `redactSensitive`, `extractRescueContent` |
-| 650--1294 | `MemoryRelayClient` class (API client with retry logic, all endpoints) |
-| 1296--1315 | Pattern detection for auto-capture (`CAPTURE_PATTERNS`, `shouldCapture`) |
-| 1317--1562 | Plugin entry: `export default async function plugin(api)`, config resolution, client init, session cache, `touchSession` |
-| 1564--1613 | `TOOL_GROUPS` map and `isToolEnabled()` |
-| 1615--3747 | 39 tool registrations |
-| 3749--3853 | CLI commands (`memoryrelay status/stats/list/export`) |
-| 3855--4240 | 14 lifecycle hooks (`before_agent_start`, `agent_end`, `session_start`, `session_end`, `before_tool_call`, `after_tool_call`, `before_compaction`, `before_reset`, `message_received`, `message_sending`, `before_message_write`, `subagent_spawned`, `subagent_ended`, `tool_result_persist`) |
-| 4242--4274 | First-run onboarding |
-| 4276--4586 | Gateway methods (`memoryrelay.logs`, `.health`, `.metrics`, `.heartbeat`, `.onboarding`, `.stats`, `.test`) |
-| 4588--4790 | Direct commands: `/memory-status`, `/memory-stats`, `/memory-health`, `/memory-logs`, `/memory-metrics` |
-| 4792--4839 | Stale session cleanup service (`memoryrelay-session-cleanup` via `api.registerService`) |
-
-## Tool Registration Pattern
-
-Every tool follows this pattern:
-
-```typescript
-if (isToolEnabled("tool_name")) {
-  api.registerTool((ctx) => ({
-    name: "tool_name",
-    description: "...",
-    parameters: { /* JSON schema */ },
-    execute: async (_id, args) => { /* impl */ }
-  }), { name: "tool_name" });
-}
-```
-
-Tools are numbered 1--39 with comment markers (e.g., `// 1. memory_store`). Search for `// N.` to jump to a specific tool.
-
-## TOOL_GROUPS (line 1569)
-
-| Group | Count | Tools |
-|-------|-------|-------|
-| memory | 9 | `memory_store`, `memory_recall`, `memory_forget`, `memory_list`, `memory_get`, `memory_update`, `memory_batch_store`, `memory_context`, `memory_promote` |
-| entity | 4 | `entity_create`, `entity_link`, `entity_list`, `entity_graph` |
-| agent | 3 | `agent_list`, `agent_create`, `agent_get` |
-| session | 4 | `session_start`, `session_end`, `session_recall`, `session_list` |
-| decision | 4 | `decision_record`, `decision_list`, `decision_supersede`, `decision_check` |
-| pattern | 4 | `pattern_create`, `pattern_search`, `pattern_adopt`, `pattern_suggest` |
-| project | 10 | `project_register`, `project_list`, `project_info`, `project_add_relationship`, `project_dependencies`, `project_dependents`, `project_related`, `project_impact`, `project_shared_patterns`, `project_context` |
-| health | 1 | `memory_health` |
-
-The `enabledTools` config option accepts a comma-separated list of group names (or `"all"`).
-
-## Supporting Modules
-
-| File | Purpose |
-|------|---------|
-| `src/debug-logger.ts` | `DebugLogger` class (source of the inlined copy) |
-| `src/status-reporter.ts` | `StatusReporter` class (source of the inlined copy) |
-| `src/heartbeat/daily-stats.ts` | Morning/evening summaries, `calculateStats`, `formatStatsForDisplay` |
-| `src/onboarding/first-run.ts` | Onboarding wizard: `checkFirstRun`, `runSimpleOnboarding` |
-| `src/cli/stats-command.ts` | CLI `stats` command handler |
-
-## Configuration Fallback Chain
-
-```
-Plugin config (openclaw.json) -> Env vars -> Defaults
-```
-
-- `apiKey`: `cfg.apiKey` -> `MEMORYRELAY_API_KEY` (required, no default)
-- `agentId`: `cfg.agentId` -> `MEMORYRELAY_AGENT_ID` -> `api.agentName`
-- `apiUrl`: `cfg.apiUrl` -> `MEMORYRELAY_API_URL` -> `https://api.memoryrelay.net`
-
-## Key Types
-
-| Type | Location | Purpose |
-|------|----------|---------|
-| `Memory` | L442 | Core memory record (`id`, `content`, `agent_id`, `metadata`, `entities`) |
-| `SearchResult` | L453 | Vector search hit (`memory`, `score`) |
-| `Stats` | L458 | Agent statistics (`total_memories`, `last_updated`) |
-| `LogEntry` | L52 | Debug log entry (tool, method, path, duration, status) |
-| `DebugLoggerConfig` | L66 | Logger settings (enabled, verbose, maxEntries) |
-| `ConnectionStatus` | L140 | API connection state (status, endpoint, responseTime) |
-| `ToolStatus` | L127 | Per-group tool health (enabled, available, failed) |
-
-## Key Helpers
-
-| Function | Location | Purpose |
-|----------|----------|---------|
-| `redactSensitive` | L591 | Replace blocklist patterns with `[REDACTED]` |
-| `extractRescueContent` | L608 | Salvage assistant messages before compaction/reset |
-| `touchSession` | L1444 | Update `lastActivityAt` timestamp in session cache |
-| `isToolEnabled` | L1605 | Check if a tool's group is in the enabled set |
-| `shouldCapture` | L1310 | Test text against `CAPTURE_PATTERNS` for auto-capture |

package/skills/release-process/SKILL.md

@@ -1,83 +0,0 @@
----
-name: release-process
-description: "Use when bumping the plugin version, preparing a release, updating the CHANGELOG, creating a pre-release audit branch, or triggering the NPM publish workflow."
----
-
-# Release Process
-
-## Semantic Versioning (0.x series)
-
-| Bump | When | Example |
-|------|------|---------|
-| **Patch** (0.x.Y) | Bug fixes, version string updates, doc fixes | 0.12.10 → 0.12.11 |
-| **Minor** (0.X.0) | New tools, new features, new config options | 0.12.11 → 0.13.0 |
-| **Major** (X.0.0) | Breaking API changes (not used yet) | 0.13.0 → 1.0.0 |
-
-## Version Bump Locations
-
-All three files must match the same version string:
-
-| File | Field |
-|------|-------|
-| `package.json` | `"version": "X.Y.Z"` |
-| `openclaw.plugin.json` | `"version": "X.Y.Z"` and description string |
-| `index.ts` | Header comment `Version: X.Y.Z` |
-
-## CHANGELOG.md Format
-
-Follows [Keep a Changelog](https://keepachangelog.com/). Each release entry:
-
-```markdown
-## [X.Y.Z] - YYYY-MM-DD
-### Added
-- **Feature Name**: Description
-### Changed
-- Description
-### Fixed
-- **Bug Name**: Description
-```
-
-Add a comparison link at the bottom of the file:
-
-```
-[X.Y.Z]: https://github.com/memoryrelay/openclaw-plugin/compare/vPREV...vX.Y.Z
-```
-
-## Git Commit Conventions
-
-| Prefix | Use |
-|--------|-----|
-| `feat:` | New features or tools |
-| `fix:` | Bug fixes |
-| `docs:` | Documentation changes |
-| `chore:` | Maintenance, deps, cleanup |
-
-## CI/CD Workflows
-
-| File | Trigger | Purpose |
-|------|---------|---------|
-| `.github/workflows/ci.yml` | Push/PR to main | Tests on Node 20.x + 22.x matrix |
-| `.github/workflows/ci-cd.yml` | Push/PR | Full CI/CD pipeline |
-| `.github/workflows/publish.yml` | Manual dispatch | NPM publish with version verification |
-
-The publish workflow runs `npm publish --provenance --access public` and requires the `NPM_TOKEN` secret.
-
-## Pre-Release Audit Branch
-
-For doc review before release, create an audit branch:
-
-```
-docs/pre-release-audit-v{version}
-```
-
-Example: `docs/pre-release-audit-v0.12.11`. Merge to main once the audit is complete.
-
-## Release Checklist
-
-1. Update version in all 3 locations (`package.json`, `openclaw.plugin.json`, `index.ts`)
-2. Update `CHANGELOG.md` with new entry and comparison link
-3. Run `npm test` -- all tests must pass
-4. Create audit branch (`docs/pre-release-audit-v{version}`) if doc changes are needed
-5. Merge audit branch to main
-6. Trigger the `publish.yml` workflow manually from GitHub Actions
-7. Verify the published package on NPM

package/skills/testing-memoryrelay/SKILL.md

@@ -1,87 +0,0 @@
----
-name: testing-memoryrelay
-description: "Use when writing, running, or debugging tests for the MemoryRelay plugin, adding test coverage for new tools or hooks, or investigating test failures."
----
-
-# Testing MemoryRelay
-
-Test runner: **Vitest**. All tests run without a live API.
-
-## Commands
-
-| Command | Purpose |
-|---------|---------|
-| `npm test` | Run all tests once (`vitest run`) |
-| `npm run test:watch` | Watch mode (`vitest`) |
-| `npm run test:coverage` | Coverage report (`vitest run --coverage`) |
-
-## Test Files
-
-| File | Scope |
-|------|-------|
-| `index.test.ts` | Integration tests: API client, tools, hooks, retry logic, pattern detection, channel filtering, tool groups, workflow instructions |
-| `src/debug-logger.test.ts` | DebugLogger unit tests: circular buffer, filtering by tool/status, stats, formatting |
-| `src/status-reporter.test.ts` | StatusReporter unit tests: failure tracking, report building, formatting |
-
-## Mock Pattern
-
-Tests use `MockMemoryRelayClient` -- an in-memory implementation that replaces the real API client:
-
-```typescript
-import { describe, test, expect, beforeEach, vi } from "vitest";
-
-class MockMemoryRelayClient {
-  private memories: Memory[] = [];
-  private nextId = 1;
-  async store(content, metadata?) { /* push to array, return Memory */ }
-  async search(query, limit?, threshold?) { /* keyword .includes() match */ }
-  async list(limit?, offset?) { /* .slice() */ }
-  async get(id) { /* .find(), throws if missing */ }
-  async delete(id) { /* .splice(), throws if missing */ }
-  async health() { return { status: "healthy" }; }
-  async stats() { return { total_memories: this.memories.length }; }
-}
-```
-
-Instantiate fresh per test with `beforeEach(() => { client = new MockMemoryRelayClient("test_key", "test_agent"); })`.
-
-## What to Test per Tool
-
-| Area | Checks |
-|------|--------|
-| Input validation | Required params present, types correct |
-| Success path | API response formatted correctly, data stored/returned |
-| Error handling | Non-existent IDs throw, empty results return `[]` |
-| Deduplication | `deduplicate=true` prevents near-duplicate storage |
-| Session injection | `session_id` auto-applied from active session |
-| Retry logic | Network errors and 5xx retried; 4xx not retried |
-| Timeouts | 30s timeout via `AbortController` |
-
-## Testing Hooks
-
-**`before_agent_start`** -- workflow injection and auto-recall:
-
-- Verify workflow instructions are built from enabled tool groups
-- Mock `client.search()` to test auto-recall injects context
-- Test channel exclusion skips auto-recall for blocklisted channels
-
-**`agent_end`** -- auto-capture:
-
-- Test pattern detection (`shouldCapture`) with regex matching
-- Verify length bounds (20-2000 chars)
-- Confirm privacy blocklist rejects passwords, SSNs, API keys
-- Test tier logic: `off`, `conservative`, `smart`, `aggressive`
-
-## Testing Gateway Methods
-
-| Check | How |
-|-------|-----|
-| Response format | Assert returned object shape matches API contract |
-| Error surfaces | `detail` field extracted (FastAPI format), falls back to `message` |
-| HTTP method | GET with query params for search/check; POST with body for create/link |
-
-## Unit Test Patterns
-
-**DebugLogger**: Uses `vi.mock("fs")`. Test circular buffer (`maxEntries`), `getRecentLogs(n)`, `getToolLogs(name)`, `getErrorLogs()`, `getStats()`, `clear()`, `formatEntry()`.
-
-**StatusReporter**: Instantiate with real `DebugLogger`. Test `recordFailure`/`recordSuccess` toggle, `buildReport` shape, `formatReport`/`formatCompact` output, disconnected status handling.