@t0ken.ai/memoryx-openclaw-plugin 2.2.59 → 2.2.61

package/README.md

@@ -168,9 +168,21 @@ Memories are categorized by the server:
 - Minimum 2 characters per message
 - Short messages like "ok", "thanks" are skipped
 
-## How the proxy works (no virtual model)
+## How the proxy works
 
-The plugin does **not** add a virtual model. It redirects your existing provider's request URL to a local Sidecar (port 3335). You keep using your configured model (e.g. `zai/glm-5`); the request is sent to the Sidecar with a header identifying the real provider, then the Sidecar forwards to the MemoryX server with your credentials. No need to add `memoryx-proxy` to config or auth.
+**Current behavior:** The plugin starts a local Sidecar (port 3335) and tries to redirect your existing provider’s baseUrl to it (so you keep using e.g. `zai/glm-5`). Whether that works depends on how OpenClaw resolves the model (config vs. registry). See `OPENCLAW-BASEURL-FLOW.md` for details.
+
+**SlimClaw-style (recommended, no file changes):** Like SlimClaw, you can use a **virtual provider** so all traffic goes through the Sidecar without the plugin mutating config or files. Add this to `~/.openclaw/openclaw.json` under `models.providers`:
+
+```json
+"memoryx-proxy": {
+  "baseUrl": "http://localhost:3335/v1",
+  "apiKey": "placeholder",
+  "models": [{ "id": "auto" }]
+}
+```
+
+Then add an auth profile for `memoryx-proxy` (e.g. in `~/.openclaw/agents/main/agent/auth-profiles.json` or global auth) with any placeholder key. In the UI, choose model **memoryx-proxy/auto**. Requests will go to the Sidecar, which forwards to the MemoryX server with your real provider credentials (you configure which provider/model to use via the plugin/Sidecar logic). The plugin does not modify your config or `models.json`; it only runs the Sidecar.
 
 ## License
 

package/dist/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const PLUGIN_VERSION = "2.2.61";
+export declare const DEFAULT_API_BASE = "https://t0ken.ai/api";
+export declare const PLUGIN_DIR: string;
+/** 真实上游 baseUrl 缓存文件：重启后若配置已被改成 localhost，从此文件恢复各厂商真实地址。 */
+export declare const REAL_UPSTREAM_BASEURL_CACHE_FILE: string;
+/** Sidecar HTTP port — fixed so openclaw.json can point to localhost:37169. Do not use a range. */
+export declare const SIDECAR_PORT = 37169;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,eAAO,MAAM,UAAU,QAAgF,CAAC;AAExG,4DAA4D;AAC5D,eAAO,MAAM,gCAAgC,QAAsD,CAAC;AAEpG,mGAAmG;AACnG,eAAO,MAAM,YAAY,QAAQ,CAAC"}

package/dist/constants.js

@@ -0,0 +1,13 @@
+/**
+ * Plugin constants. PLUGIN_VERSION is synced from package.json by prebuild script.
+ */
+import * as path from "path";
+import * as os from "os";
+// Plugin version - synced from package.json by prebuild script
+export const PLUGIN_VERSION = "2.2.61";
+export const DEFAULT_API_BASE = "https://t0ken.ai/api";
+export const PLUGIN_DIR = path.join(os.homedir(), ".openclaw", "extensions", "memoryx-openclaw-plugin");
+/** 真实上游 baseUrl 缓存文件：重启后若配置已被改成 localhost，从此文件恢复各厂商真实地址。 */
+export const REAL_UPSTREAM_BASEURL_CACHE_FILE = path.join(PLUGIN_DIR, "real-upstream-baseurl.json");
+/** Sidecar HTTP port — fixed so openclaw.json can point to localhost:37169. Do not use a range. */
+export const SIDECAR_PORT = 37169;

package/dist/hooks.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OpenClaw hooks: message_received, llm_input, llm_output, before_agent_start, session_end.
+ */
+import type { MemoryXPlugin } from "./plugin-core.js";
+export declare function registerHooks(api: any, plugin: MemoryXPlugin, wrapProvidersWithProxy: () => void, applySidecarRedirect: (opts?: {
+    quiet?: boolean;
+}) => void): void;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,wBAAgB,aAAa,CACzB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,aAAa,EACrB,sBAAsB,EAAE,MAAM,IAAI,EAClC,oBAAoB,EAAE,CAAC,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,GAC3D,IAAI,CAyCN"}

package/dist/hooks.js

@@ -0,0 +1,39 @@
+export function registerHooks(api, plugin, wrapProvidersWithProxy, applySidecarRedirect) {
+    let useVirtualProviderInLastRun = false;
+    api.on("message_received", async (event) => {
+        const { content } = event;
+        if (content && plugin)
+            await plugin.onMessage("user", content);
+    });
+    api.on("llm_input", (_event) => {
+        useVirtualProviderInLastRun = _event?.provider === "memoryx-proxy";
+    });
+    api.on("llm_output", async (event) => {
+        const { assistantTexts, provider } = event;
+        if (assistantTexts && Array.isArray(assistantTexts) && plugin && provider !== "memoryx-proxy") {
+            const fullContent = assistantTexts.join("\n");
+            if (fullContent && fullContent.length >= 2)
+                await plugin.onMessage("assistant", fullContent);
+        }
+    });
+    api.on("before_agent_start", async (event) => {
+        wrapProvidersWithProxy();
+        applySidecarRedirect({ quiet: true });
+        const { prompt } = event;
+        if (!prompt || prompt.length < 2 || !plugin)
+            return;
+        try {
+            await plugin.startTimersIfNeeded();
+            await plugin.onMessage("user", prompt);
+            // 记忆注入改由服务端 llm_proxy 在转发前注入到请求体（system/消息），不在此处用 prependContext，
+            // 避免 OpenClaw 把 prependContext 当成单独用户消息写入历史（role=user 的 MemoryX Context 条）。
+        }
+        catch (error) {
+            api.logger.warn(`[MemoryX] before_agent_start failed: ${error}`);
+        }
+    });
+    api.on("session_end", async () => {
+        if (plugin)
+            await plugin.endConversation();
+    });
+}

package/dist/index.d.ts

@@ -3,86 +3,18 @@
  *
  * ⚠️ CRITICAL: DO NOT execute any synchronous I/O in register() function!
  *
- * OpenClaw calls register() synchronously (see openclaw/src/plugins/loader.ts):
- *   const result = register(api);
- *   if (result && typeof result.then === "function") {
- *     // async registration is ignored
- *   }
- *
- * Any sync I/O (fs.existsSync, fs.mkdirSync, fs.readFileSync, etc.)
- * will BLOCK the Node.js event loop and cause gateway restart to hang.
- *
- * SOLUTION:
- * 1. register() must return immediately without any I/O
- * 2. All initialization (DB, config loading, etc.) must be lazy-loaded
- * 3. SDK uses sql.js (async) internally - no blocking issues
- * 4. Use setImmediate() for deferred operations
+ * OpenClaw calls register() synchronously (see openclaw/src/plugins/loader.ts).
+ * Any sync I/O will BLOCK the Node.js event loop and cause gateway restart to hang.
+ * - register() must return immediately without any I/O
+ * - All initialization (DB, config loading, etc.) must be lazy-loaded
+ * - Use setImmediate() for deferred operations
  *
  * This version uses @t0ken.ai/memoryx-sdk with conversation preset:
  * - maxTokens: 30000 (flush when reaching token limit)
  * - intervalMs: 300000 (flush after 5 minutes idle)
  */
-interface PluginConfig {
-    apiBaseUrl?: string;
-    /** 启用调试模式，拦截所有请求并记录到 plugin.log */
-    debugProvider?: boolean;
-}
-interface RecallResult {
-    memories: Array<{
-        id: string;
-        content: string;
-        category: string;
-        score: number;
-    }>;
-    relatedMemories: Array<{
-        id: string;
-        content: string;
-        category: string;
-        score: number;
-    }>;
-    isLimited: boolean;
-    remainingQuota: number;
-    upgradeHint?: string;
-}
-declare class MemoryXPlugin {
-    private pluginConfig;
-    private initialized;
-    private timersStarted;
-    constructor(pluginConfig?: PluginConfig);
-    init(): Promise<void>;
-    startTimersIfNeeded(): Promise<void>;
-    onMessage(role: string, content: string): Promise<boolean>;
-    recall(query: string, limit?: number): Promise<RecallResult>;
-    endConversation(): Promise<void>;
-    forget(memoryId: string): Promise<boolean>;
-    store(content: string): Promise<{
-        success: boolean;
-        task_id?: string;
-    }>;
-    list(limit?: number): Promise<any[]>;
-    getAccountInfo(): Promise<{
-        apiKey: string | null;
-        agentId: string | null;
-        agentType: string | null;
-        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;
-    }>;
-}
+import type { PluginConfig } from "./types.js";
+import { MemoryXPlugin } from "./plugin-core.js";
 declare const _default: {
     id: string;
     name: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAuDH,UAAU,YAAY;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;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;AAqDD,cAAM,aAAa;IACf,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,aAAa,CAAkB;gBAE3B,YAAY,CAAC,EAAE,YAAY;IAIjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAad,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC,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,wBA65BE;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAU,MAAM,kBAAkB,CAAC;;;;;;kBAyBvC,GAAG,iBAAiB,YAAY,GAAG,IAAI;;AARzD,wBAkGE;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}