@lanonasis/cli 3.9.14 → 3.9.15

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog - @lanonasis/cli
 
+## [3.9.15] - 2026-04-04
+
+### 🐛 Bug Fixes
+
+- **Displayed memory ID prefixes now work across CLI memory reads and deletes**: `lanonasis memory get`, `memory update`, and `memory delete` now resolve 8+ character prefixes from the list output before calling the live API, so operators no longer need to paste full UUIDs for routine follow-up actions.
+- **Legacy memory route drift no longer breaks prefix fetches**: Memory lookups now retry against the compatibility `GET /api/v1/memory/get?id=...` and delete fallback routes only when the canonical plural endpoint returns the known `Memory ID is required` validation drift.
+- **MCP memory tools now accept both `id` and `memory_id`**: The bundled LanOnasis MCP server and remote MCP bridge now normalize legacy `memory_id` callers onto the live `id` contract, which restores OpenClaw and similar clients when they pass the older field name.
+
 ## [3.9.14] - 2026-04-03
 
 ### 🐛 Bug Fixes

package/dist/mcp/server/lanonasis-server.d.ts

@@ -46,6 +46,7 @@ export declare class LanonasisMCPServer {
     private transportFailures;
     private enableFallback;
     constructor(options?: LanonasisServerOptions);
+    private extractMemoryIdentifier;
     /**
      * Initialize the server
      */

package/dist/mcp/server/lanonasis-server.js

@@ -43,6 +43,15 @@ export class LanonasisMCPServer {
         // Setup error handling
         this.setupErrorHandling();
     }
+    extractMemoryIdentifier(args) {
+        const id = typeof args.id === 'string' ? args.id.trim() : '';
+        const legacyId = typeof args.memory_id === 'string' ? args.memory_id.trim() : '';
+        const resolved = id || legacyId;
+        if (!resolved) {
+            throw new Error('Memory ID is required');
+        }
+        return resolved;
+    }
     /**
      * Initialize the server
      */
@@ -170,12 +179,19 @@ export class LanonasisMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            id: {
+                                type: 'string',
+                                description: 'Memory ID or displayed prefix'
+                            },
                             memory_id: {
                                 type: 'string',
-                                description: 'Memory ID'
+                                description: 'Legacy alias for memory ID or displayed prefix'
                             }
                         },
-                        required: ['memory_id']
+                        anyOf: [
+                            { required: ['id'] },
+                            { required: ['memory_id'] }
+                        ]
                     }
                 },
                 {
@@ -184,9 +200,13 @@ export class LanonasisMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            id: {
+                                type: 'string',
+                                description: 'Memory ID or displayed prefix'
+                            },
                             memory_id: {
                                 type: 'string',
-                                description: 'Memory ID'
+                                description: 'Legacy alias for memory ID or displayed prefix'
                             },
                             title: {
                                 type: 'string',
@@ -202,7 +222,10 @@ export class LanonasisMCPServer {
                                 description: 'New tags (optional)'
                             }
                         },
-                        required: ['memory_id']
+                        anyOf: [
+                            { required: ['id'] },
+                            { required: ['memory_id'] }
+                        ]
                     }
                 },
                 {
@@ -211,12 +234,19 @@ export class LanonasisMCPServer {
                     inputSchema: {
                         type: 'object',
                         properties: {
+                            id: {
+                                type: 'string',
+                                description: 'Memory ID or displayed prefix'
+                            },
                             memory_id: {
                                 type: 'string',
-                                description: 'Memory ID'
+                                description: 'Legacy alias for memory ID or displayed prefix'
                             }
                         },
-                        required: ['memory_id']
+                        anyOf: [
+                            { required: ['id'] },
+                            { required: ['memory_id'] }
+                        ]
                     }
                 },
                 // Topic tools
@@ -647,11 +677,13 @@ Please choose an option (1-4):`
                     topic_id: args.topic_id
                 });
             case 'memory_get':
-                return await this.apiClient.getMemory(args.memory_id);
+                return await this.apiClient.getMemory(this.extractMemoryIdentifier(args));
             case 'memory_update':
-                return await this.apiClient.updateMemory(args.memory_id, args);
+                const memoryId = this.extractMemoryIdentifier(args);
+                const { id: _id, memory_id: _legacyId, ...updateArgs } = args;
+                return await this.apiClient.updateMemory(memoryId, updateArgs);
             case 'memory_delete':
-                return await this.apiClient.deleteMemory(args.memory_id);
+                return await this.apiClient.deleteMemory(this.extractMemoryIdentifier(args));
             // Topic operations
             case 'topic_create':
                 return await this.apiClient.createTopic(args);

package/dist/utils/api.d.ts

@@ -198,6 +198,8 @@ export declare class APIClient {
     private shouldUseLegacyMemoryRpcFallback;
     private shouldRetryViaApiGateway;
     private shouldRetryViaSupabaseMemoryFunctions;
+    private isUuid;
+    resolveMemoryId(idOrPrefix: string): Promise<string>;
     private shouldUsePostListFallback;
     private getSupabaseFunctionsBaseUrl;
     private mapMemoryApiRouteToSupabaseFunctions;

package/dist/utils/api.js

@@ -10,6 +10,7 @@ const MEMORY_TYPES = [
     'personal',
     'workflow'
 ];
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 export class APIClient {
     client;
     config;
@@ -166,6 +167,61 @@ export class APIClient {
         const hasVendorKey = this.config.hasVendorKey();
         return hasVendorKey || hasOpaqueToken || authMethod === 'oauth' || authMethod === 'oauth2';
     }
+    isUuid(value) {
+        return UUID_PATTERN.test(value);
+    }
+    async resolveMemoryId(idOrPrefix) {
+        const candidate = idOrPrefix.trim();
+        if (!candidate) {
+            throw new Error('Memory ID is required.');
+        }
+        if (this.isUuid(candidate)) {
+            return candidate;
+        }
+        if (candidate.length < 8) {
+            throw new Error('Memory ID prefix must be at least 8 characters or a full UUID.');
+        }
+        const matches = new Set();
+        const normalizedCandidate = candidate.toLowerCase();
+        const limit = 100;
+        let page = 1;
+        while (true) {
+            const result = await this.getMemories({ page, limit });
+            const memories = result.memories || result.data || [];
+            if (memories.length === 0) {
+                break;
+            }
+            for (const memory of memories) {
+                if (memory.id.toLowerCase().startsWith(normalizedCandidate)) {
+                    matches.add(memory.id);
+                }
+            }
+            const pagination = result.pagination || {
+                total: memories.length,
+                limit,
+                offset: 0,
+                has_more: false,
+            };
+            const totalPages = Number.isFinite(Number(pagination.pages))
+                ? Number(pagination.pages)
+                : Math.max(1, Math.ceil(Number(pagination.total || memories.length) / limit));
+            const hasMore = typeof pagination.has_more === 'boolean'
+                ? pagination.has_more
+                : page < totalPages;
+            if (!hasMore) {
+                break;
+            }
+            page += 1;
+        }
+        const resolvedMatches = [...matches];
+        if (resolvedMatches.length === 0) {
+            throw new Error(`Memory not found for ID/prefix: ${candidate}`);
+        }
+        if (resolvedMatches.length > 1) {
+            throw new Error(`Memory ID prefix is ambiguous: ${candidate}. Matches: ${resolvedMatches.slice(0, 5).join(', ')}`);
+        }
+        return resolvedMatches[0];
+    }
     shouldUsePostListFallback(error) {
         const status = Number(error?.response?.status || 0);
         if (status === 405)
@@ -627,13 +683,16 @@ export class APIClient {
         }
     }
     async getMemory(id) {
+        const resolvedId = await this.resolveMemoryId(id);
         try {
-            const response = await this.client.get(`/api/v1/memories/${id}`);
+            const response = await this.client.get(`/api/v1/memories/${encodeURIComponent(resolvedId)}`);
             return this.normalizeMemoryEntry(response.data);
         }
         catch (error) {
             if (this.shouldUseLegacyMemoryRpcFallback(error)) {
-                const fallback = await this.client.post('/api/v1/memory/get', { id });
+                const fallback = await this.client.get('/api/v1/memory/get', {
+                    params: { id: resolvedId }
+                });
                 const payload = fallback.data && typeof fallback.data === 'object'
                     ? fallback.data.data ?? fallback.data
                     : fallback.data;
@@ -643,14 +702,15 @@ export class APIClient {
         }
     }
     async updateMemory(id, data) {
+        const resolvedId = await this.resolveMemoryId(id);
         try {
-            const response = await this.client.put(`/api/v1/memories/${id}`, data);
+            const response = await this.client.put(`/api/v1/memories/${encodeURIComponent(resolvedId)}`, data);
             return this.normalizeMemoryEntry(response.data);
         }
         catch (error) {
             if (this.shouldUseLegacyMemoryRpcFallback(error) || error?.response?.status === 404) {
                 const fallback = await this.client.post('/api/v1/memory/update', {
-                    id,
+                    id: resolvedId,
                     ...data
                 });
                 const payload = fallback.data && typeof fallback.data === 'object'
@@ -662,12 +722,15 @@ export class APIClient {
         }
     }
     async deleteMemory(id) {
+        const resolvedId = await this.resolveMemoryId(id);
         try {
-            await this.client.delete(`/api/v1/memories/${id}`);
+            await this.client.delete(`/api/v1/memories/${encodeURIComponent(resolvedId)}`);
         }
         catch (error) {
             if (this.shouldUseLegacyMemoryRpcFallback(error) || error?.response?.status === 404) {
-                await this.client.post('/api/v1/memory/delete', { id });
+                await this.client.delete('/api/v1/memory/delete', {
+                    params: { id: resolvedId }
+                });
                 return;
             }
             throw error;

package/dist/utils/mcp-client.js

@@ -5,6 +5,13 @@ import { CLIConfig } from './config.js';
 import * as fs from 'fs';
 import { EventSource } from 'eventsource';
 import WebSocket from 'ws';
+function getMemoryToolId(args) {
+    const id = typeof args.id === 'string' ? args.id.trim() : '';
+    if (id)
+        return id;
+    const legacyId = typeof args.memory_id === 'string' ? args.memory_id.trim() : '';
+    return legacyId || undefined;
+}
 export class MCPClient {
     client = null;
     config;
@@ -838,6 +845,7 @@ export class MCPClient {
                 endpoint: '/memory/{id}',
                 transform: (args) => {
                     const data = { ...args };
+                    delete data.id;
                     delete data.memory_id;
                     return data;
                 }
@@ -861,9 +869,9 @@ export class MCPClient {
             const axios = (await import('axios')).default;
             // Handle dynamic endpoint for memory operations that need ID
             let endpoint = mapping.endpoint;
-            if (endpoint.includes('{id}') && args.memory_id) {
-                // Ensure memory_id is treated as a string for replacement
-                endpoint = endpoint.replace('{id}', String(args.memory_id));
+            const memoryId = getMemoryToolId(args);
+            if (endpoint.includes('{id}') && memoryId) {
+                endpoint = endpoint.replace('{id}', encodeURIComponent(memoryId));
             }
             const response = await axios({
                 method: mapping.method,
@@ -873,7 +881,7 @@ export class MCPClient {
                     'Content-Type': 'application/json'
                 },
                 data: mapping.transform ? mapping.transform(args) : undefined,
-                params: mapping.method === 'GET' ? args : undefined
+                params: mapping.method === 'GET' && !mapping.endpoint.includes('{id}') ? args : undefined
             });
             return response.data;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lanonasis/cli",
-  "version": "3.9.14",
+  "version": "3.9.15",
   "description": "Professional CLI for LanOnasis Memory as a Service (MaaS) with MCP support, seamless inline editing, and enterprise-grade security",
   "keywords": [
     "lanonasis",