Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

48.2 KB
Raw Blame
// Canonical ContextEngine lifecycle service: assemble / afterTurn / compact / commit orchestration.
import { DEFAULT_PHASE2_POLL_TIMEOUT_MS, type OpenVikingClient, type OVMessage } from "../client.js";
import type { EffectiveQueryConfig } from "../query-config.js";
import { buildAutoRecallContext, prepareRecallQuery } from "../auto-recall.js";
import { toJsonLog } from "../memory-ranking.js";
import {
  openClawSessionToOvStorageId,
  resolveOpenVikingActorPeerId,
  resolveOpenVikingMessagePeerId,
  sanitizeOpenVikingPeerId,
  type OpenVikingPeerRole,
} from "../routing/identity-routing.js";
import { extractNewTurnMessages } from "../text-utils.js";
import { estimateAgentMessageTokens, estimateTextTokens } from "../token-estimator.js";
import {
  convertToAgentMessages,
  mergeConsecutiveAssistants,
  sanitizeAgentMessagesForProvider,
  toRoleId,
  type AgentMessage,
} from "./context-message-adapter.js";

type ExtractedTurnMessage = ReturnType<typeof extractNewTurnMessages>["messages"][number];

export type ContextEngineLifecycleLogger = {
  info: (msg: string) => void;
  warn?: (msg: string) => void;
};

export type CommitOpenVikingSessionParams = {
  sessionId: string;
  sessionKey?: string;
  getClient: () => Promise<Pick<OpenVikingClient, "commitSession">>;
  logger: ContextEngineLifecycleLogger;
  rememberSessionAgentId?: (ctx: {
    agentId?: string;
    sessionId?: string;
    sessionKey?: string;
    ovSessionId?: string;
  }) => void;
  isBypassedSession: (params: { sessionId?: string; sessionKey?: string }) => boolean;
};

export type CompactOpenVikingSessionResult = {
  ok: boolean;
  compacted: boolean;
  reason?: string;
  result?: {
    summary?: string;
    firstKeptEntryId?: string;
    tokensBefore: number;
    tokensAfter?: number;
    details?: unknown;
  };
};

export type AssembleOpenVikingSessionResult = {
  messages: AgentMessage[];
  estimatedTokens: number;
  systemPromptAddition?: string;
};

type AssembleBuiltContext = {
  sanitized: AgentMessage[];
  archive: { messages: AgentMessage[]; tokens: number };
  session: { messages: AgentMessage[]; tokens: number };
  budgets: { archiveMemory: number; sessionContext: number; reserved: number };
  instruction: { text: string; tokens: number };
};

export type AssembleOpenVikingSessionParams = {
  sessionId: string;
  sessionKey?: string;
  messages: AgentMessage[];
  prompt?: string;
  tokenBudget: number;
  runtimeContext?: Record<string, unknown>;
  isMainAssemble: boolean;
  cfg: any;
  getClient: () => Promise<OpenVikingClient>;
  logger: ContextEngineLifecycleLogger;
  resolveAgentId: (sessionId: string, sessionKey?: string, ovSessionId?: string) => string;
  rememberSessionAgentId?: (ctx: {
    agentId?: string;
    sessionId?: string;
    sessionKey?: string;
    ovSessionId?: string;
  }) => void;
  isBypassedSession: (params: { sessionId?: string; sessionKey?: string }) => boolean;
  queryConfigStore?: {
    getEffective(params: {
      agentId?: string;
      sessionId?: string;
      sessionKey?: string;
      ovSessionId?: string;
    }): Promise<EffectiveQueryConfig>;
  };
  traceRecorder?: unknown;
  diag: (stage: string, sessionId: string, data: Record<string, unknown>) => void;
  roughEstimate: (messages: AgentMessage[]) => number;
  messageDigest: (messages: AgentMessage[]) => Array<{role: string; content: string; tokens: number; truncated: boolean}>;
  extractAgentMessageText: (message: AgentMessage | undefined) => string;
  hasAutoRecallBlock: (message: AgentMessage | undefined) => boolean;
  prependRecallToLatestUserMessage: (messages: AgentMessage[], recallBlock: string) => AgentMessage[];
};

type CompactClient = Pick<OpenVikingClient, "commitSession" | "getSessionContext">;

export type CompactOpenVikingSessionParams = {
  contextManagementMode?: "native" | "openviking";
  sessionId: string;
  sessionKey?: string;
  tokenBudget: number;
  currentTokenCount?: unknown;
  force?: boolean;
  compactionTarget?: "budget" | "threshold";
  customInstructions?: string;
  getClient: () => Promise<CompactClient>;
  logger: ContextEngineLifecycleLogger;
  resolveAgentId: (sessionId: string, sessionKey?: string, ovSessionId?: string) => string;
  isBypassedSession: (params: { sessionId?: string; sessionKey?: string }) => boolean;
  /** Host-native compaction for bypassed sessions; resolves undefined when unavailable. */
  runtimeCompact?: () => Promise<CompactOpenVikingSessionResult | undefined>;
  diag: (stage: string, sessionId: string, data: Record<string, unknown>) => void;
};

type AfterTurnClient = Pick<OpenVikingClient, "addSessionMessage" | "getSession" | "commitSession" | "getTask">;

export type AfterTurnOpenVikingSessionParams = {
  /** Durable delivery must reject failed writes so the host retains its outbox row. */
  throwOnError?: boolean;
  sessionId: string;
  sessionKey?: string;
  messages?: AgentMessage[];
  prePromptMessageCount?: number;
  isHeartbeat?: boolean;
  /** Model context window in tokens; the auto-commit threshold is a fraction of this. */
  tokenBudget: number;
  runtimeContext?: Record<string, unknown>;
  cfg: {
    autoCapture: boolean;
    contextManagementMode?: "native" | "openviking";
    commitTokenThresholdRatio: number;
    commitKeepRecentCount: number;
    commitRetentionMode?: "message_count" | "turn_budget";
    logFindRequests: boolean;
    peer_role?: OpenVikingPeerRole;
  };
  getClient: () => Promise<AfterTurnClient>;
  logger: ContextEngineLifecycleLogger;
  resolveAgentId: (sessionId: string, sessionKey?: string, ovSessionId?: string) => string;
  rememberSessionAgentId?: (ctx: {
    agentId?: string;
    sessionId?: string;
    sessionKey?: string;
    ovSessionId?: string;
  }) => void;
  isBypassedSession: (params: { sessionId?: string; sessionKey?: string }) => boolean;
  diag: (stage: string, sessionId: string, data: Record<string, unknown>) => void;
};

export function totalExtractedMemories(memories?: Record<string, number>): number {
  if (!memories || typeof memories !== "object") {
    return 0;
  }
  return Object.values(memories).reduce((sum, count) => sum + (count ?? 0), 0);
}

type ContextBudgets = {
  archiveMemory: number;
  sessionContext: number;
  reserved: number;
};

const BUDGET_UNLIMITED = -1;
const ARCHIVE_BUDGET_RATIO = 0.15;
const ARCHIVE_BUDGET_CAP = 8_000;
const RESERVED_MIN = 20_000;
const RESERVED_RATIO = 0.15;
const PHASE2_POLL_INTERVAL_MS = 800;
const PHASE2_POLL_MAX_MS = DEFAULT_PHASE2_POLL_TIMEOUT_MS;

function sleep(ms: number): Promise<void> {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

/**
 * After wait=false commit, Phase2 runs on the server. Poll task until completed/failed/timeout
 * so logs show memories_extracted (otherwise it looks like "nothing was saved").
 */
async function pollPhase2ExtractionOutcome(
  client: AfterTurnClient,
  taskId: string,
  logger: ContextEngineLifecycleLogger,
  sessionLabel: string,
): Promise<void> {
  const deadline = Date.now() + PHASE2_POLL_MAX_MS;
  try {
    while (Date.now() < deadline) {
      await sleep(PHASE2_POLL_INTERVAL_MS);
      const task = await client.getTask(taskId).catch((e) => {
        logger.warn?.(`openviking: phase2 getTask failed task_id=${taskId}: ${String(e)}`);
        return null;
      });
      if (!task) {
        return;
      }
      const { status } = task;
      if (status === "completed") {
        logger.info(
          `openviking: phase2 completed task_id=${taskId} session=${sessionLabel} ` +
            `result=${toJsonLog(task.result ?? {})}`,
        );
        return;
      }
      if (status === "failed") {
        logger.warn?.(
          `openviking: phase2 failed task_id=${taskId} session=${sessionLabel} error=${task.error ?? "unknown"}`,
        );
        return;
      }
    }
    logger.warn?.(
      `openviking: phase2 poll timeout (${PHASE2_POLL_MAX_MS / 1000}s) task_id=${taskId} session=${sessionLabel} — ` +
        `check GET /api/v1/tasks/${taskId}`,
    );
  } catch (e) {
    logger.warn?.(`openviking: phase2 poll exception task_id=${taskId}: ${String(e)}`);
  }
}

function allocateContextBudget(totalBudget: number, instructionTokens = 0): ContextBudgets {
  const reserveFloor = totalBudget >= RESERVED_MIN * 2 ? RESERVED_MIN : 0;
  const reserved = Math.min(totalBudget, Math.max(totalBudget * RESERVED_RATIO, reserveFloor));
  const usableBudget = Math.max(totalBudget - reserved - instructionTokens, 0);
  const archiveMemory = Math.min(usableBudget * ARCHIVE_BUDGET_RATIO, ARCHIVE_BUDGET_CAP);
  const sessionContext = Math.max(usableBudget - archiveMemory, 0);
  return { archiveMemory, sessionContext, reserved };
}

function buildSystemPromptAddition(): string {
  return [
    "## Session Context Guide",
    "",
    "Your conversation history includes two layers:",
    "",
    "1. **[Session History Summary]** — A compressed summary of all prior turns",
    "   in this session. It is organized into structured sections (Key Facts,",
    "   Timeline, People, etc.). Use it for background and continuity.",
    "   The summary is lossy: specific details (exact dates, numbers, names,",
    "   small events) may have been compressed away.",
    "",
    "2. **Active messages** — The most recent uncompressed turns.",
    "",
    "**Rules:**",
    "- When active messages conflict with the Summary, trust active messages",
    "  as the newer source of truth.",
    "- Do not fabricate details the Summary does not state explicitly.",
    "- **CRITICAL: Before answering 'no information' or 'not mentioned',",
    "  you MUST carefully re-read EVERY section of the [Session History Summary].",
    "  The answer may be expressed with different wording than the question.",
    "  Look for synonyms, related facts, and indirect references.**",
    "- If the Summary mentions a topic but lacks the specific detail asked,",
    "  use the `ov_archive_search` tool to grep the original archived messages",
    "  for the exact detail. Try 2-3 different keywords extracted from the question.",
    "- Only conclude information is unavailable AFTER both checking the Summary",
    "  thoroughly AND searching the archives with at least 2 keyword variations.",
  ].join("\n");
}

function buildInstructionPrompt(): { text: string; tokens: number } {
  const text = buildSystemPromptAddition();
  return { text, tokens: estimateTextTokens(text) };
}

function buildArchiveMemory(
  archiveOverview: string | undefined,
  _preAbstracts: Array<{ archive_id: string; abstract: string }>,
  _budget: number,
  roughEstimate: (messages: AgentMessage[]) => number,
): { messages: AgentMessage[]; tokens: number } {
  const messages: AgentMessage[] = [];

  if (archiveOverview) {
    messages.push({
      role: "user",
      content: `[Session History Summary]\n${archiveOverview}`,
    });
  }

  return { messages, tokens: roughEstimate(messages) };
}

function buildSessionContext(
  ovMessages: OVMessage[],
  budget: number,
  roughEstimate: (messages: AgentMessage[]) => number,
): { messages: AgentMessage[]; tokens: number } {
  const raw = ovMessages.flatMap((m) => convertToAgentMessages(m));
  const messages = mergeConsecutiveAssistants(raw);
  const tokens = roughEstimate(messages);
  if (budget === BUDGET_UNLIMITED || tokens <= budget) {
    return { messages, tokens };
  }
  const trimmed = [...messages];
  while (trimmed.length > 0 && roughEstimate(trimmed) > budget) {
    trimmed.shift();
  }
  return { messages: trimmed, tokens: roughEstimate(trimmed) };
}

function buildAssembledContext(
  overview: string | undefined,
  preAbstracts: Array<{ archive_id: string; abstract: string }>,
  ovMessages: OVMessage[],
  tokenBudget: number,
  ovSessionId: string,
  logger: ContextEngineLifecycleLogger,
  roughEstimate: (messages: AgentMessage[]) => number,
): AssembleBuiltContext {
  const hasArchives = Boolean(overview) || preAbstracts.length > 0;
  const instruction = hasArchives ? buildInstructionPrompt() : { text: "", tokens: 0 };

  // 4-layer context partitioning:
  //   Instruction — system prompt guide (Archive Index / Session History usage)
  //   Archive     — session history summary + per-archive one-line abstracts
  //   Session     — active OV messages converted to AgentMessage format
  //   Reserved    — headroom for model output (not consumed here)
  const budgets = allocateContextBudget(tokenBudget, instruction.tokens);
  const archive = buildArchiveMemory(overview, preAbstracts, budgets.archiveMemory, roughEstimate);
  const sessionBudget = Math.max(
    tokenBudget - budgets.reserved - instruction.tokens - archive.tokens,
    0,
  );
  const session = buildSessionContext(ovMessages, sessionBudget, roughEstimate);
  const assembled = [...archive.messages, ...session.messages];

  logger.info(
    `openviking: assemble entering session content for ${ovSessionId}: ` +
      JSON.stringify(assembled.map((m) => ({
        role: m.role,
        content: typeof m.content === "string" ? m.content.substring(0, 100) : "[complex]",
      })), null, 2),
  );

  const sanitized = sanitizeAgentMessagesForProvider(assembled);

  return { sanitized, archive, session, budgets, instruction };
}

export async function commitOpenVikingSession({
  sessionId,
  sessionKey,
  getClient,
  logger,
  rememberSessionAgentId,
  isBypassedSession,
}: CommitOpenVikingSessionParams): Promise<boolean> {
  const ovId = openClawSessionToOvStorageId(sessionId, sessionKey);
  if (isBypassedSession({ sessionId, sessionKey })) {
    logger.warn?.(
      `openviking: commit skipped because session is bypassed (sessionId=${sessionId}, sessionKey=${sessionKey ?? "none"})`,
    );
    return false;
  }
  try {
    const client = await getClient();
    rememberSessionAgentId?.({
      sessionId,
      sessionKey,
      ovSessionId: ovId,
    });
    const commitResult = await client.commitSession(ovId, {
      wait: true,
      keepRecentCount: 0,
      resetContext: true,
    });
    const memCount = totalExtractedMemories(commitResult.memories_extracted);
    if (commitResult.status === "failed") {
      logger.warn?.(
        `openviking: commit Phase 2 failed for session=${sessionId}: ${commitResult.error ?? "unknown"}, ` +
          `trace_id=${commitResult.trace_id ?? "none"}`,
      );
      return false;
    }
    if (commitResult.status === "timeout") {
      logger.warn?.(
        `openviking: commit Phase 2 timed out for session=${sessionId}, ` +
          `task_id=${commitResult.task_id ?? "none"}, trace_id=${commitResult.trace_id ?? "none"}`,
      );
      return false;
    }
    logger.info(
      `openviking: committed OV session=${sessionId} ovId=${ovId}, archived=${commitResult.archived ?? false}, memories=${memCount}, task_id=${commitResult.task_id ?? "none"}, trace_id=${commitResult.trace_id ?? "none"}`,
    );
    return true;
  } catch (err) {
    logger.warn?.(`openviking: commit failed for session=${sessionId}: ${String(err)}`);
    return false;
  }
}

function assemblePassthrough(
  params: Pick<AssembleOpenVikingSessionParams, "diag"> & {
    ovSessionId: string;
    reason: string;
    liveMessages: AgentMessage[];
    originalTokens: number;
    extra?: Record<string, unknown>;
  },
): AssembleOpenVikingSessionResult {
  const { diag, ovSessionId, reason, liveMessages, originalTokens, extra } = params;
  diag("assemble_result", ovSessionId, {
    passthrough: true,
    reason,
    outputMessagesCount: liveMessages.length,
    inputTokenEstimate: originalTokens,
    estimatedTokens: originalTokens,
    tokensSaved: 0,
    savingPct: 0,
    ...extra,
  });
  return { messages: liveMessages, estimatedTokens: originalTokens };
}

function isSessionNotFoundError(err: unknown): boolean {
  const errorMessage = String(err);
  return errorMessage.includes("[NOT_FOUND]") && errorMessage.includes("Session not found");
}

const PROFILE_MAX_CHARS = 8000;
const PROFILE_READ_TIMEOUT_MS = 3000;

function resolveAssembleRouting(params: AssembleOpenVikingSessionParams) {
  const { sessionId, sessionKey, cfg, resolveAgentId, logger } = params;
  const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
  const sender = extractRuntimeSenderId(params.runtimeContext);
  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,
    warn: (message) => logger.warn?.(message),
  });
  return { ovSessionId, agentId, actorPeerId };
}

// Server-side context assembly leaves profile.md out on the assumption that the
// client injects it, so read it here: the user's profile and, with peer scope, the actor's.
async function readProfileBlock(
  client: OpenVikingClient,
  actorPeerId: string | undefined,
  timeoutMs: number,
  logger: ContextEngineLifecycleLogger,
): Promise<string> {
  const uris = ["viking://~/memories/profile.md"];
  if (actorPeerId) uris.push(`viking://~/peers/${actorPeerId}/memories/profile.md`);
  const reads = await Promise.allSettled(uris.map((uri) => client.read(uri, actorPeerId, timeoutMs)));
  return reads
    .map((read, i) => {
      if (read.status === "rejected" && !String(read.reason).includes("[NOT_FOUND]")) {
        logger.warn?.(`openviking: profile read failed (uri=${uris[i]}): ${String(read.reason)}`);
      }
      const text = read.status === "fulfilled" && typeof read.value === "string" ? read.value.trim() : "";
      if (!text) return "";
      const capped = text.length > PROFILE_MAX_CHARS
        ? `${text.slice(0, PROFILE_MAX_CHARS).trimEnd()}\n... [profile truncated]`
        : text;
      return `<user-profile uri="${uris[i]}">\n${capped}\n</user-profile>`;
    })
    .filter(Boolean)
    .join("\n\n");
}

async function recallForAssemble(
  params: AssembleOpenVikingSessionParams,
  recallQuery: ReturnType<typeof prepareRecallQuery>,
  client: OpenVikingClient,
  routing: ReturnType<typeof resolveAssembleRouting>,
) {
  const { sessionId, sessionKey, cfg, queryConfigStore, logger, traceRecorder } = params;
  const { ovSessionId, agentId, actorPeerId } = routing;
  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.isBypassedSession(params)) {
    return assembled;
  }
  const query = prepareRecallQuery(params.prompt ?? "");

  try {
    const routing = resolveAssembleRouting(params);
    const client = await params.getClient();
    const [profileBlock, recallBlock] = await Promise.all([
      readProfileBlock(
        client,
        routing.actorPeerId,
        Math.min(params.cfg.autoRecallTimeoutMs ?? PROFILE_READ_TIMEOUT_MS, PROFILE_READ_TIMEOUT_MS),
        params.logger,
      ),
      query.query.length < 5 ? "" : recallForAssemble(params, query, client, routing)
        .then((recall) => recall.block)
        .catch((err) => {
          params.logger.warn?.(`openviking: auto-recall failed: ${String(err)}`);
          return "";
        }),
    ]);
    const baseTokens = estimateTextTokens(assembled.systemPromptAddition ?? "");
    for (const blocks of [[profileBlock, recallBlock], [profileBlock], [recallBlock]]) {
      if (!blocks.some(Boolean)) continue;
      const systemPromptAddition = [assembled.systemPromptAddition, ...blocks].filter(Boolean).join("\n\n");
      const estimatedTokens = assembled.estimatedTokens + estimateTextTokens(systemPromptAddition) - baseTokens;
      if (estimatedTokens <= params.tokenBudget) return { ...assembled, systemPromptAddition, estimatedTokens };
    }
    return assembled;
  } 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;

  // 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,
    sessionKey,
    agentId: extractRuntimeAgentId(runtimeContext),
    ovSessionId,
  });
  diag("assemble_entry", ovSessionId, {
    messagesCount: messages.length,
    inputTokenEstimate: originalTokens,
    tokenBudget,
    sessionKey: sessionKey ?? null,
    senderIdFound: sender.found,
    senderId: sender.senderId ?? null,
    messages: messageDigest(messages),
  });

  if (isBypassedSession({ sessionId, sessionKey })) {
    return assemblePassthrough({ diag, ovSessionId, reason: "session_bypassed", liveMessages: messages, originalTokens });
  }

  if (isTransformContextAssemble) {
    if (!cfg.autoRecall) {
      return assemblePassthrough({ diag, ovSessionId, reason: "transform_context_auto_recall_disabled", liveMessages: messages, originalTokens });
    }
    if (hasAutoRecallBlock(latestMessage)) {
      return assemblePassthrough({ diag, ovSessionId, reason: "transform_context_recall_already_injected", liveMessages: messages, originalTokens });
    }

    const recallQuery = prepareRecallQuery(extractAgentMessageText(latestMessage));
    if (!recallQuery.query || recallQuery.query.length < 5) {
      return assemblePassthrough({ diag, ovSessionId, reason: "transform_context_empty_recall_query", liveMessages: messages, originalTokens });
    }
    if (recallQuery.truncated) {
      logger.info(
        `openviking: recall query truncated (` +
          `chars=${recallQuery.originalChars}->${recallQuery.finalChars})`,
      );
    }

    try {
      const recall = await recallForAssemble(params, recallQuery, await getClient(), resolveAssembleRouting(params));

      if (!recall.block) {
        return assemblePassthrough({
          diag,
          ovSessionId,
          reason: "transform_context_no_recall_hits",
          liveMessages: messages,
          originalTokens,
          extra: { memoryCount: recall.memoryCount },
        });
      }

      const withRecall = prependRecallToLatestUserMessage(messages, recall.block);
      const estimatedTokens = roughEstimate(withRecall);
      diag("assemble_result", ovSessionId, {
        passthrough: false,
        phase: "transform_context",
        outputMessagesCount: withRecall.length,
        inputTokenEstimate: originalTokens,
        estimatedTokens,
        autoRecallMemoryCount: recall.memoryCount,
        autoRecallTokens: recall.estimatedTokens,
        messages: messageDigest(withRecall),
      });
      return { messages: withRecall, estimatedTokens };
    } catch (err) {
      logger.warn?.(`openviking: auto-recall failed: ${String(err)}`);
      return assemblePassthrough({
        diag,
        ovSessionId,
        reason: "transform_context_recall_failed",
        liveMessages: messages,
        originalTokens,
        extra: { error: String(err) },
      });
    }
  }

  if (cfg.contextManagementMode !== "openviking") {
    return assemblePassthrough({ diag, ovSessionId, reason: "native_context", liveMessages: messages, originalTokens });
  }

  try {
    const client = await getClient();
    const ctx = await client.getSessionContext(ovSessionId, tokenBudget);

    const preAbstracts = ctx?.pre_archive_abstracts ?? [];
    const hasArchives = !!ctx?.latest_archive_overview || preAbstracts.length > 0;
    const activeCount = ctx?.messages?.length ?? 0;

    // A completed WM-off archive can leave a non-empty active tail. That tail
    // alone cannot replace the host's earlier history in explicit OV mode.
    if (!hasArchives && (ctx?.stats?.totalArchives ?? 0) > 0) {
      logger.warn?.("openviking: archived context has no summary; keeping native history");
      return assemblePassthrough({
        diag, ovSessionId, reason: "archive_summary_missing", liveMessages: messages, originalTokens,
      });
    }

    if (!ctx || (!hasArchives && activeCount === 0)) {
      return assemblePassthrough({
        diag,
        ovSessionId,
        reason: "no_ov_data",
        liveMessages: messages,
        originalTokens,
        extra: { archiveCount: 0, activeCount: 0 },
      });
    }
    if (!hasArchives && ctx.messages.length < messages.length) {
      return assemblePassthrough({
        diag,
        ovSessionId,
        reason: "ov_msgs_fewer_than_input",
        liveMessages: messages,
        originalTokens,
        extra: { archiveCount: 0, activeCount },
      });
    }

    const { sanitized, archive, session, budgets, instruction } = buildAssembledContext(
      ctx.latest_archive_overview,
      preAbstracts,
      ctx.messages,
      tokenBudget,
      ovSessionId,
      logger,
      roughEstimate,
    );

    if (sanitized.length === 0 && messages.length > 0) {
      return assemblePassthrough({
        diag,
        ovSessionId,
        reason: "sanitized_empty",
        liveMessages: messages,
        originalTokens,
        extra: { archiveCount: preAbstracts.length, activeCount },
      });
    }

    const assembledTokens = roughEstimate(sanitized) + instruction.tokens;
    const tokensSaved = originalTokens - assembledTokens;
    const savingPct = originalTokens > 0 ? Math.round((tokensSaved / originalTokens) * 100) : 0;

    diag("assemble_result", ovSessionId, {
      passthrough: false,
      archiveCount: preAbstracts.length,
      activeCount,
      outputMessagesCount: sanitized.length,
      inputTokenEstimate: originalTokens,
      estimatedTokens: assembledTokens,
      tokensSaved,
      savingPct,
      archiveTokens: archive.tokens,
      archiveBudget: budgets.archiveMemory,
      sessionTokens: session.tokens,
      sessionBudget: budgets.sessionContext,
      reservedBudget: budgets.reserved,
      senderIdFound: sender.found,
      senderId: sender.senderId ?? null,
      messages: messageDigest(sanitized),
    });

    return {
      messages: sanitized,
      estimatedTokens: assembledTokens,
      ...(instruction.text ? { systemPromptAddition: instruction.text } : {}),
    };
  } catch (err) {
    if (isSessionNotFoundError(err)) {
      const errorMessage = String(err);
      logger.info(
        `openviking: session history not assembled because OV session does not exist ` +
          `(session=${ovSessionId}, tokenBudget=${tokenBudget}, agentId=${resolveAgentId(ovSessionId)})`,
      );
      return assemblePassthrough({
        diag,
        ovSessionId,
        reason: "session_not_found",
        liveMessages: messages,
        originalTokens,
        extra: {
          error: errorMessage,
          tokenBudget,
          agentId: resolveAgentId(ovSessionId),
          senderIdFound: sender.found,
          senderId: sender.senderId ?? null,
        },
      });
    }
    logger.warn?.(
      `openviking: assemble failed for session=${ovSessionId}, ` +
        `tokenBudget=${tokenBudget}, agentId=${resolveAgentId(ovSessionId)}: ${String(err)}`,
    );
    diag("assemble_error", ovSessionId, {
      error: String(err),
      tokenBudget,
      agentId: resolveAgentId(ovSessionId),
      senderIdFound: sender.found,
      senderId: sender.senderId ?? null,
    });
    return { messages, estimatedTokens: roughEstimate(messages) };
  }
}

function normalizeTimestamp(value: unknown): string | undefined {
  if (typeof value === "number" && Number.isFinite(value)) {
    const timestampMs = Math.abs(value) < 100_000_000_000 ? value * 1000 : value;
    return new Date(timestampMs).toISOString();
  }
  return undefined;
}

function pickLatestCreatedAt(messages: AgentMessage[]): string | undefined {
  for (let i = messages.length - 1; i >= 0; i -= 1) {
    const message = messages[i] as Record<string, unknown>;
    const role = typeof message.role === "string" ? message.role : "";
    if (!role || role === "system") {
      continue;
    }
    const normalized = normalizeTimestamp(message.timestamp);
    if (normalized) {
      return normalized;
    }
  }
  return undefined;
}

function extractRuntimeSenderId(runtimeContext: Record<string, unknown> | undefined): {
  found: boolean;
  senderId?: string;
} {
  if (runtimeContext) {
    const senderId = runtimeContext.senderId;
    if (typeof senderId === "string") {
      const trimmed = senderId.trim();
      if (trimmed) {
        return { found: true, senderId: trimmed };
      }
    }
  }
  return { found: false };
}

function extractRuntimeAgentId(runtimeContext: Record<string, unknown> | undefined): string | undefined {
  if (!runtimeContext) {
    return undefined;
  }
  const agentId = runtimeContext.agentId;
  return typeof agentId === "string" && agentId.trim() ? agentId.trim() : undefined;
}

function isToolOnlyMessage(msg: ExtractedTurnMessage): boolean {
  return msg.role === "assistant" && msg.parts.length > 0 && msg.parts.every((part) => part.type === "tool");
}

function coalesceConsecutiveToolMessages(messages: ExtractedTurnMessage[]): ExtractedTurnMessage[] {
  const result: ExtractedTurnMessage[] = [];
  let pendingTools: ExtractedTurnMessage | undefined;

  const flush = () => {
    if (pendingTools) {
      result.push(pendingTools);
      pendingTools = undefined;
    }
  };

  for (const msg of messages) {
    if (isToolOnlyMessage(msg)) {
      if (!pendingTools) {
        pendingTools = { role: "assistant", parts: [] };
      }
      pendingTools.parts.push(...msg.parts);
      continue;
    }
    flush();
    result.push(msg);
  }
  flush();
  return result;
}

function messageDigest(messages: AgentMessage[], maxCharsPerMsg = 2000): Array<{role: string; content: string; tokens: number; truncated: boolean}> {
  return messages.map((msg) => {
    const m = msg as Record<string, unknown>;
    const role = String(m.role ?? "unknown");
    const raw = m.content;
    let text: string;
    if (typeof raw === "string") {
      text = raw;
    } else if (Array.isArray(raw)) {
      text = (raw as Record<string, unknown>[])
        .map((b) => {
          if (b.type === "text") return String(b.text ?? "");
          if (b.type === "toolCall") return `[toolCall: ${String(b.name)}(${JSON.stringify(b.arguments ?? {}).slice(0, 200)})]`;
          if (b.type === "toolResult") return `[toolResult: ${JSON.stringify(b.content ?? "").slice(0, 200)}]`;
          return `[${String(b.type)}]`;
        })
        .join("\n");
    } else {
      text = JSON.stringify(raw) ?? "";
    }
    const truncated = text.length > maxCharsPerMsg;
    return {
      role,
      content: truncated ? text.slice(0, maxCharsPerMsg) + "..." : text,
      tokens: estimateAgentMessageTokens(msg),
      truncated,
    };
  });
}

export async function afterTurnOpenVikingSession({
  throwOnError = false,
  sessionId,
  sessionKey,
  messages: rawMessages,
  prePromptMessageCount,
  isHeartbeat,
  tokenBudget,
  runtimeContext,
  cfg,
  getClient,
  logger,
  resolveAgentId,
  rememberSessionAgentId,
  isBypassedSession,
  diag,
}: AfterTurnOpenVikingSessionParams): Promise<void> {
  if (!cfg.autoCapture) {
    return;
  }

  if (isHeartbeat) {
    return;
  }

  try {
    const sender = extractRuntimeSenderId(runtimeContext);
    const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
    const runtimeAgentId = extractRuntimeAgentId(runtimeContext);
    if (runtimeAgentId) {
      rememberSessionAgentId?.({
        agentId: runtimeAgentId,
        sessionId,
        sessionKey,
        ovSessionId,
      });
    }
    const routingRef = sessionId ?? sessionKey ?? ovSessionId;
    const agentId = resolveAgentId(routingRef, sessionKey, ovSessionId);

    if (isBypassedSession({ sessionId, sessionKey })) {
      diag("afterTurn_skip", ovSessionId, {
        reason: "session_bypassed",
        totalMessages: rawMessages?.length ?? 0,
        senderIdFound: sender.found,
        senderId: sender.senderId ?? null,
      });
      return;
    }

    const messages = rawMessages ?? [];
    if (messages.length === 0) {
      diag("afterTurn_skip", ovSessionId, {
        reason: "no_messages",
        totalMessages: 0,
        senderIdFound: sender.found,
        senderId: sender.senderId ?? null,
      });
      return;
    }

    const start =
      typeof prePromptMessageCount === "number" && prePromptMessageCount >= 0
        ? prePromptMessageCount
        : 0;

    const { messages: extractedMessagesRaw, newCount } = extractNewTurnMessages(messages, start);
    const extractedMessages = coalesceConsecutiveToolMessages(extractedMessagesRaw);

    if (extractedMessages.length === 0) {
      diag("afterTurn_skip", ovSessionId, {
        reason: "no_new_turn_messages",
        totalMessages: messages.length,
        prePromptMessageCount: start,
        senderIdFound: sender.found,
        senderId: sender.senderId ?? null,
      });
      return;
    }

    const turnMessages = messages.slice(start) as AgentMessage[];
    const newMessages = turnMessages.filter((m: AgentMessage) => {
      const role = (m as Record<string, unknown>).role as string;
      return role === "user" || role === "assistant";
    }) as AgentMessage[];
    const newMsgFull = messageDigest(newMessages);
    const newTurnTokens = newMsgFull.reduce((sum, digest) => sum + digest.tokens, 0);

    diag("afterTurn_entry", ovSessionId, {
      totalMessages: messages.length,
      newMessageCount: newCount,
      prePromptMessageCount: start,
      newTurnTokens,
      senderIdFound: sender.found,
      senderId: sender.senderId ?? null,
      messages: newMsgFull,
    });

    const client = await getClient();
    const createdAt = pickLatestCreatedAt(turnMessages);
    const senderRoleId = toRoleId(sender.senderId);
    for (const msg of extractedMessages) {
      const ovParts = msg.parts.map((part) => {
        if (part.type === "text") {
          const cleaned = part.text
            .replace(/<relevant-memories>[\s\S]*?<\/relevant-memories>/gi, " ")
            .replace(/\s+/g, " ")
            .trim();
          return { type: "text" as const, text: cleaned };
        }
        return {
          type: "tool" as const,
          tool_id: part.toolCallId,
          tool_name: part.toolName,
          tool_input: part.toolInput,
          tool_output: part.toolOutput,
          tool_status: part.toolStatus,
        };
      });

      if (ovParts.length > 0) {
        await client.addSessionMessage(
          ovSessionId,
          msg.role,
          ovParts,
          undefined,
          createdAt,
          resolveOpenVikingMessagePeerId({
            peerRole: cfg.peer_role ?? "none",
            role: msg.role,
            senderPeerId: senderRoleId,
            assistantPeerId: agentId,
          }),
        );
      }
    }

    const session = await client.getSession(ovSessionId);
    const pendingTokens = session.pending_tokens ?? 0;

    const commitTokenThreshold = Math.floor(tokenBudget * cfg.commitTokenThresholdRatio);

    if (pendingTokens < commitTokenThreshold) {
      diag("afterTurn_skip", ovSessionId, {
        reason: "below_threshold",
        pendingTokens,
        commitTokenThreshold,
        commitTokenThresholdRatio: cfg.commitTokenThresholdRatio,
        tokenBudget,
        senderIdFound: sender.found,
        senderId: sender.senderId ?? null,
      });
      return;
    }

    const commitResult = await client.commitSession(ovSessionId, {
      wait: false,
      ...(cfg.contextManagementMode === "openviking" ? { enableWorkingMemory: true } : {}),
      ...(cfg.commitRetentionMode === "turn_budget"
        ? { retentionMode: "turn_budget" as const }
        : { keepRecentCount: cfg.commitKeepRecentCount }),
    });
    logger.info(
      `openviking: committed session=${ovSessionId}, ` +
        `status=${commitResult.status}, archived=${commitResult.archived ?? false}, ` +
        `task_id=${commitResult.task_id ?? "none"}, trace_id=${commitResult.trace_id ?? "none"}`,
    );

    diag("afterTurn_commit", ovSessionId, {
      effectiveEnableWorkingMemory: commitResult.effective_enable_working_memory,
      pendingTokens,
      commitTokenThreshold,
      commitTokenThresholdRatio: cfg.commitTokenThresholdRatio,
      tokenBudget,
      status: commitResult.status,
      archived: commitResult.archived ?? false,
      taskId: commitResult.task_id ?? null,
      extractedMemories: totalExtractedMemories(commitResult.memories_extracted),
      senderIdFound: sender.found,
      senderId: sender.senderId ?? null,
    });
    if (commitResult.task_id && cfg.logFindRequests) {
      logger.info(
        `openviking: Phase2 memory extraction runs asynchronously on the server (task_id=${commitResult.task_id}). ` +
          "memories_extracted appears only after that task completes — not in this immediate response.",
      );
      void pollPhase2ExtractionOutcome(client, commitResult.task_id, logger, ovSessionId);
    }
  } catch (err) {
    logger.warn?.(`openviking: afterTurn failed: ${String(err)}`);
    const sender = extractRuntimeSenderId(runtimeContext);
    diag("afterTurn_error", sessionId ?? "(unknown)", {
      error: String(err),
      senderIdFound: sender.found,
      senderId: sender.senderId ?? null,
    });
    if (throwOnError) {
      throw err;
    }
  }
}

function validTokenCount(value: unknown): number | undefined {
  return typeof value === "number" && Number.isFinite(value) && value > 0
    ? value
    : undefined;
}

function compactFailureResult(
  reason: string,
  tokensBefore: number,
  details: unknown,
): CompactOpenVikingSessionResult {
  return {
    ok: false,
    compacted: false,
    reason,
    result: {
      summary: "",
      firstKeptEntryId: "",
      tokensBefore,
      tokensAfter: undefined,
      details,
    },
  };
}

export async function compactOpenVikingSession({
  contextManagementMode = "native",
  sessionId,
  sessionKey,
  tokenBudget,
  currentTokenCount,
  force,
  compactionTarget,
  customInstructions,
  getClient,
  logger,
  resolveAgentId,
  isBypassedSession,
  runtimeCompact,
  diag,
}: CompactOpenVikingSessionParams): Promise<CompactOpenVikingSessionResult> {
  const ovSessionId = openClawSessionToOvStorageId(sessionId, sessionKey);
  diag("compact_entry", ovSessionId, {
    tokenBudget,
    force: force ?? false,
    currentTokenCount: currentTokenCount ?? null,
    compactionTarget: compactionTarget ?? null,
    hasCustomInstructions: typeof customInstructions === "string" &&
      customInstructions.trim().length > 0,
  });

  if (isBypassedSession({ sessionId, sessionKey })) {
    // Bypassed sessions store nothing in OV, but the host still needs a real
    // compaction (preflight hard-fails on an unknown skip reason), so hand the
    // request to OpenClaw's native compactor.
    const delegated = await runtimeCompact?.();
    if (delegated) {
      diag("compact_result", ovSessionId, {
        ok: delegated.ok,
        compacted: delegated.compacted,
        reason: delegated.reason ?? "session_bypassed_runtime_compaction",
      });
      return delegated;
    }
    diag("compact_result", ovSessionId, {
      ok: true,
      compacted: false,
      reason: "session_bypassed",
    });
    return {
      ok: true,
      compacted: false,
      reason: "session_bypassed",
    };
  }

  if (contextManagementMode === "native") {
    return await runtimeCompact?.() ?? compactFailureResult(
      "native_compaction_unavailable", validTokenCount(currentTokenCount) ?? -1,
      { message: "Upgrade OpenClaw to a version with runtime compaction delegation." },
    );
  }

  const client = await getClient();
  const agentId = resolveAgentId(sessionId, sessionKey, ovSessionId);
  const tokensBeforeOriginal = validTokenCount(currentTokenCount);
  let preCommitEstimatedTokens: number | undefined;
  if (typeof tokensBeforeOriginal !== "number") {
    try {
      const preCtx = await client.getSessionContext(ovSessionId, tokenBudget);
      if (typeof preCtx.estimatedTokens === "number" && Number.isFinite(preCtx.estimatedTokens)) {
        preCommitEstimatedTokens = preCtx.estimatedTokens;
      }
    } catch (preCtxErr) {
      logger.info(
        `openviking: compact pre-ctx fetch failed for session=${ovSessionId}, ` +
          `tokenBudget=${tokenBudget}, agentId=${agentId}: ${String(preCtxErr)}`,
      );
    }
  }

  const tokensBefore = tokensBeforeOriginal ?? preCommitEstimatedTokens ?? -1;

  try {
    logger.info(
      `openviking: compact committing session=${ovSessionId} (wait=true, tokenBudget=${tokenBudget})`,
    );
    const commitResult = await client.commitSession(ovSessionId, {
      wait: true,
      keepRecentCount: 0,
      enableWorkingMemory: true,
    });
    const memCount = totalExtractedMemories(commitResult.memories_extracted);

    if (commitResult.status === "failed") {
      logger.warn?.(
        `openviking: compact commit Phase 2 failed for session=${ovSessionId}: ` +
          `${commitResult.error ?? "unknown"}, trace_id=${commitResult.trace_id ?? "none"}`,
      );
      diag("compact_result", ovSessionId, {
        ok: false,
        compacted: false,
        reason: "commit_failed",
        status: commitResult.status,
        archived: commitResult.archived ?? false,
        taskId: commitResult.task_id ?? null,
        error: commitResult.error ?? null,
      });
      return compactFailureResult("commit_failed", tokensBefore, { commit: commitResult });
    }

    if (commitResult.status === "timeout") {
      logger.warn?.(
        `openviking: compact commit Phase 2 timed out for session=${ovSessionId}, ` +
          `task_id=${commitResult.task_id ?? "none"}, trace_id=${commitResult.trace_id ?? "none"}`,
      );
      diag("compact_result", ovSessionId, {
        ok: false,
        compacted: false,
        reason: "commit_timeout",
        status: commitResult.status,
        archived: commitResult.archived ?? false,
        taskId: commitResult.task_id ?? null,
      });
      return compactFailureResult("commit_timeout", tokensBefore, { commit: commitResult });
    }

    logger.info(
      `openviking: compact committed session=${ovSessionId}, archived=${commitResult.archived ?? false}, memories=${memCount}, task_id=${commitResult.task_id ?? "none"}, trace_id=${commitResult.trace_id ?? "none"}`,
    );

    if (!commitResult.archived) {
      logger.info(
        `openviking: compact no archive for session=${ovSessionId}, ` +
          `tokensBefore=${tokensBefore}, tokensAfter=${tokensBefore}`,
      );
      diag("compact_result", ovSessionId, {
        ok: true,
        compacted: false,
        reason: "commit_no_archive",
        status: commitResult.status,
        archived: commitResult.archived ?? false,
        taskId: commitResult.task_id ?? null,
        memories: memCount,
        tokensBefore,
      });
      return {
        ok: true,
        compacted: false,
        reason: "commit_no_archive",
        result: {
          summary: "",
          tokensBefore,
          tokensAfter: tokensBefore >= 0 ? tokensBefore : undefined,
          details: {
            commit: commitResult,
          },
        },
      };
    }

    if (commitResult.effective_enable_working_memory !== true) {
      return await runtimeCompact?.() ?? compactFailureResult("working_memory_disabled", tokensBefore, { commit: commitResult });
    }

    let summary = "";
    const firstKeptEntryId = commitResult.archive_uri?.split("/").pop() ?? "";
    let tokensAfter: number | undefined;
    let contextFetchError: string | undefined;

    try {
      const ctx = await client.getSessionContext(ovSessionId, tokenBudget);
      logger.info(
        `openviking: compact getSessionContext raw result for ${ovSessionId}: ` +
          JSON.stringify(ctx, null, 2),
      );
      if (typeof ctx.latest_archive_overview === "string") {
        summary = ctx.latest_archive_overview.trim();
      }
      if (typeof ctx.estimatedTokens === "number" && Number.isFinite(ctx.estimatedTokens)) {
        tokensAfter = ctx.estimatedTokens;
      }
      logger.info(
        `openviking: compact restored session content for ${ovSessionId}: ` +
          `messages=${ctx.messages?.length ?? 0}, ` +
          `latestArchiveOverview=${summary.length > 0 ? "present" : "empty"} (${summary.length} chars), ` +
          `preArchiveAbstracts=${ctx.pre_archive_abstracts?.length ?? 0}, ` +
          `estimatedTokens=${ctx.estimatedTokens}`,
      );
      if (summary.length > 0) {
        logger.info(
          `openviking: compact latest_archive_overview for ${ovSessionId}: ${summary.substring(0, 200)}...`,
        );
      }
      if (ctx.messages && ctx.messages.length > 0) {
        const msgSummary = ctx.messages.map((m: { role?: string; content?: string; parts?: Array<{ type?: string; text?: string }> }) => {
          const role = m.role ?? "unknown";
          let textPreview = "";
          if (m.content) {
            textPreview = m.content.substring(0, 80);
          } else if (m.parts && m.parts.length > 0) {
            const textPart = m.parts.find((p: { type?: string }) => p.type === "text");
            textPreview = textPart?.text?.substring(0, 80) ?? JSON.stringify(m.parts).substring(0, 80);
          }
          return { role, textPreview };
        });
        logger.info(
          `openviking: compact restored messages for ${ovSessionId}: ` +
            JSON.stringify(msgSummary),
        );
      }
    } catch (ctxErr) {
      contextFetchError = String(ctxErr);
      logger.info(
        `openviking: compact context fetch failed for session=${ovSessionId}, ` +
          `tokenBudget=${tokenBudget}, agentId=${agentId}: ${contextFetchError}`,
      );
    }

    logger.info(
      `openviking: compact tokens session=${ovSessionId}, ` +
        `tokensBefore=${tokensBefore}, tokensAfter=${tokensAfter ?? "unknown"}, ` +
        `latestArchiveId=${firstKeptEntryId || "none"}`,
    );

    if (!summary) {
      return await runtimeCompact?.() ?? compactFailureResult("archive_summary_missing", tokensBefore, { commit: commitResult });
    }

    diag("compact_result", ovSessionId, {
      ok: true,
      compacted: true,
      reason: "commit_completed",
      status: commitResult.status,
      archived: commitResult.archived ?? false,
      taskId: commitResult.task_id ?? null,
      memories: memCount,
      tokensBefore,
      tokensAfter: tokensAfter ?? null,
      latestArchiveId: firstKeptEntryId || null,
      summaryPresent: summary.length > 0,
    });

    return {
      ok: true,
      compacted: true,
      reason: "commit_completed",
      result: {
        summary,
        firstKeptEntryId,
        tokensBefore,
        tokensAfter,
        details: contextFetchError
          ? {
              commit: commitResult,
              contextError: contextFetchError,
            }
          : {
              commit: commitResult,
            },
      },
    };
  } catch (err) {
    const errorMessage = String(err);
    if (isSessionNotFoundError(err)) {
      logger.info(
        `openviking: compact skipped because OV session does not exist ` +
          `(session=${ovSessionId}, agentId=${agentId})`,
      );
      diag("compact_result", ovSessionId, {
        ok: true,
        compacted: false,
        reason: "session_not_found",
        error: errorMessage,
      });
      return {
        ok: true,
        compacted: false,
        reason: "session_not_found",
      };
    }
    logger.warn?.(`openviking: compact commit failed for session=${ovSessionId}: ${errorMessage}`);
    diag("compact_error", ovSessionId, {
      error: errorMessage,
    });
    return compactFailureResult("commit_error", tokensBefore, { error: errorMessage });
  }
}