@memoryrelay/plugin-memoryrelay-ai 0.3.0 → 0.4.0

package/README.md

@@ -13,6 +13,7 @@ Long-term memory plugin for OpenClaw agents using [MemoryRelay API](https://api.
 - 🤖 **Multi-Agent** — Isolated memory namespaces per agent
 - 🛠️ **CLI Tools** — Manage memories via `openclaw memoryrelay` commands
 - 🔌 **Tool Integration** — Three memory tools for AI agents
+- ✅ **Status Reporting** — Real-time availability and connection status in `openclaw status`
 
 ## Installation
 
@@ -64,11 +65,21 @@ openclaw gateway restart
 
 ```bash
 openclaw status
-# Should show: Memory | enabled (plugin plugin-memoryrelay-ai)
+# When API is reachable (example output):
+# Memory | enabled (plugin plugin-memoryrelay-ai) · available
+#
+# When API is down (example output):
+# Memory | enabled (plugin plugin-memoryrelay-ai) · unavailable
+# (Note: Exact format depends on your OpenClaw version)
+
+# Check plugin-specific status
+openclaw memoryrelay status
+# Shows: API connection, agent ID, endpoint
 
 # Check logs
 journalctl -u openclaw-gateway --since '1 minute ago' | grep memory-memoryrelay
-# Should show: "connected to api.memoryrelay.net"
+# Example output: "memory-memoryrelay: connected to https://api.memoryrelay.net"
+# (URL will vary if you configured a custom apiUrl)
 ```
 
 Get your API key from [memoryrelay.ai](https://memoryrelay.ai).
@@ -197,6 +208,30 @@ memory_forget({ query: "outdated preference" })
 
 **Returns:** Success confirmation
 
+### Status Monitoring
+
+The plugin reports its availability and connection status to OpenClaw:
+
+```bash
+# Check overall status (shows plugin availability)
+openclaw status
+# Shows: Memory | enabled (plugin plugin-memoryrelay-ai) · available
+
+# Check plugin-specific status (MemoryRelay custom command)
+openclaw memoryrelay status
+# Shows: API connection, agent ID, endpoint
+```
+
+**Status Information Reported:**
+- **Available/Unavailable** — Whether the plugin can be used
+- **Connected** — Whether the MemoryRelay API is reachable
+- **Memory Count** — Total memories stored for this agent (if stats endpoint exists)
+- **Vector Enabled** — Semantic search capability (always true)
+- **Endpoint** — API URL being used
+- **Agent ID** — Current agent identifier
+
+When the API is unreachable, status shows "unavailable" with error details.
+
 ### CLI Commands
 
 ```bash
@@ -441,6 +476,29 @@ MIT © 2026 MemoryRelay
 
 ## Changelog
 
+### v0.4.0 (2026-02-13) - Status Reporting
+
+**New Features:**
+- ✅ Status reporting via `memory.status` gateway RPC method
+- ✅ Plugin now reports "available" in `openclaw status` when API is reachable
+- ✅ Memory count reporting (via optional `/v1/stats` API endpoint)
+- ✅ Vector availability reporting for semantic search
+- ✅ Detailed status information: connected state, endpoint, agent ID, memory count
+
+**Fixes:**
+- ✅ Plugin no longer shows as "unavailable" in `openclaw status` when functional
+- ✅ Status accurately reflects API connection state
+
+**Technical Improvements:**
+- ✅ Extracted constants for maintainability (`DEFAULT_API_URL`, `VALID_HEALTH_STATUSES`)
+- ✅ Case-insensitive health status validation
+- ✅ Proper type safety with nullish coalescing operators
+- ✅ Graceful handling of missing stats endpoint (backwards compatible)
+
+**Backwards Compatibility:**
+- Fully compatible with older OpenClaw versions (uses optional chaining)
+- Gracefully handles missing `/v1/stats` endpoint
+
 ### v0.3.0 (2026-02-13) - Better Installation UX
 
 **Improved Installation Experience:**

package/index.ts

@@ -10,6 +10,13 @@
 
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 
+// ============================================================================
+// Constants
+// ============================================================================
+
+const DEFAULT_API_URL = "https://api.memoryrelay.net";
+const VALID_HEALTH_STATUSES = ["ok", "healthy", "up"];
+
 // ============================================================================
 // Types
 // ============================================================================
@@ -48,7 +55,7 @@ class MemoryRelayClient {
   constructor(
     private readonly apiKey: string,
     private readonly agentId: string,
-    private readonly apiUrl: string = "https://api.memoryrelay.net",
+    private readonly apiUrl: string = DEFAULT_API_URL,
   ) {}
 
   private async request<T>(
@@ -124,6 +131,17 @@ class MemoryRelayClient {
   async health(): Promise<{ status: string }> {
     return this.request<{ status: string }>("GET", "/v1/health");
   }
+
+  async stats(): Promise<{ total_memories: number; last_updated?: string }> {
+    const response = await this.request<{ data: { total_memories: number; last_updated?: string } }>(
+      "GET",
+      `/v1/stats?agent_id=${encodeURIComponent(this.agentId)}`,
+    );
+    return {
+      total_memories: response.data?.total_memories ?? 0,
+      last_updated: response.data?.last_updated,
+    };
+  }
 }
 
 // ============================================================================
@@ -176,21 +194,70 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
   
   api.logger.info(`memory-memoryrelay: using agentId: ${agentId}`);
 
-  const client = new MemoryRelayClient(
-    apiKey,
-    agentId,
-    cfg?.apiUrl || "https://api.memoryrelay.net",
-  );
+  const apiUrl = cfg?.apiUrl || DEFAULT_API_URL;
+  const client = new MemoryRelayClient(apiKey, agentId, apiUrl);
 
   // Verify connection on startup
   try {
     await client.health();
-    api.logger.info(`memory-memoryrelay: connected to ${cfg.apiUrl || "api.memoryrelay.net"}`);
+    api.logger.info(`memory-memoryrelay: connected to ${apiUrl}`);
   } catch (err) {
     api.logger.error(`memory-memoryrelay: health check failed: ${String(err)}`);
     return;
   }
 
+  // ========================================================================
+  // Status Reporting (for openclaw status command)
+  // ========================================================================
+
+  // Register gateway RPC method for status probing
+  // This allows OpenClaw's status command to query plugin availability
+  api.registerGatewayMethod?.("memory.status", async ({ respond }) => {
+    try {
+      const health = await client.health();
+      let memoryCount = 0;
+      
+      // Try to get stats if the endpoint exists
+      try {
+        const stats = await client.stats();
+        memoryCount = stats.total_memories;
+      } catch (statsErr) {
+        // Stats endpoint may not exist yet - that's okay, just report 0
+        api.logger.debug?.(`memory-memoryrelay: stats endpoint unavailable: ${String(statsErr)}`);
+      }
+      
+      // Consider API connected if health check succeeds with any recognized status
+      const healthStatus = String(health.status).toLowerCase();
+      const isConnected = VALID_HEALTH_STATUSES.includes(healthStatus);
+      
+      respond(true, {
+        available: true,
+        connected: isConnected,
+        endpoint: apiUrl,
+        memoryCount: memoryCount,
+        agentId: agentId,
+        // OpenClaw checks status.vector.available for memory plugins
+        vector: {
+          available: true,
+          enabled: true,
+        },
+      });
+    } catch (err) {
+      respond(true, {
+        available: false,
+        connected: false,
+        error: String(err),
+        endpoint: apiUrl,
+        agentId: agentId,
+        // Report vector as unavailable when API fails
+        vector: {
+          available: false,
+          enabled: true,
+        },
+      });
+    }
+  });
+
   // ========================================================================
   // Tools (using JSON Schema directly)
   // ========================================================================
@@ -403,8 +470,8 @@ export default async function plugin(api: OpenClawPluginApi): Promise<void> {
           try {
             const health = await client.health();
             console.log(`Status: ${health.status}`);
-            console.log(`Agent ID: ${cfg.agentId}`);
-            console.log(`API: ${cfg.apiUrl || "https://api.memoryrelay.net"}`);
+            console.log(`Agent ID: ${agentId}`);
+            console.log(`API: ${apiUrl}`);
           } catch (err) {
             console.error(`Connection failed: ${String(err)}`);
           }

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "kind": "memory",
   "name": "MemoryRelay AI",
   "description": "AI memory service using MemoryRelay API (api.memoryrelay.net)",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "uiHints": {
     "apiKey": {
       "label": "MemoryRelay API Key",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memoryrelay/plugin-memoryrelay-ai",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "OpenClaw memory plugin for MemoryRelay API - long-term memory with semantic search",
   "type": "module",
   "main": "index.ts",