@t0ken.ai/memoryx-openclaw-plugin 2.2.11 → 2.2.13

package/dist/index.d.ts

@@ -63,6 +63,21 @@ declare class MemoryXPlugin {
         initialized: boolean;
         quota?: any;
     }>;
+    getQueueStatus(): Promise<{
+        success: boolean;
+        data?: {
+            agent_id: string;
+            tier: string;
+            queue_name: string;
+            queue_length: number;
+            memory_free_queue: number;
+            memory_pro_queue: number;
+            estimated_wait_time: string;
+            status: string;
+            message: string;
+        };
+        error?: string;
+    }>;
 }
 declare const _default: {
     id: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA4CH,UAAU,YAAY;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,YAAY;IAClB,QAAQ,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,eAAe,EAAE,KAAK,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AA4CD,cAAM,aAAa;IACf,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,WAAW,CAAkB;gBAEzB,YAAY,CAAC,EAAE,YAAY;IAIjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAad,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA6B1D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IA6B/D,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAYhC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc1C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAcvE,IAAI,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAiBxC,cAAc,IAAI,OAAO,CAAC;QACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,WAAW,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;CAuBL;;;;;;kBAUiB,GAAG,iBAAiB,YAAY,GAAG,IAAI;;AANzD,wBAoZE;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA4CH,UAAU,YAAY;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,YAAY;IAClB,QAAQ,EAAE,KAAK,CAAC;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,eAAe,EAAE,KAAK,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AA4CD,cAAM,aAAa;IACf,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,WAAW,CAAkB;gBAEzB,YAAY,CAAC,EAAE,YAAY;IAIjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAad,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA6B1D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAyC/D,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAYhC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc1C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAcvE,IAAI,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAiBxC,cAAc,IAAI,OAAO,CAAC;QACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,WAAW,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,GAAG,CAAC;KACf,CAAC;IAwBW,cAAc,IAAI,OAAO,CAAC;QACnC,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE;YACH,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,EAAE,MAAM,CAAC;YACnB,YAAY,EAAE,MAAM,CAAC;YACrB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,gBAAgB,EAAE,MAAM,CAAC;YACzB,mBAAmB,EAAE,MAAM,CAAC;YAC5B,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CAcL;;;;;;kBAUiB,GAAG,iBAAiB,YAAY,GAAG,IAAI;;AANzD,wBAoeE;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -143,6 +143,15 @@ class MemoryXPlugin {
         try {
             const sdk = await getSDK(this.pluginConfig);
             const result = await sdk.search(query, limit);
+            // Check if quota is limited (search_count >= search_limit for free tier)
+            const isLimited = result.is_limited ??
+                (result.search_count !== undefined &&
+                    result.search_limit !== undefined &&
+                    result.search_count >= result.search_limit);
+            // Build upgrade hint if limited
+            const upgradeHint = isLimited
+                ? `Search quota exceeded (${result.search_count}/${result.search_limit}). Upgrade to Pro for unlimited searches.`
+                : undefined;
             return {
                 memories: (result.data || []).map((m) => ({
                     id: m.id,
@@ -156,8 +165,9 @@ class MemoryXPlugin {
                     category: m.category || "other",
                     score: m.score || 0
                 })),
-                isLimited: false,
-                remainingQuota: result.remaining_quota ?? -1
+                isLimited,
+                remainingQuota: result.remaining_quota ?? -1,
+                upgradeHint
             };
         }
         catch (e) {
@@ -242,6 +252,20 @@ class MemoryXPlugin {
             };
         }
     }
+    async getQueueStatus() {
+        await this.init();
+        try {
+            const sdk = await getSDK(this.pluginConfig);
+            return await sdk.getQueueStatus();
+        }
+        catch (e) {
+            log(`GetQueueStatus failed: ${e}`);
+            return {
+                success: false,
+                error: String(e)
+            };
+        }
+    }
 }
 let plugin;
 export default {
@@ -532,18 +556,86 @@ export default {
                 }
             }
         }, { name: "memoryx_account_info" });
+        api.registerTool({
+            name: "memoryx_queue_status",
+            label: "MemoryX Queue Status",
+            description: "获取 Celery 队列状态，显示当前积压任务数量和预计等待时间。用于诊断记忆处理延迟问题。当用户问为什么记忆还没处理、记忆处理状态、队列状态时使用。",
+            parameters: {
+                type: "object",
+                properties: {}
+            },
+            async execute(_toolCallId, params) {
+                if (!plugin) {
+                    return {
+                        content: [{ type: "text", text: "MemoryX plugin not initialized." }],
+                        details: { error: "not_initialized" }
+                    };
+                }
+                try {
+                    const result = await plugin.getQueueStatus();
+                    if (!result.success) {
+                        return {
+                            content: [{ type: "text", text: `获取队列状态失败: ${result.error || '未知错误'}` }],
+                            details: { error: result.error }
+                        };
+                    }
+                    const data = result.data;
+                    const statusEmoji = {
+                        "normal": "✅",
+                        "backlogged": "⚠️",
+                        "severely_backlogged": "🔴"
+                    }[data.status] || "❓";
+                    const lines = [
+                        `${statusEmoji} MemoryX 队列状态：`,
+                        `队列名称: ${data.queue_name}`,
+                        `当前层级: ${data.tier}`,
+                        `积压任务: ${data.queue_length} 个`,
+                        `Free 队列: ${data.memory_free_queue} 个`,
+                        `Pro 队列: ${data.memory_pro_queue} 个`,
+                        `预计等待: ${data.estimated_wait_time}`,
+                        `状态: ${data.message}`
+                    ];
+                    return {
+                        content: [{ type: "text", text: lines.join("\n") }],
+                        details: {
+                            queue_name: data.queue_name,
+                            queue_length: data.queue_length,
+                            status: data.status,
+                            estimated_wait_time: data.estimated_wait_time
+                        }
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [{ type: "text", text: `获取队列状态失败: ${error.message}` }],
+                        details: { error: error.message }
+                    };
+                }
+            }
+        }, { name: "memoryx_queue_status" });
+        // User message capture via message_received hook
+        // Event structure: { from: string, content: string, timestamp?: number }
         api.on("message_received", async (event, ctx) => {
             const { content } = event;
             if (content && plugin) {
                 await plugin.onMessage("user", content);
             }
         });
-        api.on("assistant_response", async (event, ctx) => {
-            const { content } = event;
-            if (content && plugin) {
-                await plugin.onMessage("assistant", content);
+        // Assistant response capture via llm_output hook
+        // Event structure: { assistantTexts: string[], lastAssistant?: unknown, usage?: {...} }
+        api.on("llm_output", async (event, ctx) => {
+            const { assistantTexts } = event;
+            if (assistantTexts && Array.isArray(assistantTexts) && plugin) {
+                // Join all assistant text segments
+                const fullContent = assistantTexts.join("\n");
+                if (fullContent && fullContent.length >= 2) {
+                    await plugin.onMessage("assistant", fullContent);
+                }
             }
         });
+        // Auto-inject memories via prependContext
+        // Note: OpenClaw's systemPrompt field is extracted but NEVER USED (bug in attempt.ts:918-928)
+        // We use prependContext which works, but the context will be visible in the user's prompt
         api.on("before_agent_start", async (event, ctx) => {
             const { prompt } = event;
             if (!prompt || prompt.length < 2 || !plugin)
@@ -551,34 +643,37 @@ export default {
             try {
                 const result = await plugin.recall(prompt, 5);
                 if (result.isLimited) {
+                    // Don't inject upgrade hints into prompt - just log
                     api.logger.warn(`[MemoryX] ${result.upgradeHint}`);
-                    return {
-                        systemPrompt: `[MemoryX] ${result.upgradeHint}`
-                    };
+                    return;
                 }
                 if (result.memories.length === 0 && result.relatedMemories.length === 0)
                     return;
-                // 使用 systemPrompt 而不是 prependContext
-                // systemPrompt 不会显示在用户聊天内容中
-                let context = "[MemoryX] Relevant memories from past conversations:\n";
+                // Build a concise memory context
+                // Format: [Memory Context]\n- memory 1\n- memory 2
+                const lines = ["[Memory Context]"];
                 if (result.memories.length > 0) {
-                    context += result.memories.map(m => `- ${m.content}`).join("\n");
+                    lines.push(...result.memories.map(m => `- ${m.content}`));
                 }
                 if (result.relatedMemories.length > 0) {
                     if (result.memories.length > 0)
-                        context += "\n";
-                    context += result.relatedMemories.map(m => `- ${m.content}`).join("\n");
+                        lines.push("");
+                    lines.push("[Related]");
+                    lines.push(...result.relatedMemories.map(m => `- ${m.content}`));
                 }
-                api.logger.info(`[MemoryX] Injected ${result.memories.length} direct + ${result.relatedMemories.length} related memories into system prompt`);
+                const context = lines.join("\n");
+                api.logger.info(`[MemoryX] Injected ${result.memories.length} direct + ${result.relatedMemories.length} related memories`);
                 return {
-                    systemPrompt: context
+                    prependContext: context
                 };
             }
             catch (error) {
                 api.logger.warn(`[MemoryX] Recall failed: ${error}`);
             }
         });
-        api.on("conversation_end", async (event, ctx) => {
+        // Session end hook - flush memories when session ends
+        // Event structure: { sessionId: string, messageCount: number, durationMs?: number }
+        api.on("session_end", async (event, ctx) => {
             if (plugin) {
                 await plugin.endConversation();
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t0ken.ai/memoryx-openclaw-plugin",
-  "version": "2.2.11",
+  "version": "2.2.13",
   "description": "MemoryX real-time memory capture and recall plugin for OpenClaw (powered by @t0ken.ai/memoryx-sdk)",
   "type": "module",
   "author": "MemoryX Team",
@@ -35,6 +35,6 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "@t0ken.ai/memoryx-sdk": "^1.4.1"
+    "@t0ken.ai/memoryx-sdk": "^1.4.3"
   }
 }