@remnic/plugin-openclaw 1.0.19 → 1.0.21

package/README.md

@@ -170,7 +170,8 @@ Reset handling is configurable:
       "openclaw-remnic": {
         "config": {
           "flushOnResetEnabled": true,
-          "beforeResetTimeoutMs": 2000
+          "beforeResetTimeoutMs": 2000,
+          "initGateTimeoutMs": 30000
         }
       }
     }
@@ -182,6 +183,11 @@ The reset path clears per-session prompt caches and workspace override state.
 If `flushOnResetEnabled` is true, Remnic also attempts a bounded extraction
 flush before the reset completes.
 
+`initGateTimeoutMs` controls Remnic's cold-start init wait during recall and is
+registered as the `before_prompt_build` hook timeout on OpenClaw versions with
+per-hook timeout support. Raise it if first-turn recall is timing out during
+slow startup; older OpenClaw versions ignore the extra hook option safely.
+
 Session-scoped recall controls are exposed through OpenClaw's command
 discovery surface:
 

package/dist/index.js

@@ -372,6 +372,12 @@ var DEFAULT_WORKSPACE_DIR = path2.join(
   ".openclaw",
   "workspace"
 );
+var DEFAULT_INIT_GATE_TIMEOUT_MS = 3e4;
+function parseBoundedIntegerMs(value, fallback, min, max) {
+  const coerced = coerceNumber(value);
+  if (coerced === void 0) return fallback;
+  return Math.min(max, Math.max(min, Math.floor(coerced)));
+}
 function coerceBooleanLike(value) {
   if (typeof value === "boolean") return value;
   if (typeof value === "number") {
@@ -1217,6 +1223,12 @@ function parseConfig(raw) {
     // Compaction reset (opt-in, default: false)
     compactionResetEnabled: cfg.compactionResetEnabled === true,
     beforeResetTimeoutMs: typeof cfg.beforeResetTimeoutMs === "number" ? Math.min(3e4, Math.max(100, Math.floor(cfg.beforeResetTimeoutMs))) : 2e3,
+    initGateTimeoutMs: parseBoundedIntegerMs(
+      cfg.initGateTimeoutMs,
+      DEFAULT_INIT_GATE_TIMEOUT_MS,
+      1e3,
+      12e4
+    ),
     flushOnResetEnabled: cfg.flushOnResetEnabled !== false,
     commandsListEnabled: cfg.commandsListEnabled !== false,
     openclawToolsEnabled: cfg.openclawToolsEnabled !== false,
@@ -35251,7 +35263,10 @@ ${evidenceText}`
         await Promise.race([
           this.initPromise.catch(() => void 0),
           new Promise((resolve2) => {
-            initGateTimeoutHandle = setTimeout(resolve2, 15e3);
+            initGateTimeoutHandle = setTimeout(
+              resolve2,
+              this.config.initGateTimeoutMs
+            );
           })
         ]);
       } finally {
@@ -35886,13 +35901,12 @@ ${r.snippet.trim()}
     let initGateTimeoutHandle = null;
     let onInitGateAbort = null;
     if (this.initPromise) {
-      const INIT_GATE_TIMEOUT_MS = 15e3;
       const gateResult = await Promise.race([
         this.initPromise.then(() => "ok"),
         new Promise((resolve2) => {
           initGateTimeoutHandle = setTimeout(
             () => resolve2("timeout"),
-            INIT_GATE_TIMEOUT_MS
+            this.config.initGateTimeoutMs
           );
         }),
         abortController.signal.aborted ? Promise.resolve("aborted") : new Promise((resolve2) => {
@@ -73710,7 +73724,8 @@ Keep the reflection grounded in the evidence below.
                 return Object.keys(gatewayResult).length > 0 ? gatewayResult : void 0;
               }
               return result;
-            }
+            },
+            { timeoutMs: cfg.initGateTimeoutMs }
           );
         } else {
           api.on(
@@ -73747,7 +73762,8 @@ Keep the reflection grounded in the evidence below.
               return Object.keys(gatewayResult).length > 0 ? gatewayResult : void 0;
             }
             return result;
-          }
+          },
+          { timeoutMs: cfg.initGateTimeoutMs }
         );
         const memoryBuildFn = (params) => {
           const key = params?.sessionKey ?? "default";

package/openclaw.plugin.json

@@ -1,9 +1,23 @@
 {
   "id": "openclaw-remnic",
   "name": "Remnic OpenClaw Plugin",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "kind": "memory",
   "description": "Local semantic memory for OpenClaw. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
+  "setup": {
+    "providers": [
+      {
+        "id": "openai",
+        "authMethods": [
+          "api-key"
+        ],
+        "envVars": [
+          "OPENAI_API_KEY"
+        ]
+      }
+    ],
+    "requiresRuntime": false
+  },
   "providerAuthEnvVars": {
     "openai": [
       "OPENAI_API_KEY"
@@ -670,6 +684,13 @@
         "default": 2000,
         "description": "Maximum time to wait for a reset-triggered flush before returning control to OpenClaw."
       },
+      "initGateTimeoutMs": {
+        "type": "integer",
+        "minimum": 1000,
+        "maximum": 120000,
+        "default": 30000,
+        "description": "Maximum time Remnic waits for cold-start initialization during recall; also registered as the OpenClaw before_prompt_build hook timeout on SDKs that support per-hook options."
+      },
       "flushOnResetEnabled": {
         "type": "boolean",
         "default": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/plugin-openclaw",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "OpenClaw adapter for Remnic memory — thin wrapper delegating to @remnic/core",
   "type": "module",
   "main": "dist/index.js",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "openai": "^6.0.0",
-    "@remnic/core": "^1.1.7"
+    "@remnic/core": "^1.1.8"
   },
   "peerDependencies": {
     "openclaw": ">=2026.4.8"