@openviking/openclaw-plugin 2026.9.10 → 2026.9.11

package/auto-recall.ts

@@ -331,6 +331,7 @@ export async function buildAutoRecallContext(params: {
   rawUserTextPreview?: string;
   queryTruncated?: boolean;
   resourceTypes?: RecallResourceType[];
+  dedupTurns?: number;
 }): Promise<{ block?: string; memoryCount: number; estimatedTokens: number }> {
   const { cfg, client, agentId, actorPeerId, queryText, logger, verbose } = params;
   const queryConfig = params.queryConfig;
@@ -373,7 +374,7 @@ export async function buildAutoRecallContext(params: {
           queryExpansion: "auto",
           maxTokens,
           detail: recallPreferAbstract ? "abstract" : undefined,
-          dedupTurns: params.ovSessionId ? AUTO_RECALL_DEDUP_TURNS : undefined,
+          dedupTurns: params.dedupTurns ?? (params.ovSessionId ? AUTO_RECALL_DEDUP_TURNS : undefined),
           peerScope: "actor",
           actorPeerId,
           requestTimeoutMs: cfg.autoRecallTimeoutMs,

package/client.ts

@@ -80,6 +80,7 @@ export type CommitSessionResult = {
   task_id?: string;
   archive_uri?: string;
   archived?: boolean;
+  reset_context?: boolean;
   /** Present when wait=true and extraction completed. Keyed by category. */
   memories_extracted?: Record<string, number>;
   error?: string;
@@ -508,6 +509,7 @@ export class OpenVikingClient {
     };
     const body = {
       ...buildContextSearchBody(contractConfig, { sessionId: options.sessionId }),
+      ...(options.dedupTurns === 0 ? { dedup_turns: 0 } : {}),
       query,
       ...(options.contextType !== undefined ? { context_type: options.contextType } : {}),
       ...(options.detail !== undefined ? { detail: options.detail } : {}),
@@ -844,6 +846,8 @@ export class OpenVikingClient {
        * preserves the pre-v2 "archive everything" behavior.
       */
       keepRecentCount?: number;
+      /** Start empty context in the same session after archiving. */
+      resetContext?: boolean;
       agentId?: string;
     },
   ): Promise<CommitSessionResult> {
@@ -865,6 +869,9 @@ export class OpenVikingClient {
     if (keepRecentCount > 0) {
       body.keep_recent_count = keepRecentCount;
     }
+    if (options?.resetContext) {
+      body.reset_context = true;
+    }
     const result = await this.request<CommitSessionResult>(
       `/api/v1/sessions/${encodeURIComponent(sessionId)}/commit`,
       { method: "POST", body: JSON.stringify(body) },
@@ -872,6 +879,10 @@ export class OpenVikingClient {
       options?.agentId,
     );
 
+    if (options?.resetContext && result.reset_context !== true) {
+      throw new Error("OpenViking server did not confirm reset_context; upgrade the server with the plugin.");
+    }
+
     if (!options?.wait || !result.task_id) {
       return result;
     }

package/context-engine.ts

@@ -394,6 +394,7 @@ export function createMemoryOpenVikingContextEngine(params: {
         sessionId: assembleParams.sessionId,
         sessionKey: resolveSessionKey(assembleParams),
         messages: assembleParams.messages,
+        prompt: assembleParams.prompt,
         tokenBudget,
         runtimeContext: assembleParams.runtimeContext,
         isMainAssemble,

package/dist/auto-recall.js

@@ -244,7 +244,7 @@ export async function buildAutoRecallContext(params) {
                 queryExpansion: "auto",
                 maxTokens,
                 detail: recallPreferAbstract ? "abstract" : undefined,
-                dedupTurns: params.ovSessionId ? AUTO_RECALL_DEDUP_TURNS : undefined,
+                dedupTurns: params.dedupTurns ?? (params.ovSessionId ? AUTO_RECALL_DEDUP_TURNS : undefined),
                 peerScope: "actor",
                 actorPeerId,
                 requestTimeoutMs: cfg.autoRecallTimeoutMs,

package/dist/client.js

@@ -205,6 +205,7 @@ export class OpenVikingClient {
         };
         const body = {
             ...buildContextSearchBody(contractConfig, { sessionId: options.sessionId }),
+            ...(options.dedupTurns === 0 ? { dedup_turns: 0 } : {}),
             query,
             ...(options.contextType !== undefined ? { context_type: options.contextType } : {}),
             ...(options.detail !== undefined ? { detail: options.detail } : {}),
@@ -414,7 +415,13 @@ export class OpenVikingClient {
         if (keepRecentCount > 0) {
             body.keep_recent_count = keepRecentCount;
         }
+        if (options?.resetContext) {
+            body.reset_context = true;
+        }
         const result = await this.request(`/api/v1/sessions/${encodeURIComponent(sessionId)}/commit`, { method: "POST", body: JSON.stringify(body) }, undefined, options?.agentId);
+        if (options?.resetContext && result.reset_context !== true) {
+            throw new Error("OpenViking server did not confirm reset_context; upgrade the server with the plugin.");
+        }
         if (!options?.wait || !result.task_id) {
             return result;
         }

package/dist/context-engine.js

@@ -214,6 +214,7 @@ export function createMemoryOpenVikingContextEngine(params) {
                 sessionId: assembleParams.sessionId,
                 sessionKey: resolveSessionKey(assembleParams),
                 messages: assembleParams.messages,
+                prompt: assembleParams.prompt,
                 tokenBudget,
                 runtimeContext: assembleParams.runtimeContext,
                 isMainAssemble,

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

@@ -157,6 +157,7 @@ export async function commitOpenVikingSession({ sessionId, sessionKey, getClient
         const commitResult = await client.commitSession(ovId, {
             wait: true,
             keepRecentCount: 0,
+            resetContext: true,
         });
         const memCount = totalExtractedMemories(commitResult.memories_extracted);
         if (commitResult.status === "failed") {
@@ -195,7 +196,73 @@ function isSessionNotFoundError(err) {
     const errorMessage = String(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, }) {
+async function recallForAssemble(params, recallQuery) {
+    const { sessionId, sessionKey, cfg, getClient, resolveAgentId, queryConfigStore, logger, traceRecorder } = params;
+    const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
+    const sender = extractRuntimeSenderId(params.runtimeContext);
+    const client = await getClient();
+    const routingRef = sessionId ?? sessionKey ?? ovSessionId;
+    const agentId = resolveAgentId(routingRef, sessionKey, ovSessionId);
+    const actorPeerId = resolveOpenVikingActorPeerId({
+        peerRole: cfg.peer_role ?? "none",
+        senderPeerId: sanitizeOpenVikingPeerId(sender.senderId),
+        assistantPeerId: agentId,
+    });
+    const queryConfig = await queryConfigStore?.getEffective({
+        agentId,
+        sessionId,
+        sessionKey,
+        ovSessionId,
+    });
+    return buildAutoRecallContext({
+        cfg,
+        queryConfig,
+        client,
+        agentId,
+        actorPeerId,
+        queryText: recallQuery.query,
+        logger,
+        verbose: (message) => logger.info(message),
+        traceRecorder: traceRecorder,
+        sessionId,
+        sessionKey,
+        ovSessionId,
+        queryTruncated: recallQuery.truncated,
+        rawUserTextPreview: recallQuery.query,
+        // System additions are transient; the next turn must be able to recall the same URI.
+        dedupTurns: params.isMainAssemble ? 0 : undefined,
+    });
+}
+export async function assembleOpenVikingSession(params) {
+    const assembled = await assembleSessionContext(params);
+    // Current OpenClaw supplies the pending turn separately from history. Keep
+    // recalled context out of persisted messages and let the host own that turn.
+    if (!params.isMainAssemble || !params.cfg.autoRecall || !params.prompt ||
+        params.isBypassedSession(params)) {
+        return assembled;
+    }
+    const query = prepareRecallQuery(params.prompt);
+    if (query.query.length < 5)
+        return assembled;
+    try {
+        const recall = await recallForAssemble(params, query);
+        if (!recall.block)
+            return assembled;
+        const systemPromptAddition = [assembled.systemPromptAddition, recall.block].filter(Boolean).join("\n\n");
+        const estimatedTokens = assembled.estimatedTokens
+            + estimateTextTokens(systemPromptAddition)
+            - estimateTextTokens(assembled.systemPromptAddition ?? "");
+        if (estimatedTokens > params.tokenBudget)
+            return assembled;
+        return { ...assembled, systemPromptAddition, estimatedTokens };
+    }
+    catch (err) {
+        params.logger.warn?.(`openviking: auto-recall failed: ${String(err)}`);
+        return assembled;
+    }
+}
+async function assembleSessionContext(params) {
+    const { sessionId, sessionKey, messages, tokenBudget, runtimeContext, isMainAssemble, cfg, getClient, logger, resolveAgentId, rememberSessionAgentId, isBypassedSession, diag, roughEstimate, messageDigest, extractAgentMessageText, hasAutoRecallBlock, prependRecallToLatestUserMessage, } = params;
     const latestMessage = messages.at(-1);
     const isTransformContextAssemble = !isMainAssemble;
     // Tool-loop calls do no recall work on non-user tails; avoid scanning the full history.
@@ -239,36 +306,7 @@ export async function assembleOpenVikingSession({ sessionId, sessionKey, message
                 `chars=${recallQuery.originalChars}->${recallQuery.finalChars})`);
         }
         try {
-            const client = await getClient();
-            const routingRef = sessionId ?? sessionKey ?? ovSessionId;
-            const agentId = resolveAgentId(routingRef, sessionKey, ovSessionId);
-            const actorPeerId = resolveOpenVikingActorPeerId({
-                peerRole: cfg.peer_role ?? "none",
-                senderPeerId: sanitizeOpenVikingPeerId(sender.senderId),
-                assistantPeerId: agentId,
-            });
-            const queryConfig = await queryConfigStore?.getEffective({
-                agentId,
-                sessionId,
-                sessionKey,
-                ovSessionId,
-            });
-            const recall = await buildAutoRecallContext({
-                cfg,
-                queryConfig,
-                client,
-                agentId,
-                actorPeerId,
-                queryText: recallQuery.query,
-                logger,
-                verbose: (message) => logger.info(message),
-                traceRecorder: traceRecorder,
-                sessionId,
-                sessionKey,
-                ovSessionId,
-                queryTruncated: recallQuery.truncated,
-                rawUserTextPreview: recallQuery.query,
-            });
+            const recall = await recallForAssemble(params, recallQuery);
             if (!recall.block) {
                 return assemblePassthrough({
                     diag,

package/package.json

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

@@ -72,6 +72,7 @@ export type AssembleOpenVikingSessionParams = {
   sessionId: string;
   sessionKey?: string;
   messages: AgentMessage[];
+  prompt?: string;
   tokenBudget: number;
   runtimeContext?: Record<string, unknown>;
   isMainAssemble: boolean;
@@ -369,6 +370,7 @@ export async function commitOpenVikingSession({
     const commitResult = await client.commitSession(ovId, {
       wait: true,
       keepRecentCount: 0,
+      resetContext: true,
     });
     const memCount = totalExtractedMemories(commitResult.memories_extracted);
     if (commitResult.status === "failed") {
@@ -423,28 +425,98 @@ function isSessionNotFoundError(err: unknown): boolean {
   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,
-}: AssembleOpenVikingSessionParams): Promise<AssembleOpenVikingSessionResult> {
+async function recallForAssemble(
+  params: AssembleOpenVikingSessionParams,
+  recallQuery: ReturnType<typeof prepareRecallQuery>,
+) {
+  const { sessionId, sessionKey, cfg, getClient, resolveAgentId, queryConfigStore, logger, traceRecorder } = params;
+  const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
+  const sender = extractRuntimeSenderId(params.runtimeContext);
+  const client = await getClient();
+  const routingRef = sessionId ?? sessionKey ?? ovSessionId;
+  const agentId = resolveAgentId(routingRef, sessionKey, ovSessionId);
+  const actorPeerId = resolveOpenVikingActorPeerId({
+    peerRole: cfg.peer_role ?? "none",
+    senderPeerId: sanitizeOpenVikingPeerId(sender.senderId),
+    assistantPeerId: agentId,
+  });
+  const queryConfig = await queryConfigStore?.getEffective({
+    agentId,
+    sessionId,
+    sessionKey,
+    ovSessionId,
+  });
+  return buildAutoRecallContext({
+    cfg,
+    queryConfig,
+    client,
+    agentId,
+    actorPeerId,
+    queryText: recallQuery.query,
+    logger,
+    verbose: (message) => logger.info(message),
+    traceRecorder: traceRecorder as never,
+    sessionId,
+    sessionKey,
+    ovSessionId,
+    queryTruncated: recallQuery.truncated,
+    rawUserTextPreview: recallQuery.query,
+    // System additions are transient; the next turn must be able to recall the same URI.
+    dedupTurns: params.isMainAssemble ? 0 : undefined,
+  });
+}
+
+export async function assembleOpenVikingSession(
+  params: AssembleOpenVikingSessionParams,
+): Promise<AssembleOpenVikingSessionResult> {
+  const assembled = await assembleSessionContext(params);
+  // Current OpenClaw supplies the pending turn separately from history. Keep
+  // recalled context out of persisted messages and let the host own that turn.
+  if (
+    !params.isMainAssemble || !params.cfg.autoRecall || !params.prompt ||
+    params.isBypassedSession(params)
+  ) {
+    return assembled;
+  }
+  const query = prepareRecallQuery(params.prompt);
+  if (query.query.length < 5) return assembled;
+
+  try {
+    const recall = await recallForAssemble(params, query);
+    if (!recall.block) return assembled;
+    const systemPromptAddition = [assembled.systemPromptAddition, recall.block].filter(Boolean).join("\n\n");
+    const estimatedTokens = assembled.estimatedTokens
+      + estimateTextTokens(systemPromptAddition)
+      - estimateTextTokens(assembled.systemPromptAddition ?? "");
+    if (estimatedTokens > params.tokenBudget) return assembled;
+    return { ...assembled, systemPromptAddition, estimatedTokens };
+  } catch (err) {
+    params.logger.warn?.(`openviking: auto-recall failed: ${String(err)}`);
+    return assembled;
+  }
+}
+
+async function assembleSessionContext(params: AssembleOpenVikingSessionParams): Promise<AssembleOpenVikingSessionResult> {
+  const {
+    sessionId,
+    sessionKey,
+    messages,
+    tokenBudget,
+    runtimeContext,
+    isMainAssemble,
+    cfg,
+    getClient,
+    logger,
+    resolveAgentId,
+    rememberSessionAgentId,
+    isBypassedSession,
+    diag,
+    roughEstimate,
+    messageDigest,
+    extractAgentMessageText,
+    hasAutoRecallBlock,
+    prependRecallToLatestUserMessage,
+  } = params;
   const latestMessage = messages.at(-1);
   const isTransformContextAssemble = !isMainAssemble;
 
@@ -497,36 +569,7 @@ export async function assembleOpenVikingSession({
     }
 
     try {
-      const client = await getClient();
-      const routingRef = sessionId ?? sessionKey ?? ovSessionId;
-      const agentId = resolveAgentId(routingRef, sessionKey, ovSessionId);
-      const actorPeerId = resolveOpenVikingActorPeerId({
-        peerRole: cfg.peer_role ?? "none",
-        senderPeerId: sanitizeOpenVikingPeerId(sender.senderId),
-        assistantPeerId: agentId,
-      });
-      const queryConfig = await queryConfigStore?.getEffective({
-        agentId,
-        sessionId,
-        sessionKey,
-        ovSessionId,
-      });
-      const recall = await buildAutoRecallContext({
-        cfg,
-        queryConfig,
-        client,
-        agentId,
-        actorPeerId,
-        queryText: recallQuery.query,
-        logger,
-        verbose: (message) => logger.info(message),
-        traceRecorder: traceRecorder as never,
-        sessionId,
-        sessionKey,
-        ovSessionId,
-        queryTruncated: recallQuery.truncated,
-        rawUserTextPreview: recallQuery.query,
-      });
+      const recall = await recallForAssemble(params, recallQuery);
 
       if (!recall.block) {
         return assemblePassthrough({