@openviking/openclaw-plugin 2026.8.21 → 2026.8.30

package/context-engine.ts

@@ -25,6 +25,11 @@ type ContextEngineInfo = {
   name: string;
   version?: string;
   ownsCompaction: true;
+  /** OpenClaw >=2026.8.1: without both declarations (and commitTurn) the engine is degraded to "legacy" every turn. */
+  transcriptSemantics: {
+    currentTurnFence: "before-current-turn-entry-v1";
+    turnAdvancementIdempotency: "atomic-idempotent-v1";
+  };
 };
 
 type AssembleResult = {
@@ -81,6 +86,14 @@ type ContextEngine = {
     tokenBudget?: number;
     runtimeContext?: Record<string, unknown>;
   }) => Promise<AssembleResult>;
+  /** OpenClaw >=2026.8.1 durable turn advancement; retried with the same advancementKey after host failure. */
+  commitTurn: (params: {
+    advancementKey: string;
+    messages: AgentMessage[];
+    sessionId: string;
+    sessionKey?: string;
+    isHeartbeat?: boolean;
+  }) => Promise<{ status: "committed" | "duplicate" }>;
   compact: (params: {
     sessionId: string;
     sessionKey?: string;
@@ -318,12 +331,18 @@ export function createMemoryOpenVikingContextEngine(params: {
     };
   }
 
+  const committedTurnKeys = new Set<string>();
+
   return {
     info: {
       id,
       name,
       version,
       ownsCompaction: true,
+      transcriptSemantics: {
+        currentTurnFence: "before-current-turn-entry-v1",
+        turnAdvancementIdempotency: "atomic-idempotent-v1",
+      },
     },
 
     commitOVSession: doCommitOVSession,
@@ -368,6 +387,22 @@ export function createMemoryOpenVikingContextEngine(params: {
       });
     },
 
+    // Capture still happens in afterTurn (host calls it per LLM call + on finalize);
+    // commitTurn only acknowledges the accepted turn so OpenClaw drains its outbox.
+    // ponytail: in-memory key set, not durable across restarts — the host outbox is.
+    async commitTurn({ advancementKey, sessionId }): Promise<{ status: "committed" | "duplicate" }> {
+      if (committedTurnKeys.has(advancementKey)) {
+        diag("commitTurn_duplicate", sessionId, { advancementKey });
+        return { status: "duplicate" };
+      }
+      committedTurnKeys.add(advancementKey);
+      if (committedTurnKeys.size > 1024) {
+        committedTurnKeys.delete(committedTurnKeys.values().next().value as string);
+      }
+      diag("commitTurn", sessionId, { advancementKey });
+      return { status: "committed" };
+    },
+
     async afterTurn(afterTurnParams): Promise<void> {
       const tokenBudget = validTokenBudget(afterTurnParams.tokenBudget) ?? 128_000;
       await afterTurnOpenVikingSession({

package/dist/context-engine.js

@@ -159,12 +159,17 @@ export function createMemoryOpenVikingContextEngine(params) {
             ovSessionId: openClawSessionToOvStorageId(params.sessionId, sessionKey),
         };
     }
+    const committedTurnKeys = new Set();
     return {
         info: {
             id,
             name,
             version,
             ownsCompaction: true,
+            transcriptSemantics: {
+                currentTurnFence: "before-current-turn-entry-v1",
+                turnAdvancementIdempotency: "atomic-idempotent-v1",
+            },
         },
         commitOVSession: doCommitOVSession,
         // --- standard ContextEngine methods ---
@@ -202,6 +207,21 @@ export function createMemoryOpenVikingContextEngine(params) {
                 prependRecallToLatestUserMessage,
             });
         },
+        // Capture still happens in afterTurn (host calls it per LLM call + on finalize);
+        // commitTurn only acknowledges the accepted turn so OpenClaw drains its outbox.
+        // ponytail: in-memory key set, not durable across restarts — the host outbox is.
+        async commitTurn({ advancementKey, sessionId }) {
+            if (committedTurnKeys.has(advancementKey)) {
+                diag("commitTurn_duplicate", sessionId, { advancementKey });
+                return { status: "duplicate" };
+            }
+            committedTurnKeys.add(advancementKey);
+            if (committedTurnKeys.size > 1024) {
+                committedTurnKeys.delete(committedTurnKeys.values().next().value);
+            }
+            diag("commitTurn", sessionId, { advancementKey });
+            return { status: "committed" };
+        },
         async afterTurn(afterTurnParams) {
             const tokenBudget = validTokenBudget(afterTurnParams.tokenBudget) ?? 128_000;
             await afterTurnOpenVikingSession({

package/dist/services/context-lifecycle-service.js

@@ -196,10 +196,14 @@ function isSessionNotFoundError(err) {
     return errorMessage.includes("[NOT_FOUND]") && errorMessage.includes("Session not found");
 }
 export async function assembleOpenVikingSession({ sessionId, sessionKey, messages, tokenBudget, runtimeContext, isMainAssemble, cfg, getClient, logger, resolveAgentId, rememberSessionAgentId, isBypassedSession, queryConfigStore, traceRecorder, diag, roughEstimate, messageDigest, extractAgentMessageText, hasAutoRecallBlock, prependRecallToLatestUserMessage, }) {
-    const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
-    const sender = extractRuntimeSenderId(runtimeContext);
     const latestMessage = messages.at(-1);
     const isTransformContextAssemble = !isMainAssemble;
+    // Tool-loop calls do no recall work on non-user tails; avoid scanning the full history.
+    if (isTransformContextAssemble && latestMessage?.role !== "user") {
+        return { messages, estimatedTokens: 0 };
+    }
+    const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
+    const sender = extractRuntimeSenderId(runtimeContext);
     const originalTokens = roughEstimate(messages);
     rememberSessionAgentId?.({
         sessionId,
@@ -220,16 +224,6 @@ export async function assembleOpenVikingSession({ sessionId, sessionKey, message
         return assemblePassthrough({ diag, ovSessionId, reason: "session_bypassed", liveMessages: messages, originalTokens });
     }
     if (isTransformContextAssemble) {
-        if (latestMessage?.role !== "user") {
-            return assemblePassthrough({
-                diag,
-                ovSessionId,
-                reason: "transform_context_non_user_tail",
-                liveMessages: messages,
-                originalTokens,
-                extra: { latestRole: latestMessage?.role ?? null },
-            });
-        }
         if (!cfg.autoRecall) {
             return assemblePassthrough({ diag, ovSessionId, reason: "transform_context_auto_recall_disabled", liveMessages: messages, originalTokens });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openviking/openclaw-plugin",
-  "version": "2026.8.21",
+  "version": "2026.8.30",
   "displayName": "OpenViking",
   "description": "OpenClaw context-engine plugin — OpenViking AI memory, long-term memory, knowledge base, semantic search, RAG, context engine. 长期记忆 · 知识库 · 语义检索 · 上下文引擎",
   "type": "module",

package/services/context-lifecycle-service.ts

@@ -441,10 +441,16 @@ export async function assembleOpenVikingSession({
   hasAutoRecallBlock,
   prependRecallToLatestUserMessage,
 }: AssembleOpenVikingSessionParams): Promise<AssembleOpenVikingSessionResult> {
-  const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
-  const sender = extractRuntimeSenderId(runtimeContext);
   const latestMessage = messages.at(-1);
   const isTransformContextAssemble = !isMainAssemble;
+
+  // Tool-loop calls do no recall work on non-user tails; avoid scanning the full history.
+  if (isTransformContextAssemble && latestMessage?.role !== "user") {
+    return { messages, estimatedTokens: 0 };
+  }
+
+  const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
+  const sender = extractRuntimeSenderId(runtimeContext);
   const originalTokens = roughEstimate(messages);
 
   rememberSessionAgentId?.({
@@ -468,16 +474,6 @@ export async function assembleOpenVikingSession({
   }
 
   if (isTransformContextAssemble) {
-    if (latestMessage?.role !== "user") {
-      return assemblePassthrough({
-        diag,
-        ovSessionId,
-        reason: "transform_context_non_user_tail",
-        liveMessages: messages,
-        originalTokens,
-        extra: { latestRole: latestMessage?.role ?? null },
-      });
-    }
     if (!cfg.autoRecall) {
       return assemblePassthrough({ diag, ovSessionId, reason: "transform_context_auto_recall_disabled", liveMessages: messages, originalTokens });
     }