@openviking/openclaw-plugin 2026.8.28 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openviking/openclaw-plugin",
-  "version": "2026.8.28",
+  "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",