@remnic/plugin-openclaw 9.3.672 → 9.3.673

package/README.md

@@ -124,7 +124,7 @@ This plugin hooks into the OpenClaw gateway lifecycle:
 - **`session_start`** / **`session_end`** -- session lifecycle tracking
 - **`before_tool_call`** / **`after_tool_call`** -- tool usage observation for analytics
 - **`llm_output`** -- LLM token usage tracking
-- **`subagent_spawning`** / **`subagent_ended`** -- subagent lifecycle observation
+- **`subagent_spawned`** / **`subagent_ended`** -- subagent lifecycle observation (replaced the deprecated `subagent_spawning` hook in issue #1550; core handles thread-bound subagent bindings)
 - **Tools** -- registers `memory_search`, `memory_get`, `memory_stats`, and other agent tools
 - **Commands** -- provides CLI commands for memory management
 
@@ -441,7 +441,7 @@ and can optionally persist JSONL recall transcripts under
 |---------|--------|-------|
 | `before_tool_call` / `after_tool_call` | Supported | 2026.3.22 |
 | `llm_output` (token tracking) | Supported | 2026.3.22 |
-| `subagent_spawning` / `subagent_ended` | Supported | 2026.3.22 |
+| `subagent_spawned` / `subagent_ended` | Supported (replaced `subagent_spawning`) | 2026.3.22 |
 
 ### Dreaming
 

package/dist/index.js

@@ -5364,6 +5364,7 @@ function hasEnabledLiveConnectorConfig(config) {
 var ENGRAM_MIGRATION_PROMISE = "__openclawEngramMigrationPromise";
 var CLI_REGISTERED_GUARD = "__openclawEngramCliRegistered";
 var SESSION_COMMANDS_REGISTERED_GUARD = "__openclawEngramSessionCommandsRegistered";
+var ACTIVE_RECALL_OVERLAP_WARNED = "__openclawEngramActiveRecallOverlapWarned";
 var CLI_ACTIVE_SERVICE_COUNT = "__openclawEngramCliActiveServiceCount";
 var SECRET_REF_RESOLVER_TEST_KEY = "__openclawEngramSecretRefResolverForTest";
 var NODE_FS_MODULE_ID = ["node", "fs"].join(":");
@@ -5656,7 +5657,11 @@ function loadPluginEntryFromFile(pluginId) {
   }
 }
 function loadPluginConfigFromFile(pluginId) {
-  return loadPluginEntryFromFile(pluginId)?.config;
+  const entry = loadPluginEntryFromFile(pluginId);
+  const cfg = entry?.config;
+  if (cfg === null || cfg === void 0) return void 0;
+  if (typeof cfg !== "object" || Array.isArray(cfg)) return void 0;
+  return cfg;
 }
 function loadRawConfigFromFile() {
   try {
@@ -6066,14 +6071,30 @@ var pluginDefinition = {
     }
     const fileConfig = loadPluginConfigFromFile(serviceId);
     const openclawFlushPlanProcessingEnabled = resolveOpenClawFlushPlanProcessingEnabledFromConfig(fileConfig, api.pluginConfig);
-    const cfg = (0, config_exports.parseConfig)({
-      ...fileConfig,
-      // File-backed fallback for runtimes that omit pluginConfig
-      ...api.pluginConfig,
-      // Runtime/plugin-supplied config must win
-      gatewayConfig: api.config
-      // Pass gateway config for fallback AI
-    });
+    const runtimeSet = /* @__PURE__ */ new Set();
+    const cfg = (0, config_exports.parseConfig)(
+      {
+        ...fileConfig,
+        // File-backed fallback for runtimes that omit pluginConfig
+        ...api.pluginConfig,
+        // Runtime/plugin-supplied config must win
+        gatewayConfig: api.config
+        // Pass gateway config for fallback AI
+      },
+      // `rawOperatorConfig` distinguishes "operator wrote this key in
+      // openclaw.json" from "OpenClaw materialized a schema default into
+      // api.pluginConfig" — the resolvers use it to keep the sticky-legacy
+      // `emitLegacyTools` default reachable on upgraded installs where no
+      // operator override exists (#1550, Cursor Bugbot PR #1593).
+      //
+      // When `fileConfig` is missing entirely (no openclaw.json on disk),
+      // pass \`{}\` rather than undefined so the resolver treats the
+      // absence the same as "file layer present but authored nothing" —
+      // i.e. fall through to env / sticky-legacy instead of trusting a
+      // materialized schema default (Cursor Bugbot PR #1593 round 3).
+      fileConfig ?? {},
+      runtimeSet
+    );
     cfg.providerApiKeyResolver = resolveOpenClawProviderCredential;
     cfg.runtimeAuthForModelResolver = getOpenClawRuntimeAuthForModel;
     (0, logger_exports.initLogger)(api.logger, cfg.debug);
@@ -7444,6 +7465,12 @@ Keep the reflection grounded in the evidence below.
       }
       let memoryPromptBuilder;
       if (useMemoryPromptSection && api.registerMemoryPromptSection) {
+        if (cfg.activeRecallEnabled && !globalThis[ACTIVE_RECALL_OVERLAP_WARNED]) {
+          globalThis[ACTIVE_RECALL_OVERLAP_WARNED] = true;
+          logger_exports.log.warn(
+            "activeRecallEnabled=true while memory-slot prompt injection is active (registerMemoryPromptSection). Prompt injection does NOT require active recall; this runs a second blocking retrieval per turn. Disable activeRecallEnabled unless the secondary pre-reply summary block is intentional (issue #1550)."
+          );
+        }
         api.on(
           "before_prompt_build",
           async (event, ctx) => {
@@ -8343,10 +8370,10 @@ Keep the reflection grounded in the evidence below.
           }
         );
         api.on(
-          "subagent_spawning",
+          "subagent_spawned",
           async (event, _ctx) => {
             logger_exports.log.debug(
-              `subagent_spawning: ${event.subagentId ?? "?"} purpose=${event.purpose ?? "?"}`
+              `subagent_spawned: ${event.subagentId ?? "?"} purpose=${event.purpose ?? "?"} parent=${event.parentSessionKey ?? "?"}`
             );
           }
         );

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-remnic",
   "name": "Remnic OpenClaw Plugin",
-  "version": "9.3.672",
+  "version": "9.3.673",
   "kind": "memory",
   "description": "Local semantic memory for OpenClaw with bundled Remnic core runtime. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
   "setup": {
@@ -1171,12 +1171,12 @@
       "respectBundledActiveMemoryToggle": {
         "type": "boolean",
         "default": true,
-        "description": "Honor the bundled active-memory session toggle file when resolving Remnic recall toggles."
+        "description": "Compat-only (issue #1550): honor the bundled active-memory session toggle file when resolving Remnic recall toggles. Modern OpenClaw memory-slot mode + registerMemoryPromptSection is the primary prompt-injection path; this knob only matters when explicitly chaining Remnic active recall into the bundled `active-memory` plugin."
       },
       "activeRecallEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Enable the OpenClaw active-recall context surface."
+        "description": "Compat-only (issue #1550): enables the Remnic-native active-recall pre-reply summary block. NOT required for OpenClaw prompt injection — when Remnic is the memory slot, prompt injection runs through registerMemoryPromptSection / memory capability promptBuilder. Enable only to layer a second blocking pre-reply retrieval; a startup warning is logged when both this and memory-slot prompt injection are on."
       },
       "activeRecallAgents": {
         "type": "array",
@@ -1343,7 +1343,7 @@
       "activeRecallAllowChainedActiveMemory": {
         "type": "boolean",
         "default": false,
-        "description": "Allow active recall to chain into the bundled active-memory surface."
+        "description": "Compat-only (issue #1550): allow the Remnic active-recall block to chain into the bundled active-memory surface. Redundant in modern OpenClaw memory-slot mode; only set true when intentionally layering Remnic + bundled active-memory for the same agent."
       },
       "codex": {
         "type": "object",
@@ -1602,8 +1602,8 @@
       },
       "emitLegacyTools": {
         "type": "boolean",
-        "default": true,
-        "description": "Advertise legacy engram_* / engram.* MCP tool aliases alongside the canonical remnic_* names (issue #1427). Default true for backward compatibility. Set false to halve the advertised tools/list surface (only remnic_* names); tools remain callable under both names. Also settable via REMNIC_EMIT_LEGACY_TOOLS."
+        "default": false,
+        "description": "Advertise legacy engram_* / engram.* MCP tool aliases alongside the canonical remnic_* names. Issue #1550: defaults to false on fresh installs (halving the advertised tools/list surface); when existing legacy connector entries are present on disk the default stays true so upgrades never silently break a configured legacy client. An explicit value always wins."
       },
       "citationsEnabled": {
         "type": "boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/plugin-openclaw",
-  "version": "9.3.672",
+  "version": "9.3.673",
   "description": "OpenClaw adapter for Remnic memory with bundled @remnic/core runtime",
   "type": "module",
   "main": "dist/index.js",
@@ -72,7 +72,7 @@
   "dependencies": {
     "@sinclair/typebox": "^0.34.0",
     "openai": "^6.0.0",
-    "@remnic/core": "^9.3.672"
+    "@remnic/core": "^9.3.673"
   },
   "peerDependencies": {
     "openclaw": ">=2026.4.1 || 2026.4.7-1 || 2026.4.9-beta.1 || 2026.4.11-beta.1 || 2026.4.12-beta.1 || 2026.4.14-beta.1 || 2026.4.15-beta.1 || 2026.4.15-beta.2 || 2026.4.19-beta.1 || 2026.4.19-beta.2 || 2026.4.20-beta.1 || 2026.4.20-beta.2 || 2026.4.22-beta.1 || 2026.4.23-beta.1 || 2026.4.23-beta.2 || 2026.4.23-beta.3 || 2026.4.23-beta.4 || 2026.4.23-beta.5 || 2026.4.23-beta.6 || 2026.4.24-beta.1 || 2026.4.24-beta.2 || 2026.4.24-beta.3 || 2026.4.24-beta.4 || 2026.4.24-beta.5 || 2026.4.24-beta.6 || 2026.4.25-beta.1 || 2026.4.25-beta.2 || 2026.4.25-beta.3 || 2026.4.25-beta.4 || 2026.4.25-beta.5 || 2026.4.25-beta.6 || 2026.4.25-beta.7 || 2026.4.25-beta.8 || 2026.4.25-beta.9 || 2026.4.25-beta.10 || 2026.4.25-beta.11 || 2026.4.26-beta.1 || 2026.4.27-beta.1 || 2026.4.29-beta.1 || 2026.4.29-beta.2 || 2026.4.29-beta.3 || 2026.4.29-beta.4 || 2026.4.30-beta.1 || 2026.5.2-beta.1 || 2026.5.2-beta.2 || 2026.5.2-beta.3 || 2026.5.3-beta.1 || 2026.5.3-beta.2 || 2026.5.3-beta.3 || 2026.5.3-beta.4 || 2026.5.3-1 || 2026.5.4-beta.1 || 2026.5.4-beta.2 || 2026.5.4-beta.3 || 2026.5.5-beta.1 || 2026.5.5-beta.2 || 2026.5.6-beta.1 || 2026.5.7-beta.1 || 2026.5.9-beta.1 || 2026.5.10-beta.1 || 2026.5.10-beta.2 || 2026.5.10-beta.3 || 2026.5.10-beta.4 || 2026.5.10-beta.5 || 2026.5.10-beta.6 || 2026.5.12-beta.1 || 2026.5.12-beta.2 || 2026.5.12-beta.3 || 2026.5.12-beta.4 || 2026.5.12-beta.5 || 2026.5.12-beta.6 || 2026.5.12-beta.7 || 2026.5.12-beta.8 || 2026.5.14-beta.1 || 2026.5.14-beta.2 || 2026.5.16-beta.1 || 2026.5.16-beta.2 || 2026.5.16-beta.3 || 2026.5.16-beta.4 || 2026.5.16-beta.5 || 2026.5.16-beta.6 || 2026.5.16-beta.7 || 2026.5.18-beta.1 || 2026.5.19-alpha.1 || 2026.5.19-beta.1 || 2026.5.19-beta.2 || 2026.5.20-beta.1 || 2026.5.20-beta.2 || 2026.5.21-alpha.1 || 2026.5.21-beta.1 || 2026.5.22-beta.1 || 2026.5.23-alpha.1 || 2026.5.24-alpha.1 || 2026.5.24-beta.1 || 2026.5.24-beta.2 || 2026.5.25-alpha.1 || 2026.5.25-alpha.2 || 2026.5.25-beta.1 || 2026.5.26-beta.1 || 2026.5.26-beta.2 || 2026.5.27-alpha.1 || 2026.5.27-beta.1 || 2026.5.28-alpha.1 || 2026.5.28-beta.1 || 2026.5.28-beta.2 || 2026.5.28-beta.3 || 2026.5.28-beta.4 || 2026.5.29-alpha.1 || 2026.5.30-beta.1 || 2026.5.30-beta.2 || 2026.5.31-alpha.1 || 2026.5.31-beta.1 || 2026.5.31-beta.2 || 2026.5.31-beta.3 || 2026.5.31-beta.4 || 2026.6.1-alpha.1 || 2026.6.1-alpha.2 || 2026.6.1-alpha.3 || 2026.6.1-beta.1 || 2026.6.1-beta.2 || 2026.6.1-beta.3 || 2026.6.2-alpha.1 || 2026.6.2-alpha.2 || 2026.6.2-beta.1 || 2026.6.3-alpha.1 || 2026.6.4-alpha.1 || 2026.6.5-alpha.1 || 2026.6.5-alpha.2 || 2026.6.5-beta.1 || 2026.6.5-beta.2 || 2026.6.5-beta.3 || 2026.6.5-beta.5 || 2026.6.5-beta.6 || 2026.6.6-alpha.1 || 2026.6.6-beta.2 || 2026.6.6 || 2026.6.7-beta.1 || 2026.6.8-beta.1 || 2026.6.8-beta.2 || 2026.6.9-beta.1 || 2026.6.10-beta.1 || 2026.6.10-beta.2 || 2026.6.11-beta.1"
@@ -82,7 +82,7 @@
     "acorn": "^8.16.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "@remnic/core": "^9.3.672"
+    "@remnic/core": "^9.3.673"
   },
   "license": "MIT",
   "repository": {