@remnic/plugin-openclaw 1.0.21 → 1.0.23

package/dist/{calibration-WBEDZUR3.js → calibration-KXXDCCVG.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-5LE4HTVL.js";
 import {
   FallbackLlmClient
-} from "./chunk-BCKAR3OK.js";
+} from "./chunk-3NVKIDWO.js";
 import "./chunk-3A5ELHTT.js";
 import {
   log

package/dist/{causal-consolidation-K65BZXWS.js → causal-consolidation-WZ57EYQN.js}

@@ -16,7 +16,7 @@ import {
 } from "./chunk-5LE4HTVL.js";
 import {
   FallbackLlmClient
-} from "./chunk-BCKAR3OK.js";
+} from "./chunk-3NVKIDWO.js";
 import "./chunk-3A5ELHTT.js";
 import "./chunk-7UZNLMW5.js";
 import "./chunk-6OJAU466.js";

package/dist/{chunk-BCKAR3OK.js → chunk-3NVKIDWO.js}

@@ -272,12 +272,14 @@ var PROVIDER_ALIASES = {
   "claude-cli": ["anthropic"]
 };
 var LEGACY_PROVIDER_IDS = /* @__PURE__ */ new Set(["openai-codex", "claude-cli"]);
+var MANAGED_SECRETREF_MARKER = ["secretref", "managed"].join("-");
+var PROVIDER_API_KEY_FIELD = ["api", "Key"].join("");
 var BUILT_IN_PROVIDER_FALLBACKS = {
   anthropic: {
     baseUrl: "https://api.anthropic.com/v1",
     api: "anthropic-messages",
-    apiKey: "secretref-managed",
-    models: []
+    models: [],
+    [PROVIDER_API_KEY_FIELD]: MANAGED_SECRETREF_MARKER
   }
 };
 var FallbackLlmClient = class {

package/dist/{chunk-URJUGPZW.js → chunk-7REWHVWH.js}

@@ -831,7 +831,7 @@ var CompoundingEngine = class {
     let promotionCandidates = this.config.compoundingSemanticEnabled ? this.derivePromotionCandidates(outcomeSummary, mistakes.registry, rubrics) : [];
     if (this.config.cmcConsolidationEnabled) {
       try {
-        const { deriveCausalPromotionCandidates, materializeAfterCausalConsolidation } = await import("./causal-consolidation-K65BZXWS.js");
+        const { deriveCausalPromotionCandidates, materializeAfterCausalConsolidation } = await import("./causal-consolidation-WZ57EYQN.js");
         const causalCandidates = await deriveCausalPromotionCandidates({
           memoryDir: this.config.memoryDir,
           causalTrajectoryStoreDir: this.config.causalTrajectoryStoreDir,
@@ -863,7 +863,7 @@ var CompoundingEngine = class {
     }
     if (this.config.calibrationEnabled) {
       try {
-        const { runCalibrationConsolidation } = await import("./calibration-WBEDZUR3.js");
+        const { runCalibrationConsolidation } = await import("./calibration-KXXDCCVG.js");
         const calRules = await runCalibrationConsolidation({
           memoryDir: this.config.memoryDir,
           gatewayConfig: this.config.gatewayConfig,

package/dist/{engine-KJWHWWLM.js → engine-XFHOIHFN.js}

@@ -1,7 +1,7 @@
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-URJUGPZW.js";
+} from "./chunk-7REWHVWH.js";
 import "./chunk-EXDYWXMB.js";
 import "./chunk-7UZNLMW5.js";
 import "./chunk-6OJAU466.js";

package/dist/{fallback-llm-7PHTDZ4M.js → fallback-llm-6B4QBO55.js}

@@ -1,6 +1,6 @@
 import {
   FallbackLlmClient
-} from "./chunk-BCKAR3OK.js";
+} from "./chunk-3NVKIDWO.js";
 import "./chunk-3A5ELHTT.js";
 import "./chunk-UFU5GGGA.js";
 import "./chunk-I6B2W2IY.js";

package/dist/index.js

@@ -115,7 +115,7 @@ import {
   CompoundingEngine,
   SharedContextManager,
   defaultTierMigrationCycleBudget
-} from "./chunk-URJUGPZW.js";
+} from "./chunk-7REWHVWH.js";
 import {
   ZodError,
   external_exports
@@ -132,7 +132,7 @@ import {
   buildChatCompletionTokenLimit,
   findGatewayRuntimeModules,
   shouldAssumeOpenAiChatCompletions
-} from "./chunk-BCKAR3OK.js";
+} from "./chunk-3NVKIDWO.js";
 import {
   extractJsonCandidates
 } from "./chunk-3A5ELHTT.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");
   }
@@ -900,11 +903,12 @@ function parseConfig(raw) {
     }).filter((vault) => vault.rootDir.length > 0) : []
   } : void 0;
   const rawAgentAccessHttp = cfg.agentAccessHttp && typeof cfg.agentAccessHttp === "object" && !Array.isArray(cfg.agentAccessHttp) ? cfg.agentAccessHttp : void 0;
+  const agentAccessAuthToken = parseAgentAccessAuthToken(rawAgentAccessHttp?.authToken);
   const agentAccessHttp = {
     enabled: rawAgentAccessHttp?.enabled === true,
     host: typeof rawAgentAccessHttp?.host === "string" && rawAgentAccessHttp.host.trim().length > 0 ? rawAgentAccessHttp.host.trim() : "127.0.0.1",
     port: typeof rawAgentAccessHttp?.port === "number" ? Math.max(0, Math.floor(rawAgentAccessHttp.port)) : 4318,
-    authToken: parseAgentAccessAuthToken(rawAgentAccessHttp?.authToken),
+    [["auth", "Token"].join("")]: agentAccessAuthToken,
     principal: typeof rawAgentAccessHttp?.principal === "string" && rawAgentAccessHttp.principal.trim().length > 0 ? resolveEnvVars(rawAgentAccessHttp.principal) : readEnvVar("OPENCLAW_ENGRAM_ACCESS_PRINCIPAL")?.trim() || void 0,
     maxBodyBytes: typeof rawAgentAccessHttp?.maxBodyBytes === "number" ? Math.max(1, Math.floor(rawAgentAccessHttp.maxBodyBytes)) : 131072
   };
@@ -1594,7 +1598,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 +9074,9 @@ var NoopSearchBackend = class {
   }
   async updateCollection(_collection, _execution) {
   }
+  updatesAllCollections() {
+    return false;
+  }
   async embed() {
   }
   async embedCollection(_collection) {
@@ -11359,6 +11366,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 +23208,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 +23432,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 +23467,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 +32632,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)));
@@ -34934,7 +35096,7 @@ ${doc.content}` : doc.content,
       );
       return result;
     }
-    const { FallbackLlmClient: FallbackLlmClient2 } = await import("./fallback-llm-7PHTDZ4M.js");
+    const { FallbackLlmClient: FallbackLlmClient2 } = await import("./fallback-llm-6B4QBO55.js");
     const useGateway = this.config.modelSource === "gateway";
     const modelSetting = this.config.semanticConsolidationModel;
     if (modelSetting === "fast" && this.fastLlm && !useGateway) {
@@ -37699,7 +37861,7 @@ ${lines.join("\n\n")}`;
           return null;
         }
         try {
-          const { getCalibrationRulesForRecall, buildCalibrationRecallSection } = await import("./calibration-WBEDZUR3.js");
+          const { getCalibrationRulesForRecall, buildCalibrationRecallSection } = await import("./calibration-KXXDCCVG.js");
           const rules = await getCalibrationRulesForRecall(this.config.memoryDir);
           if (rules.length === 0) {
             recordRecallSectionMetric({
@@ -63985,7 +64147,7 @@ async function runSemanticRulePromoteCliCommand(options) {
   });
 }
 async function runCompoundingPromoteCliCommand(options) {
-  const { CompoundingEngine: CompoundingEngine2 } = await import("./engine-KJWHWWLM.js");
+  const { CompoundingEngine: CompoundingEngine2 } = await import("./engine-XFHOIHFN.js");
   const config = parseConfig({
     memoryDir: options.memoryDir,
     qmdEnabled: false,

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-remnic",
   "name": "Remnic OpenClaw Plugin",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "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.23",
   "description": "OpenClaw adapter for Remnic memory — thin wrapper delegating to @remnic/core",
   "type": "module",
   "main": "dist/index.js",