@remnic/plugin-openclaw 1.0.21 → 1.0.22

package/dist/index.js

@@ -667,9 +667,12 @@ function parseConfig(raw) {
   } else {
     cfg = baseCfg;
   }
+  const modelSource = cfg.modelSource === "gateway" ? "gateway" : "plugin";
   let apiKey;
   if (typeof cfg.openaiApiKey === "string" && cfg.openaiApiKey.length > 0) {
     apiKey = resolveEnvVars(cfg.openaiApiKey);
+  } else if (modelSource === "gateway") {
+    apiKey = void 0;
   } else {
     apiKey = readEnvVar("OPENAI_API_KEY");
   }
@@ -1594,7 +1597,7 @@ function parseConfig(raw) {
     // Gateway config (passed from index.ts for fallback AI)
     gatewayConfig: cfg.gatewayConfig,
     // Gateway model source (v9.2) — route LLM calls through gateway agent model chain
-    modelSource: cfg.modelSource === "gateway" ? "gateway" : "plugin",
+    modelSource,
     gatewayAgentId: typeof cfg.gatewayAgentId === "string" && cfg.gatewayAgentId.length > 0 ? cfg.gatewayAgentId : "",
     fastGatewayAgentId: typeof cfg.fastGatewayAgentId === "string" && cfg.fastGatewayAgentId.length > 0 ? cfg.fastGatewayAgentId : "",
     // v3.0 namespaces (default off)
@@ -9070,6 +9073,9 @@ var NoopSearchBackend = class {
   }
   async updateCollection(_collection, _execution) {
   }
+  updatesAllCollections() {
+    return false;
+  }
   async embed() {
   }
   async embedCollection(_collection) {
@@ -11359,6 +11365,9 @@ ${stderr}`.split("\n").map((s) => s.trim()).filter((s) => s.length > 0);
       execution?.signal
     );
   }
+  updatesAllCollections() {
+    return true;
+  }
   async runUpdateForCollection(collection, options, signal) {
     if (this.available === false) {
       if (options.strict) {
@@ -23198,6 +23207,9 @@ var TURN_REFERENCE_WINDOW_RADIUS = 0;
 var LEXICAL_CUE_WINDOW_RADIUS = 1;
 var LEXICAL_CUE_SEARCH_LIMIT = 3;
 var LEXICAL_CUE_MAX_TOKENS = 400;
+var CONTENT_LABEL_SEARCH_LIMIT = 64;
+var CONTENT_LABEL_MAX_TOKENS = 2e3;
+var CONTENT_LABEL_MAX_PAIRED_WINDOWS_PER_REFERENCE = 1;
 var LATEST_STATE_CUES = /* @__PURE__ */ new Set([
   "as of",
   "currently",
@@ -23419,6 +23431,13 @@ async function collectTurnReferenceEvidence(options) {
   if (references.length === 0) {
     return;
   }
+  await collectContentLabelReferenceEvidence({
+    engine: options.engine,
+    sessionId: options.sessionId,
+    references,
+    evidenceItems: options.evidenceItems,
+    seenTurns: options.seenTurns
+  });
   const windows = /* @__PURE__ */ new Map();
   for (const reference of references) {
     for (const center of candidateTurnIndexesForReference(reference)) {
@@ -23447,6 +23466,144 @@ async function collectTurnReferenceEvidence(options) {
     );
   }
 }
+async function collectContentLabelReferenceEvidence(options) {
+  const resolved = /* @__PURE__ */ new Set();
+  for (const reference of options.references) {
+    if (reference.includeDirectTurn) {
+      continue;
+    }
+    const hits = await searchReferenceContentLabels(
+      options.engine,
+      reference.number,
+      options.sessionId
+    );
+    if (hits.length === 0) {
+      continue;
+    }
+    resolved.add(reference.number);
+    let appendedWindows = 0;
+    for (const hit of hits) {
+      if (appendedWindows >= CONTENT_LABEL_MAX_PAIRED_WINDOWS_PER_REFERENCE) {
+        break;
+      }
+      const { fromTurn, toTurn } = contentLabelEvidenceWindow(hit);
+      const expanded = await options.engine.expandContext(
+        hit.session_id,
+        fromTurn,
+        toTurn,
+        CONTENT_LABEL_MAX_TOKENS
+      );
+      if (!expandedHasPairedTrajectoryLabels(expanded, reference.number)) {
+        continue;
+      }
+      if (expanded.length === 0) {
+        appendEvidenceItem(options.evidenceItems, options.seenTurns, {
+          id: `${hit.session_id}:${hit.turn_index}`,
+          sessionId: hit.session_id,
+          turnIndex: hit.turn_index,
+          role: hit.role,
+          content: hit.content
+        });
+        continue;
+      }
+      appendExpandedEvidence(
+        options.evidenceItems,
+        options.seenTurns,
+        hit.session_id,
+        expanded
+      );
+      appendedWindows += 1;
+    }
+  }
+  return resolved;
+}
+async function searchReferenceContentLabels(engine, referenceNumber, sessionId) {
+  const hits = /* @__PURE__ */ new Map();
+  for (const labelKind of ["action", "observation"]) {
+    const label = labelKind === "action" ? "Action" : "Observation";
+    for (const query of [`[${label} ${referenceNumber}]`, `${label} ${referenceNumber}`]) {
+      const results = await engine.searchContextFull(
+        query,
+        CONTENT_LABEL_SEARCH_LIMIT,
+        sessionId
+      );
+      for (const result of results) {
+        if (!isReferenceLabelRole(result.role, labelKind) || !contentHasReferenceLabel(result.content, labelKind, referenceNumber)) {
+          continue;
+        }
+        hits.set(`${result.session_id}:${result.turn_index}:${labelKind}`, {
+          turn_index: result.turn_index,
+          role: result.role,
+          content: result.content,
+          session_id: result.session_id,
+          labelKind
+        });
+      }
+    }
+  }
+  const numericCandidates = candidateTurnIndexesForReference({
+    number: referenceNumber,
+    includeDirectTurn: false
+  });
+  return [...hits.values()].sort((left, right) => {
+    const sessionOrder = left.session_id.localeCompare(right.session_id);
+    if (sessionOrder !== 0) {
+      return sessionOrder;
+    }
+    const leftDistance = nearestTurnDistance(left.turn_index, numericCandidates);
+    const rightDistance = nearestTurnDistance(right.turn_index, numericCandidates);
+    if (leftDistance !== rightDistance) {
+      return leftDistance - rightDistance;
+    }
+    return left.turn_index - right.turn_index || left.labelKind.localeCompare(right.labelKind);
+  });
+}
+function nearestTurnDistance(turnIndex, candidates) {
+  let nearest = Number.POSITIVE_INFINITY;
+  for (const candidate of candidates) {
+    nearest = Math.min(nearest, Math.abs(turnIndex - candidate));
+  }
+  return nearest;
+}
+function contentLabelEvidenceWindow(hit) {
+  if (hit.labelKind === "action") {
+    return {
+      fromTurn: Math.max(0, hit.turn_index - 1),
+      toTurn: hit.turn_index + 1
+    };
+  }
+  return {
+    fromTurn: Math.max(0, hit.turn_index - 1),
+    toTurn: hit.turn_index
+  };
+}
+function contentHasReferenceLabel(content, labelKind, referenceNumber) {
+  const label = labelKind === "action" ? "Action" : "Observation";
+  const escapedNumber = String(referenceNumber).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(
+    `^\\s*\\[\\s*${label}\\s+${escapedNumber}\\s*\\]\\s*(?::\\s*)?`,
+    "i"
+  ).test(content);
+}
+function isReferenceLabelRole(role, labelKind) {
+  if (labelKind === "action") {
+    return role === "user";
+  }
+  return role === "assistant";
+}
+function expandedHasPairedTrajectoryLabels(expanded, referenceNumber) {
+  let hasAction = false;
+  let hasObservation = false;
+  for (const message of expanded) {
+    if (isReferenceLabelRole(message.role, "action") && contentHasReferenceLabel(message.content, "action", referenceNumber)) {
+      hasAction = true;
+    }
+    if (isReferenceLabelRole(message.role, "observation") && contentHasReferenceLabel(message.content, "observation", referenceNumber)) {
+      hasObservation = true;
+    }
+  }
+  return hasAction && hasObservation;
+}
 async function collectLexicalCueEvidence(options) {
   const cues = collectLexicalCues(options.query, {
     includeBenchmarkAnchorCues: options.includeBenchmarkAnchorCues,
@@ -32474,15 +32631,19 @@ var NamespaceSearchRouter = class {
    */
   async updateNamespaces(namespaces, execution) {
     const unique = Array.from(new Set(namespaces.map((value) => value.trim()).filter(Boolean)));
-    const results = await Promise.all(
+    const eligible = (await Promise.all(
       unique.map(async (namespace) => {
         const record = await this.backendRecordFor(namespace);
-        if (!record.available || record.collectionState === "missing") return 0;
-        await record.backend.update(execution);
-        return 1;
+        return record.available && record.collectionState !== "missing" ? record : null;
       })
-    );
-    return results.reduce((sum, v) => sum + v, 0);
+    )).filter((record) => record !== null);
+    const globalRecord = eligible.find((record) => record.backend.updatesAllCollections?.() === true);
+    const scopedRecords = globalRecord ? eligible.filter((record) => record.backend.updatesAllCollections?.() !== true) : eligible;
+    await Promise.all([
+      globalRecord ? globalRecord.backend.update(execution) : Promise.resolve(),
+      ...scopedRecords.map((record) => record.backend.update(execution))
+    ]);
+    return (globalRecord ? 1 : 0) + scopedRecords.length;
   }
   async embedNamespaces(namespaces) {
     const unique = Array.from(new Set(namespaces.map((value) => value.trim()).filter(Boolean)));

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-remnic",
   "name": "Remnic OpenClaw Plugin",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "kind": "memory",
   "description": "Local semantic memory for OpenClaw. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
   "setup": {
@@ -28,14 +28,14 @@
       "provider": "openai",
       "method": "api-key",
       "choiceId": "remnic-openai-api-key",
-      "choiceLabel": "OpenAI API key for Remnic memory extraction",
-      "choiceHint": "Remnic sends memory extraction, consolidation, and embedding requests to OpenAI or the configured OpenAI-compatible endpoint unless you route those tasks through OpenClaw gateway/local LLM settings.",
+      "choiceLabel": "Optional OpenAI API key for Remnic plugin-mode extraction",
+      "choiceHint": "Not needed when Remnic uses the OpenClaw gateway model source. Set only if you intentionally use plugin mode with OpenAI or an OpenAI-compatible endpoint.",
       "groupId": "remnic-memory",
       "groupLabel": "Remnic memory",
       "optionKey": "openaiApiKey",
       "cliFlag": "--openai-api-key",
       "cliOption": "--openai-api-key <key>",
-      "cliDescription": "OpenAI API key used by Remnic memory extraction, consolidation, and embedding flows.",
+      "cliDescription": "Optional OpenAI API key used by Remnic plugin-mode extraction, consolidation, and embedding flows.",
       "onboardingScopes": [
         "text-inference"
       ]
@@ -107,7 +107,7 @@
     "properties": {
       "openaiApiKey": {
         "type": "string",
-        "description": "OpenAI API key (or set OPENAI_API_KEY env var). Remnic may send conversation and memory content to OpenAI or the configured OpenAI-compatible endpoint for extraction, consolidation, summarization, and embeddings."
+        "description": "Optional OpenAI API key for plugin mode (or set OPENAI_API_KEY env var). Ignored by default gateway-mode installs; in plugin mode, Remnic may send conversation and memory content to OpenAI or the configured OpenAI-compatible endpoint for extraction, consolidation, summarization, and embeddings."
       },
       "openaiBaseUrl": {
         "type": "string",
@@ -2853,12 +2853,12 @@
       },
       "modelSource": {
         "type": "string",
-        "enum": [
-          "plugin",
-          "gateway"
-        ],
-        "default": "plugin",
-        "description": "LLM source: 'plugin' uses Engram's own openai/localLlm config; 'gateway' delegates to a gateway agent's model chain (agents.list[])."
+      "enum": [
+        "plugin",
+        "gateway"
+      ],
+      "default": "gateway",
+      "description": "LLM source: 'gateway' delegates to a gateway agent's model chain (agents.list[]); 'plugin' uses Engram's own openai/localLlm config."
       },
       "gatewayAgentId": {
         "type": "string",
@@ -4593,7 +4593,7 @@
       "label": "OpenAI API Key",
       "sensitive": true,
       "placeholder": "sk-...",
-      "help": "API key for OpenAI (or use ${OPENAI_API_KEY})"
+      "help": "Optional API key for plugin mode only. Not needed when Model Source is gateway."
     },
     "openaiBaseUrl": {
       "label": "OpenAI Base URL",
@@ -5041,7 +5041,7 @@
     },
     "modelSource": {
       "label": "Model Source",
-      "help": "Route LLM calls through the gateway's agent model chain instead of Engram's own config. When set to 'gateway', localLlm and openai settings are ignored."
+      "help": "Route LLM calls through the gateway's agent model chain instead of Engram's own config. Default for OpenClaw installs. When set to 'gateway', localLlm and openai settings are ignored."
     },
     "gatewayAgentId": {
       "label": "Gateway Agent ID",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/plugin-openclaw",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "description": "OpenClaw adapter for Remnic memory — thin wrapper delegating to @remnic/core",
   "type": "module",
   "main": "dist/index.js",