@remnic/plugin-openclaw 9.29.0 → 9.30.0

package/dist/index.js

@@ -72,7 +72,16 @@ import { clearIndexes, clearIndexesAsync, deindexMemory, deindexMemoryAsync, ext
 import * as temporal_index_star from "@remnic/core/temporal-index";
 
 // ../../src/explicit-capture.ts
-import { hasInlineExplicitCaptureMarkup, parseInlineExplicitCaptureNotes, persistExplicitCapture, queueExplicitCaptureForReview, shouldProcessInlineExplicitCapture, shouldSkipImplicitExtraction, stripInlineExplicitCaptureNotes, validateExplicitCaptureInput } from "@remnic/core/explicit-capture";
+import { InlineExplicitCaptureProcessor, hasInlineExplicitCaptureMarkup, parseInlineExplicitCaptureNotes, persistExplicitCapture, queueExplicitCaptureForReview, shouldProcessInlineExplicitCapture, shouldSkipImplicitExtraction, stripInlineExplicitCaptureNotes, validateExplicitCaptureInput } from "@remnic/core/explicit-capture";
+function mergeInlineCaptureDedupeKeys(messageKeys, fallbackDedupeKeys = []) {
+  const dedupeKeys = new Set(messageKeys ?? []);
+  if (dedupeKeys.size === 0) {
+    for (const key of fallbackDedupeKeys) {
+      if (key) dedupeKeys.add(key);
+    }
+  }
+  return [...dedupeKeys];
+}
 
 // ../../src/tools.ts
 import { composeSalvagedEnvelope as composeSalvagedEnvelope2 } from "@remnic/core/salvage-envelope";
@@ -6980,7 +6989,6 @@ function tryDefinePluginEntry(def) {
   }
 }
 var MAX_OBSERVED_INBOUND_MESSAGE_IDS = 1024;
-var MAX_OBSERVED_INLINE_EXPLICIT_CAPTURE_KEYS = 1024;
 function requireOpenClawSdkSubpath(subpath) {
   try {
     const _require = createRequire(import.meta.url);
@@ -7724,6 +7732,16 @@ Keep the reflection grounded in the evidence below.
           const expired = observedInboundContentFingerprintOrder.shift();
           if (expired) observedInboundContentFingerprints.delete(expired);
         }
+      }, rememberObservedInboundCaptureContentFingerprint2 = function(contentFingerprint) {
+        if (!contentFingerprint) return;
+        if (!observedInboundCaptureContentFingerprints.has(contentFingerprint)) {
+          observedInboundCaptureContentFingerprints.add(contentFingerprint);
+          observedInboundCaptureContentFingerprintOrder.push(contentFingerprint);
+        }
+        while (observedInboundCaptureContentFingerprintOrder.length > MAX_OBSERVED_INBOUND_MESSAGE_IDS) {
+          const expired = observedInboundCaptureContentFingerprintOrder.shift();
+          if (expired) observedInboundCaptureContentFingerprints.delete(expired);
+        }
       }, rememberPendingSparseInboundContentFingerprint2 = function(contentFingerprint) {
         if (!contentFingerprint) return;
         if (!pendingSparseInboundContentFingerprints.has(contentFingerprint)) {
@@ -7762,18 +7780,6 @@ Keep the reflection grounded in the evidence below.
           if (metadata?.replyToBody?.trim()) return metadata;
         }
         return null;
-      }, rememberObservedInlineExplicitCaptureKey2 = function(noteKey) {
-        if (!observedInlineExplicitCaptureKeys.has(noteKey)) {
-          observedInlineExplicitCaptureKeys.add(noteKey);
-          observedInlineExplicitCaptureKeyOrder.push(noteKey);
-        }
-        while (observedInlineExplicitCaptureKeyOrder.length > MAX_OBSERVED_INLINE_EXPLICIT_CAPTURE_KEYS) {
-          const expired = observedInlineExplicitCaptureKeyOrder.shift();
-          if (expired) observedInlineExplicitCaptureKeys.delete(expired);
-        }
-      }, buildInlineExplicitCaptureDedupeKey2 = function(messageKey, note) {
-        if (!messageKey) return null;
-        return `${messageKey}:inline-memory-note:${createHash4("sha256").update(JSON.stringify(note)).digest("hex")}`;
       }, resolveStoredCodexThreadId2 = function(sessionKey) {
         const threadId = codexThreadBySession.get(sessionKey);
         return typeof threadId === "string" && threadId.length > 0 ? threadId : null;
@@ -8055,7 +8061,7 @@ Keep the reflection grounded in the evidence below.
         const lowered = prompt.trim().toLowerCase();
         return lowered.startsWith("read heartbeat.md") || lowered.startsWith("run the following periodic tasks");
       };
-      var rememberObservedInboundMessageId = rememberObservedInboundMessageId2, rememberObservedInboundMessageKeys = rememberObservedInboundMessageKeys2, rememberObservedInboundContentFingerprint = rememberObservedInboundContentFingerprint2, rememberPendingSparseInboundContentFingerprint = rememberPendingSparseInboundContentFingerprint2, consumePendingSparseInboundContentFingerprint = consumePendingSparseInboundContentFingerprint2, rememberInboundReplyMetadata = rememberInboundReplyMetadata2, getInboundReplyMetadata = getInboundReplyMetadata2, rememberObservedInlineExplicitCaptureKey = rememberObservedInlineExplicitCaptureKey2, buildInlineExplicitCaptureDedupeKey = buildInlineExplicitCaptureDedupeKey2, resolveStoredCodexThreadId = resolveStoredCodexThreadId2, resolveStoredCodexBufferKey = resolveStoredCodexBufferKey2, addSessionToCodexIndex = addSessionToCodexIndex2, removeSessionFromCodexIndex = removeSessionFromCodexIndex2, resolveCodexCompactionBaselineKey = resolveCodexCompactionBaselineKey2, resolveCodexPromptCacheKey = resolveCodexPromptCacheKey2, rememberCodexThread = rememberCodexThread2, forgetCodexThread = forgetCodexThread2, clearCodexCompatCaches = clearCodexCompatCaches2, hasExplicitProviderIdentity = hasExplicitProviderIdentity2, cachePromptMemoryLines = cachePromptMemoryLines2, consumePromptMemoryLines = consumePromptMemoryLines2, resolveSessionIdentity = resolveSessionIdentity2, hasBufferedTurns = hasBufferedTurns2, resolveExtractionBufferKey = resolveExtractionBufferKey2, renderMemoryContext = renderMemoryContext2, isHeartbeatTrigger = isHeartbeatTrigger2, resolveHeartbeatPromptCandidates = resolveHeartbeatPromptCandidates2, matchHeartbeatEntry = matchHeartbeatEntry2, looksLikeHeartbeatPrompt = looksLikeHeartbeatPrompt2;
+      var rememberObservedInboundMessageId = rememberObservedInboundMessageId2, rememberObservedInboundMessageKeys = rememberObservedInboundMessageKeys2, rememberObservedInboundContentFingerprint = rememberObservedInboundContentFingerprint2, rememberObservedInboundCaptureContentFingerprint = rememberObservedInboundCaptureContentFingerprint2, rememberPendingSparseInboundContentFingerprint = rememberPendingSparseInboundContentFingerprint2, consumePendingSparseInboundContentFingerprint = consumePendingSparseInboundContentFingerprint2, rememberInboundReplyMetadata = rememberInboundReplyMetadata2, getInboundReplyMetadata = getInboundReplyMetadata2, resolveStoredCodexThreadId = resolveStoredCodexThreadId2, resolveStoredCodexBufferKey = resolveStoredCodexBufferKey2, addSessionToCodexIndex = addSessionToCodexIndex2, removeSessionFromCodexIndex = removeSessionFromCodexIndex2, resolveCodexCompactionBaselineKey = resolveCodexCompactionBaselineKey2, resolveCodexPromptCacheKey = resolveCodexPromptCacheKey2, rememberCodexThread = rememberCodexThread2, forgetCodexThread = forgetCodexThread2, clearCodexCompatCaches = clearCodexCompatCaches2, hasExplicitProviderIdentity = hasExplicitProviderIdentity2, cachePromptMemoryLines = cachePromptMemoryLines2, consumePromptMemoryLines = consumePromptMemoryLines2, resolveSessionIdentity = resolveSessionIdentity2, hasBufferedTurns = hasBufferedTurns2, resolveExtractionBufferKey = resolveExtractionBufferKey2, renderMemoryContext = renderMemoryContext2, isHeartbeatTrigger = isHeartbeatTrigger2, resolveHeartbeatPromptCandidates = resolveHeartbeatPromptCandidates2, matchHeartbeatEntry = matchHeartbeatEntry2, looksLikeHeartbeatPrompt = looksLikeHeartbeatPrompt2;
       const hooksPolicy = readPluginHooksPolicy(api.config, serviceId);
       const promptInjectionAllowed = coerceRawConfigBoolean(hooksPolicy?.allowPromptInjection) !== false;
       const useMemoryPromptSection = sdkCaps.hasRegisterMemoryPromptSection && typeof api.registerMemoryPromptSection === "function" && promptInjectionAllowed;
@@ -8071,57 +8077,25 @@ Keep the reflection grounded in the evidence below.
       const observedInboundMessageIdOrder = [];
       const observedInboundContentFingerprints = /* @__PURE__ */ new Set();
       const observedInboundContentFingerprintOrder = [];
+      const observedInboundCaptureContentFingerprints = /* @__PURE__ */ new Set();
+      const observedInboundCaptureContentFingerprintOrder = [];
       const pendingSparseInboundContentFingerprints = /* @__PURE__ */ new Set();
       const pendingSparseInboundContentFingerprintOrder = [];
       const inboundReplyMetadataByMessageKey = /* @__PURE__ */ new Map();
       const inboundReplyMetadataKeyOrder = [];
-      const observedInlineExplicitCaptureKeys = /* @__PURE__ */ new Set();
-      const observedInlineExplicitCaptureKeyOrder = [];
+      const inlineCaptureProcessor = new InlineExplicitCaptureProcessor(orchestrator, {
+        sourceConnector: "openclaw"
+      });
       let codexCompactionModeLogged = false;
-      async function processInlineExplicitCaptureNotes(notes, messageKeys) {
-        let processed = 0;
-        for (const note of notes) {
-          const noteKeys = (messageKeys ?? []).map((messageKey) => buildInlineExplicitCaptureDedupeKey2(messageKey, note)).filter((noteKey) => typeof noteKey === "string");
-          if (noteKeys.length > 0 && noteKeys.some((noteKey) => observedInlineExplicitCaptureKeys.has(noteKey))) {
-            continue;
-          }
-          try {
-            await persistExplicitCapture(
-              orchestrator,
-              { ...validateExplicitCaptureInput(note), sourceConnector: "openclaw" },
-              "inline"
-            );
-            orchestrator.requestQmdMaintenanceForTool("inline.memory_note");
-            for (const noteKey of noteKeys) {
-              rememberObservedInlineExplicitCaptureKey2(noteKey);
-            }
-            processed += 1;
-          } catch (error) {
-            try {
-              const queued = await queueExplicitCaptureForReview(
-                orchestrator,
-                { ...note, sourceConnector: "openclaw" },
-                "inline",
-                error
-              );
-              orchestrator.requestQmdMaintenanceForTool(
-                "inline.memory_note.review"
-              );
-              for (const noteKey of noteKeys) {
-                rememberObservedInlineExplicitCaptureKey2(noteKey);
-              }
-              processed += 1;
-              logger_exports.log.warn(
-                `explicit inline capture queued for review: ${queued.id}${queued.duplicateOf ? ` (duplicate of ${queued.duplicateOf})` : ""}`
-              );
-            } catch (queueError) {
-              logger_exports.log.warn(
-                `explicit inline capture rejected: ${error}; review queue fallback failed: ${queueError}`
-              );
-            }
-          }
-        }
-        return processed;
+      async function processInlineExplicitCapture(content, messageKeys, fallbackDedupeKeys = [], sessionKey = "default") {
+        const dedupeKeys = mergeInlineCaptureDedupeKeys(messageKeys, fallbackDedupeKeys);
+        const reviewNamespace = typeof orchestrator.resolveSelfNamespace === "function" ? orchestrator.resolveSelfNamespace(sessionKey) : void 0;
+        return inlineCaptureProcessor.process({
+          captureMode: orchestrator.config.captureMode,
+          content,
+          dedupeKeys: [...dedupeKeys],
+          ...reviewNamespace ? { reviewNamespace, reviewNamespacePreResolved: true } : {}
+        });
       }
       async function flushAndForgetCodexThreadOnProviderSwitch(sessionKey, sessionIdentity) {
         if (sessionIdentity.isCodex || !sessionIdentity.previousCodexThreadId) {
@@ -8981,34 +8955,49 @@ Keep the reflection grounded in the evidence below.
             const eventDate = typeof event.timestamp === "number" && Number.isFinite(event.timestamp) ? new Date(event.timestamp) : /* @__PURE__ */ new Date();
             const timestamp = Number.isFinite(eventDate.getTime()) ? eventDate.toISOString() : (/* @__PURE__ */ new Date()).toISOString();
             const cleaned = cleanOpenClawUserMessage(content);
-            const inlineCaptureEnabled = shouldProcessInlineExplicitCapture(
-              orchestrator.config
+            const inlineCaptureContentFingerprint = buildOpenClawInboundContentFingerprint(
+              cleaned,
+              event,
+              event,
+              ctx,
+              sessionKey
             );
-            const explicitNotes = inlineCaptureEnabled ? parseInlineExplicitCaptureNotes(cleaned) : [];
-            const transcriptContent = inlineCaptureEnabled && hasInlineExplicitCaptureMarkup(cleaned) ? stripInlineExplicitCaptureNotes(cleaned) : cleaned;
+            const sparseInlineCaptureContentFingerprint = buildOpenClawSparseInboundContentFingerprint(cleaned, sessionKey);
+            const transcriptCandidate = shouldProcessInlineExplicitCapture(orchestrator.config) ? stripInlineExplicitCaptureNotes(cleaned) : cleaned;
             const inboundContentFingerprint = buildOpenClawInboundContentFingerprint(
-              transcriptContent,
+              transcriptCandidate,
               event,
               event,
               ctx,
               sessionKey
             );
             const sparseInboundContentFingerprint = buildOpenClawSparseInboundContentFingerprint(
-              transcriptContent,
+              transcriptCandidate,
               sessionKey
             );
+            if (inboundMessageKeys.length === 0 && inlineCaptureContentFingerprint && observedInboundCaptureContentFingerprints.has(inlineCaptureContentFingerprint)) {
+              return;
+            }
+            const inlineCapture = await processInlineExplicitCapture(
+              cleaned,
+              inboundMessageKeys,
+              [inlineCaptureContentFingerprint, sparseInlineCaptureContentFingerprint],
+              sessionKey
+            );
+            const transcriptContent = inlineCapture.content;
+            const inlineCaptureWasHandled = inlineCapture.failed === 0 && (inlineCapture.processed > 0 || inlineCapture.content === cleaned);
             if (inboundContentFingerprint && observedInboundContentFingerprints.has(inboundContentFingerprint)) {
+              if (inlineCaptureWasHandled) {
+                rememberObservedInboundCaptureContentFingerprint2(inlineCaptureContentFingerprint);
+              }
               return;
             }
-            const inlineCaptureDedupeKeys = inboundMessageKeys.length > 0 ? inboundMessageKeys : inboundContentFingerprint ? [inboundContentFingerprint] : sparseInboundContentFingerprint ? [sparseInboundContentFingerprint] : [];
-            const processedExplicitNotes = explicitNotes.length > 0 ? await processInlineExplicitCaptureNotes(
-              explicitNotes,
-              inlineCaptureDedupeKeys
-            ) : 0;
+            const processedExplicitNotes = inlineCapture.processed;
             if (!orchestrator.config.transcriptEnabled || transcriptContent.length === 0) {
               rememberInboundReplyMetadata2(inboundMessageKeys, inboundReplyHintMetadata);
-              if (processedExplicitNotes > 0) {
+              if (processedExplicitNotes > 0 && inlineCapture.failed === 0) {
                 rememberObservedInboundMessageKeys2(inboundMessageKeys);
+                rememberObservedInboundCaptureContentFingerprint2(inlineCaptureContentFingerprint);
                 rememberObservedInboundContentFingerprint2(inboundContentFingerprint);
                 if (inboundMessageKeys.length === 0) {
                   rememberPendingSparseInboundContentFingerprint2(sparseInboundContentFingerprint);
@@ -9025,12 +9014,15 @@ Keep the reflection grounded in the evidence below.
                 turnId: crypto.randomUUID(),
                 ...metadata ? { metadata } : {}
               });
-              if (inboundMessageKeys.length > 0) {
+              if (inboundMessageKeys.length > 0 && inlineCapture.failed === 0) {
                 rememberObservedInboundMessageKeys2(inboundMessageKeys);
                 rememberInboundReplyMetadata2(inboundMessageKeys, inboundReplyHintMetadata);
               }
+              if (inlineCaptureWasHandled) {
+                rememberObservedInboundCaptureContentFingerprint2(inlineCaptureContentFingerprint);
+              }
               rememberObservedInboundContentFingerprint2(inboundContentFingerprint);
-              if (inboundMessageKeys.length === 0) {
+              if (inlineCapture.failed === 0 && inboundMessageKeys.length === 0) {
                 rememberPendingSparseInboundContentFingerprint2(sparseInboundContentFingerprint);
               }
             } catch (err) {
@@ -9122,26 +9114,38 @@ Keep the reflection grounded in the evidence below.
               const content = extractTextContent(msg);
               if (content.length < 10) continue;
               const cleaned = role === "user" ? cleanOpenClawUserMessage(content) : content;
-              const inlineCaptureEnabled = shouldProcessInlineExplicitCapture(
-                orchestrator.config
-              );
-              const explicitNotes = inlineCaptureEnabled ? parseInlineExplicitCaptureNotes(cleaned) : [];
-              const stripped = inlineCaptureEnabled && hasInlineExplicitCaptureMarkup(cleaned) ? stripInlineExplicitCaptureNotes(cleaned) : cleaned;
-              const messageMetadata = buildOpenClawMessageMetadata(
+              const messageDedupeKeys = getOpenClawMessageDedupeKeys(msg, event, ctx, sessionKey);
+              const inlineCaptureContentFingerprint = buildOpenClawInboundContentFingerprint(
+                cleaned,
                 msg,
                 event,
                 ctx,
-                cfg
+                sessionKey
               );
-              const messageDedupeKeys = getOpenClawMessageDedupeKeys(msg, event, ctx, sessionKey);
+              const sparseInlineCaptureContentFingerprint = buildOpenClawSparseInboundContentFingerprint(cleaned, sessionKey);
+              const transcriptCandidate = shouldProcessInlineExplicitCapture(orchestrator.config) ? stripInlineExplicitCaptureNotes(cleaned) : cleaned;
               const messageContentFingerprint = buildOpenClawInboundContentFingerprint(
-                stripped,
+                transcriptCandidate,
                 msg,
                 event,
                 ctx,
                 sessionKey
               );
-              const sparseMessageContentFingerprint = buildOpenClawSparseInboundContentFingerprint(stripped, sessionKey);
+              const sparseMessageContentFingerprint = buildOpenClawSparseInboundContentFingerprint(transcriptCandidate, sessionKey);
+              const inlineCapture = await processInlineExplicitCapture(
+                cleaned,
+                messageDedupeKeys,
+                [inlineCaptureContentFingerprint, sparseInlineCaptureContentFingerprint],
+                sessionKey
+              );
+              const stripped = inlineCapture.content;
+              const inlineCaptureWasHandled = inlineCapture.failed === 0 && (inlineCapture.processed > 0 || inlineCapture.content === cleaned);
+              const messageMetadata = buildOpenClawMessageMetadata(
+                msg,
+                event,
+                ctx,
+                cfg
+              );
               const cachedReplyHintMetadata = role === "user" && cfg.openclawReplyMetadataExtractionHintsEnabled ? getInboundReplyMetadata2(messageDedupeKeys) : null;
               const replyHintMetadata = cfg.openclawReplyMetadataExtractionHintsEnabled ? cachedReplyHintMetadata ?? buildOpenClawMessageMetadata(msg, event, ctx, {
                 openclawReplyMetadataCaptureEnabled: true
@@ -9149,11 +9153,6 @@ Keep the reflection grounded in the evidence below.
               const messageDedupeKey = messageDedupeKeys[0];
               const sparseInboundAlreadyCaptured = role === "user" && messageDedupeKeys.length === 0 && consumePendingSparseInboundContentFingerprint2(sparseMessageContentFingerprint);
               const transcriptAlreadyCaptured = role === "user" && (messageDedupeKeys.length > 0 && messageDedupeKeys.some((key) => observedInboundMessageIds.has(key)) || sparseInboundAlreadyCaptured || messageContentFingerprint !== null && observedInboundContentFingerprints.has(messageContentFingerprint));
-              const inlineCaptureDedupeKeys = messageDedupeKeys.length > 0 ? messageDedupeKeys : messageContentFingerprint ? [messageContentFingerprint] : sparseMessageContentFingerprint ? [sparseMessageContentFingerprint] : [];
-              await processInlineExplicitCaptureNotes(
-                explicitNotes,
-                inlineCaptureDedupeKeys
-              );
               if (orchestrator.config.transcriptEnabled && stripped.length > 0 && !transcriptAlreadyCaptured) {
                 await orchestrator.transcript.append({
                   timestamp: eventTimestamp,
@@ -9164,8 +9163,15 @@ Keep the reflection grounded in the evidence below.
                   ...messageMetadata ? { metadata: messageMetadata } : {}
                 });
                 if (role === "user") {
-                  if (messageDedupeKey) {
-                    rememberObservedInboundMessageKeys2(messageDedupeKeys);
+                  if (inlineCapture.failed === 0) {
+                    if (messageDedupeKey) {
+                      rememberObservedInboundMessageKeys2(messageDedupeKeys);
+                    }
+                    if (inlineCaptureWasHandled) {
+                      rememberObservedInboundCaptureContentFingerprint2(
+                        inlineCaptureContentFingerprint
+                      );
+                    }
                   }
                   rememberObservedInboundContentFingerprint2(messageContentFingerprint);
                 }