/**

* Updates persisted session metadata after agent command runs.

*/

import path from "node:path";

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import {

canonicalizeAbsoluteSessionFilePath,

resolveSessionFilePath,

resolveSessionFilePathOptions,

resolveCompactionSessionFile,

setSessionRuntimeModel,

type SessionEntry,

rewriteSessionFileForNewSessionId,

} from "../../config/sessions.js";

import { patchSessionEntry } from "../../config/sessions/session-accessor.js";

import { resolveMaintenanceConfigFromInput } from "../../config/sessions/store-maintenance.js";

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import { resolveAgentIdFromSessionKey } from "../../routing/session-key.js";

import { createLazyImportLoader } from "../../shared/lazy-promise.js";

import { clearCliSession, setCliSessionBinding, setCliSessionId } from "../cli-session.js";

import { DEFAULT_CONTEXT_TOKENS } from "../defaults.js";

}

return persisted ?? undefined;

}

function resolveCompactionSessionFile(params: {

entry: SessionEntry;

sessionKey: string;

storePath?: string;

newSessionId: string;

}): string {

const agentId = resolveAgentIdFromSessionKey(params.sessionKey);

const pathOpts = resolveSessionFilePathOptions({

agentId,

storePath: params.storePath,

});

const rewrittenSessionFile = rewriteSessionFileForNewSessionId({

sessionFile: params.entry.sessionFile,

previousSessionId: params.entry.sessionId,

nextSessionId: params.newSessionId,

});

const normalizedRewrittenSessionFile =

rewrittenSessionFile && path.isAbsolute(rewrittenSessionFile)

? canonicalizeAbsoluteSessionFilePath(rewrittenSessionFile)

: rewrittenSessionFile;

return resolveSessionFilePath(

params.newSessionId,

normalizedRewrittenSessionFile ? { sessionFile: normalizedRewrittenSessionFile } : undefined,

pathOpts,

);

}

/** Session update helpers for skill snapshots, compaction, and lifecycle hooks. */

import crypto from "node:crypto";

import path from "node:path";

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import { resolveSessionAgentId } from "../../agents/agent-scope.js";

import { canExecRequestNode } from "../../agents/exec-defaults.js";

import {

canonicalizeAbsoluteSessionFilePath,

resolveSessionFilePath,

resolveSessionFilePathOptions,

rewriteSessionFileForNewSessionId,

resolveCompactionSessionFile,

type SessionEntry,

} from "../../config/sessions.js";

import { patchSessionEntry, upsertSessionEntry } from "../../config/sessions/session-accessor.js";

}

return nextCount;

}

function resolveCompactionSessionFile(params: {

entry: SessionEntry;

sessionKey: string;

storePath?: string;

newSessionId: string;

}): string {

const agentId = resolveAgentIdFromSessionKey(params.sessionKey);

const pathOpts = resolveSessionFilePathOptions({

agentId,

storePath: params.storePath,

});

const rewrittenSessionFile = rewriteSessionFileForNewSessionId({

sessionFile: params.entry.sessionFile,

previousSessionId: params.entry.sessionId,

nextSessionId: params.newSessionId,

});

const normalizedRewrittenSessionFile =

rewrittenSessionFile && path.isAbsolute(rewrittenSessionFile)

? canonicalizeAbsoluteSessionFilePath(rewrittenSessionFile)

: rewrittenSessionFile;

return resolveSessionFilePath(

params.newSessionId,

normalizedRewrittenSessionFile ? { sessionFile: normalizedRewrittenSessionFile } : undefined,

pathOpts,

);

}

// Public facade for session stores, metadata, lifecycle, reset, transcript, and cleanup APIs.

export * from "./sessions/combined-store-gateway.js";

export * from "./sessions/compaction-session-file.js";

export * from "./sessions/group.js";

export * from "./sessions/goals.js";

export * from "./sessions/artifacts.js";

// Compaction session-file rotation shares the same owner as session path resolution.

import path from "node:path";

import { resolveAgentIdFromSessionKey } from "../../routing/session-key.js";

import { resolveSessionFilePath, resolveSessionFilePathOptions } from "./paths.js";

import {

canonicalizeAbsoluteSessionFilePath,

rewriteSessionFileForNewSessionId,

} from "./session-file-rotation.js";

import type { SessionEntry } from "./types.js";

export function resolveCompactionSessionFile(params: {

entry: SessionEntry;

sessionKey: string;

storePath?: string;

newSessionId: string;

}): string {

const agentId = resolveAgentIdFromSessionKey(params.sessionKey);

const pathOpts = resolveSessionFilePathOptions({

agentId,

storePath: params.storePath,

});

const rewrittenSessionFile = rewriteSessionFileForNewSessionId({

sessionFile: params.entry.sessionFile,

previousSessionId: params.entry.sessionId,

nextSessionId: params.newSessionId,

});

const normalizedRewrittenSessionFile =

rewrittenSessionFile && path.isAbsolute(rewrittenSessionFile)

? canonicalizeAbsoluteSessionFilePath(rewrittenSessionFile)

: rewrittenSessionFile;

return resolveSessionFilePath(

params.newSessionId,

normalizedRewrittenSessionFile ? { sessionFile: normalizedRewrittenSessionFile } : undefined,

pathOpts,

);

}

// Session goal state tracks objective progress and token budgets in the session store.

import crypto from "node:crypto";

import { formatTokenCount } from "../../utils/token-format.js";

import { getSessionEntry, patchSessionEntry } from "./store.js";

import { resolveFreshSessionTotalTokens } from "./types.js";

import type { SessionEntry, SessionGoal, SessionGoalStatus } from "./types.js";

return { ...goal };

}

function formatGoalTokenCount(value: number | undefined): string {

if (value === undefined || !Number.isFinite(value)) {

return "0";

}

const safe = Math.max(0, value);

if (safe >= 1_000_000) {

return `${(safe / 1_000_000).toFixed(1)}m`;

}

if (safe >= 1_000) {

const precision = safe >= 10_000 ? 0 : 1;

const formattedThousands = (safe / 1_000).toFixed(precision);

if (Number(formattedThousands) >= 1_000) {

return `${(safe / 1_000_000).toFixed(1)}m`;

}

return `${formattedThousands}k`;

}

return String(Math.round(safe));

}

export function resolveSessionGoalDisplayState(

entry: Pick<SessionEntry, "goal" | "totalTokens" | "totalTokensFresh">,

now?: number,

const budget =

goal.tokenBudget === undefined

? ""

: `\nToken budget: ${formatGoalTokenCount(goal.tokensUsed)}/${formatGoalTokenCount(goal.tokenBudget)}`;

: `\nToken budget: ${formatTokenCount(goal.tokensUsed)}/${formatTokenCount(goal.tokenBudget)}`;

const note = goal.lastStatusNote ? `\nNote: ${goal.lastStatusNote}` : "";

const commands = resolveGoalCommandHint(goal.status);

return [

"Goal",

`Status: ${goal.status}`,

`Objective: ${goal.objective}`,

`Tokens used: ${formatGoalTokenCount(goal.tokensUsed)}`,

`Tokens used: ${formatTokenCount(goal.tokensUsed)}`,

...(budget ? [budget.slice(1)] : []),

...(note ? [note.slice(1)] : []),

"",