@xopcai/xopc 0.0.95 → 0.0.97

package/dist/src/session/resolve-session.d.ts

@@ -1,20 +1,17 @@
 import { type Config } from '../config/schema.js';
 import { type ThinkLevel, type VerboseLevel } from '../agent/transcript/thinking-types.js';
-import type { XopcSessionDiskEntry } from './parity/xopc-session-disk-entry.js';
+import type { SessionMetadata } from './types.js';
 export type SessionResolution = {
     sessionId: string;
     sessionKey?: string;
-    sessionEntry?: XopcSessionDiskEntry;
-    sessionStore: Record<string, XopcSessionDiskEntry>;
-    storePath: string;
+    sessionMetadata?: SessionMetadata | null;
     isNewSession: boolean;
     persistedThinking?: ThinkLevel;
     persistedVerbose?: VerboseLevel;
 };
 export type SessionKeyResolution = {
     sessionKey?: string;
-    sessionStore: Record<string, XopcSessionDiskEntry>;
-    storePath: string;
+    sessionMetadata?: SessionMetadata | null;
 };
 export declare function resolveSessionKeyForRequest(opts: {
     cfg: Config;

package/dist/src/session/resolve-session.js

@@ -1,11 +1,12 @@
-import { SessionConfigSchema, init_schema } from "../config/schema.js";
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { SessionConfigSchema, init_schema } from "../config/schema.js";
 import { init_agent_session_key, normalizeAgentId, resolveAgentIdFromSessionKey } from "../routing/agent-session-key.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
-import { createLogger } from "../utils/logger/index.js";
-import { init_logger } from "../utils/logger.js";
-import { init_paths, resolveSessionsMapPath } from "../config/paths.js";
-import { readSessionsJsonFile } from "./parity/sessions-json-file.js";
+import { requireXopcDatabase } from "../storage/sqlite/connection.js";
+import { findSessionKeyByTranscriptId, getSessionMetadata, getSessionPersistedLevels } from "../storage/sqlite/session-repository.js";
+import "../storage/sqlite/index.js";
 import { normalizeThinkLevel, normalizeVerboseLevel } from "../agent/transcript/thinking-types.js";
 import { evaluateSessionFreshness, resolveSessionResetPolicy } from "./reset-policy.js";
 import { resolveChannelResetConfig, resolveSessionResetType } from "./reset-type.js";
@@ -13,38 +14,31 @@ import { resolveSessionLifecycleTimestamps } from "./lifecycle-timestamps.js";
 import { randomUUID } from "node:crypto";
 //#region src/session/resolve-session.ts
 init_schema();
-init_paths();
 init_agent_scope();
 init_agent_session_key();
 init_session_key();
 init_logger();
 const log = createLogger("ResolveSession");
 async function resolveSessionKeyForRequest(opts) {
-	const defaultAgentId = resolveDefaultAgentId(opts.cfg);
+	requireXopcDatabase();
 	const explicitKey = opts.sessionKey?.trim();
 	const requestedSessionId = opts.sessionId?.trim();
-	const storeAgentId = explicitKey ? resolveAgentIdFromSessionKey(explicitKey) : opts.agentId?.trim() ? normalizeAgentId(opts.agentId) : defaultAgentId;
-	const storePath = resolveSessionsMapPath(opts.cfg, storeAgentId);
-	const sessionStore = await readSessionsJsonFile(storePath);
 	let sessionKey = explicitKey;
+	if (requestedSessionId && !sessionKey) sessionKey = findSessionKeyByTranscriptId(requestedSessionId) ?? void 0;
 	if (requestedSessionId && !sessionKey) {
-		for (const [key, entry] of Object.entries(sessionStore)) if (entry?.sessionId === requestedSessionId) {
-			sessionKey = key;
-			break;
-		}
+		const storeAgentId = explicitKey ? resolveAgentIdFromSessionKey(explicitKey) : opts.agentId?.trim() ? normalizeAgentId(opts.agentId) : resolveDefaultAgentId(opts.cfg);
+		sessionKey = `agent:${normalizeAgentId(opts.agentId ?? storeAgentId)}:explicit:${requestedSessionId}`;
 	}
-	if (requestedSessionId && !sessionKey) sessionKey = `agent:${normalizeAgentId(opts.agentId ?? storeAgentId)}:explicit:${requestedSessionId}`;
+	const sessionMetadata = sessionKey ? getSessionMetadata(sessionKey) : null;
 	return {
 		sessionKey,
-		sessionStore,
-		storePath
+		sessionMetadata
 	};
 }
 async function resolveSession(opts) {
 	const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});
-	const { sessionKey, sessionStore, storePath } = await resolveSessionKeyForRequest(opts);
+	const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest(opts);
 	const now = Date.now();
-	const sessionEntry = sessionKey ? sessionStore[sessionKey] : void 0;
 	const parsed = sessionKey ? parseSessionKey(sessionKey) : null;
 	const peerKind = parsed?.peerKind;
 	const resetType = resolveSessionResetType({
@@ -52,39 +46,40 @@ async function resolveSession(opts) {
 		isGroup: peerKind === "group" || peerKind === "channel",
 		isThread: Boolean(parsed?.threadId)
 	});
-	const meta = sessionEntry?.pluginExtensions?.xopc?.metadata;
 	const resetPolicy = resolveSessionResetPolicy({
 		sessionCfg,
 		resetType,
 		resetOverride: resolveChannelResetConfig({
 			sessionCfg,
-			channel: parsed?.source ?? meta?.sourceChannel
+			channel: parsed?.source ?? sessionMetadata?.sourceChannel
 		})
 	});
-	const lifecycle = resolveSessionLifecycleTimestamps({ entry: sessionEntry });
-	const fresh = (sessionEntry ? evaluateSessionFreshness({
-		updatedAt: sessionEntry.updatedAt,
+	const lifecycle = resolveSessionLifecycleTimestamps({ entry: sessionMetadata ? {
+		updatedAt: Date.parse(sessionMetadata.updatedAt),
+		sessionStartedAt: sessionMetadata.sessionStartedAt ? Date.parse(sessionMetadata.sessionStartedAt) : void 0,
+		lastInteractionAt: sessionMetadata.lastInteractionAt ? Date.parse(sessionMetadata.lastInteractionAt) : void 0
+	} : void 0 });
+	const fresh = (sessionMetadata ? evaluateSessionFreshness({
+		updatedAt: Date.parse(sessionMetadata.updatedAt),
 		...lifecycle,
 		now,
 		policy: resetPolicy
 	}) : { fresh: false }).fresh;
-	const sessionId = opts.sessionId?.trim() || (fresh ? sessionEntry?.sessionId : void 0) || randomUUID();
+	const sessionId = opts.sessionId?.trim() || (fresh ? sessionMetadata?.transcriptId : void 0) || randomUUID();
 	const isNewSession = !fresh && !opts.sessionId?.trim();
 	if (isNewSession && sessionKey) log.debug({
 		sessionKey,
-		previousSessionId: sessionEntry?.sessionId,
+		previousSessionId: sessionMetadata?.transcriptId,
 		sessionId,
 		resetType
 	}, "Session reset boundary — new transcript id for turn");
 	return {
 		sessionId,
 		sessionKey,
-		sessionEntry,
-		sessionStore,
-		storePath,
+		sessionMetadata,
 		isNewSession,
-		persistedThinking: fresh && sessionEntry?.thinkingLevel ? normalizeThinkLevel(sessionEntry.thinkingLevel) : void 0,
-		persistedVerbose: fresh && sessionEntry?.verboseLevel ? normalizeVerboseLevel(sessionEntry.verboseLevel) : void 0
+		persistedThinking: fresh && sessionKey ? normalizeThinkLevel(getSessionPersistedLevels(sessionKey)?.thinkingLevel ?? void 0) : void 0,
+		persistedVerbose: fresh && sessionKey ? normalizeVerboseLevel(getSessionPersistedLevels(sessionKey)?.verboseLevel ?? void 0) : void 0
 	};
 }
 //#endregion

package/dist/src/session/resolve-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-session.js","names":[],"sources":["../../../src/session/resolve-session.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { SessionConfigSchema, type Config } from '../config/schema.js';\nimport { resolveSessionsMapPath } from '../config/paths.js';\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport {\n  normalizeAgentId,\n  resolveAgentIdFromSessionKey,\n} from '../routing/agent-session-key.js';\nimport { parseSessionKey } from '../routing/session-key.js';\nimport {\n  normalizeThinkLevel,\n  normalizeVerboseLevel,\n  type ThinkLevel,\n  type VerboseLevel,\n} from '../agent/transcript/thinking-types.js';\nimport { createLogger } from '../utils/logger.js';\n\nimport { resolveSessionLifecycleTimestamps } from './lifecycle-timestamps.js';\nimport { readSessionsJsonFile } from './parity/sessions-json-file.js';\nimport type { XopcSessionDiskEntry } from './parity/xopc-session-disk-entry.js';\nimport {\n  evaluateSessionFreshness,\n  resolveSessionResetPolicy,\n} from './reset-policy.js';\nimport { resolveChannelResetConfig, resolveSessionResetType } from './reset-type.js';\n\nconst log = createLogger('ResolveSession');\n\nexport type SessionResolution = {\n  sessionId: string;\n  sessionKey?: string;\n  sessionEntry?: XopcSessionDiskEntry;\n  sessionStore: Record<string, XopcSessionDiskEntry>;\n  storePath: string;\n  isNewSession: boolean;\n  persistedThinking?: ThinkLevel;\n  persistedVerbose?: VerboseLevel;\n};\n\nexport type SessionKeyResolution = {\n  sessionKey?: string;\n  sessionStore: Record<string, XopcSessionDiskEntry>;\n  storePath: string;\n};\n\nexport async function resolveSessionKeyForRequest(opts: {\n  cfg: Config;\n  sessionKey?: string;\n  sessionId?: string;\n  agentId?: string;\n}): Promise<SessionKeyResolution> {\n  const defaultAgentId = resolveDefaultAgentId(opts.cfg);\n  const explicitKey = opts.sessionKey?.trim();\n  const requestedSessionId = opts.sessionId?.trim();\n  const storeAgentId = explicitKey\n    ? resolveAgentIdFromSessionKey(explicitKey)\n    : opts.agentId?.trim()\n      ? normalizeAgentId(opts.agentId)\n      : defaultAgentId;\n  const storePath = resolveSessionsMapPath(opts.cfg, storeAgentId);\n  const sessionStore = await readSessionsJsonFile<XopcSessionDiskEntry>(storePath);\n\n  let sessionKey = explicitKey;\n  if (requestedSessionId && !sessionKey) {\n    for (const [key, entry] of Object.entries(sessionStore)) {\n      if (entry?.sessionId === requestedSessionId) {\n        sessionKey = key;\n        break;\n      }\n    }\n  }\n  if (requestedSessionId && !sessionKey) {\n    sessionKey = `agent:${normalizeAgentId(opts.agentId ?? storeAgentId)}:explicit:${requestedSessionId}`;\n  }\n\n  return { sessionKey, sessionStore, storePath };\n}\n\nexport async function resolveSession(opts: {\n  cfg: Config;\n  sessionKey?: string;\n  sessionId?: string;\n  agentId?: string;\n}): Promise<SessionResolution> {\n  const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});\n  const { sessionKey, sessionStore, storePath } = await resolveSessionKeyForRequest(opts);\n  const now = Date.now();\n  const sessionEntry = sessionKey ? sessionStore[sessionKey] : undefined;\n\n  const parsed = sessionKey ? parseSessionKey(sessionKey) : null;\n  const peerKind = parsed?.peerKind;\n  const resetType = resolveSessionResetType({\n    sessionKey,\n    isGroup: peerKind === 'group' || peerKind === 'channel',\n    isThread: Boolean(parsed?.threadId),\n  });\n  const meta = sessionEntry?.pluginExtensions?.xopc?.metadata;\n  const channelReset = resolveChannelResetConfig({\n    sessionCfg,\n    channel: parsed?.source ?? meta?.sourceChannel,\n  });\n  const resetPolicy = resolveSessionResetPolicy({\n    sessionCfg,\n    resetType,\n    resetOverride: channelReset,\n  });\n  const lifecycle = resolveSessionLifecycleTimestamps({ entry: sessionEntry });\n  const freshness = sessionEntry\n    ? evaluateSessionFreshness({\n        updatedAt: sessionEntry.updatedAt,\n        ...lifecycle,\n        now,\n        policy: resetPolicy,\n      })\n    : { fresh: false };\n  const fresh = freshness.fresh;\n  const sessionId =\n    opts.sessionId?.trim() || (fresh ? sessionEntry?.sessionId : undefined) || randomUUID();\n  const isNewSession = !fresh && !opts.sessionId?.trim();\n\n  if (isNewSession && sessionKey) {\n    log.debug(\n      { sessionKey, previousSessionId: sessionEntry?.sessionId, sessionId, resetType },\n      'Session reset boundary — new transcript id for turn',\n    );\n  }\n\n  const persistedThinking =\n    fresh && sessionEntry?.thinkingLevel\n      ? normalizeThinkLevel(sessionEntry.thinkingLevel)\n      : undefined;\n  const persistedVerbose =\n    fresh && sessionEntry?.verboseLevel\n      ? normalizeVerboseLevel(sessionEntry.verboseLevel)\n      : undefined;\n\n  return {\n    sessionId,\n    sessionKey,\n    sessionEntry,\n    sessionStore,\n    storePath,\n    isNewSession,\n    persistedThinking,\n    persistedVerbose,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;aAEuE;YACX;kBACI;wBAIvB;kBACmB;aAOV;AAWlD,MAAM,MAAM,aAAa,iBAAiB;AAmB1C,eAAsB,4BAA4B,MAKhB;CAChC,MAAM,iBAAiB,sBAAsB,KAAK,IAAI;CACtD,MAAM,cAAc,KAAK,YAAY,MAAM;CAC3C,MAAM,qBAAqB,KAAK,WAAW,MAAM;CACjD,MAAM,eAAe,cACjB,6BAA6B,YAAY,GACzC,KAAK,SAAS,MAAM,GAClB,iBAAiB,KAAK,QAAQ,GAC9B;CACN,MAAM,YAAY,uBAAuB,KAAK,KAAK,aAAa;CAChE,MAAM,eAAe,MAAM,qBAA2C,UAAU;CAEhF,IAAI,aAAa;AACjB,KAAI,sBAAsB,CAAC;OACpB,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,CACrD,KAAI,OAAO,cAAc,oBAAoB;AAC3C,gBAAa;AACb;;;AAIN,KAAI,sBAAsB,CAAC,WACzB,cAAa,SAAS,iBAAiB,KAAK,WAAW,aAAa,CAAC,YAAY;AAGnF,QAAO;EAAE;EAAY;EAAc;EAAW;;AAGhD,eAAsB,eAAe,MAKN;CAC7B,MAAM,aAAa,KAAK,IAAI,WAAW,oBAAoB,MAAM,EAAE,CAAC;CACpE,MAAM,EAAE,YAAY,cAAc,cAAc,MAAM,4BAA4B,KAAK;CACvF,MAAM,MAAM,KAAK,KAAK;CACtB,MAAM,eAAe,aAAa,aAAa,cAAc,KAAA;CAE7D,MAAM,SAAS,aAAa,gBAAgB,WAAW,GAAG;CAC1D,MAAM,WAAW,QAAQ;CACzB,MAAM,YAAY,wBAAwB;EACxC;EACA,SAAS,aAAa,WAAW,aAAa;EAC9C,UAAU,QAAQ,QAAQ,SAAS;EACpC,CAAC;CACF,MAAM,OAAO,cAAc,kBAAkB,MAAM;CAKnD,MAAM,cAAc,0BAA0B;EAC5C;EACA;EACA,eAPmB,0BAA0B;GAC7C;GACA,SAAS,QAAQ,UAAU,MAAM;GAClC,CAI4B;EAC5B,CAAC;CACF,MAAM,YAAY,kCAAkC,EAAE,OAAO,cAAc,CAAC;CAS5E,MAAM,SARY,eACd,yBAAyB;EACvB,WAAW,aAAa;EACxB,GAAG;EACH;EACA,QAAQ;EACT,CAAC,GACF,EAAE,OAAO,OAAO,EACI;CACxB,MAAM,YACJ,KAAK,WAAW,MAAM,KAAK,QAAQ,cAAc,YAAY,KAAA,MAAc,YAAY;CACzF,MAAM,eAAe,CAAC,SAAS,CAAC,KAAK,WAAW,MAAM;AAEtD,KAAI,gBAAgB,WAClB,KAAI,MACF;EAAE;EAAY,mBAAmB,cAAc;EAAW;EAAW;EAAW,EAChF,sDACD;AAYH,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA,mBAfA,SAAS,cAAc,gBACnB,oBAAoB,aAAa,cAAc,GAC/C,KAAA;EAcJ,kBAZA,SAAS,cAAc,eACnB,sBAAsB,aAAa,aAAa,GAChD,KAAA;EAWL"}
+{"version":3,"file":"resolve-session.js","names":[],"sources":["../../../src/session/resolve-session.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { SessionConfigSchema, type Config } from '../config/schema.js';\nimport { resolveDefaultAgentId } from '../agent/agent-scope.js';\nimport {\n  normalizeAgentId,\n  resolveAgentIdFromSessionKey,\n} from '../routing/agent-session-key.js';\nimport { parseSessionKey } from '../routing/session-key.js';\nimport {\n  normalizeThinkLevel,\n  normalizeVerboseLevel,\n  type ThinkLevel,\n  type VerboseLevel,\n} from '../agent/transcript/thinking-types.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  findSessionKeyByTranscriptId,\n  getSessionMetadata,\n  getSessionPersistedLevels,\n  requireXopcDatabase,\n} from '../storage/sqlite/index.js';\n\nimport { resolveSessionLifecycleTimestamps } from './lifecycle-timestamps.js';\nimport {\n  evaluateSessionFreshness,\n  resolveSessionResetPolicy,\n} from './reset-policy.js';\nimport { resolveChannelResetConfig, resolveSessionResetType } from './reset-type.js';\nimport type { SessionMetadata } from './types.js';\n\nconst log = createLogger('ResolveSession');\n\nexport type SessionResolution = {\n  sessionId: string;\n  sessionKey?: string;\n  sessionMetadata?: SessionMetadata | null;\n  isNewSession: boolean;\n  persistedThinking?: ThinkLevel;\n  persistedVerbose?: VerboseLevel;\n};\n\nexport type SessionKeyResolution = {\n  sessionKey?: string;\n  sessionMetadata?: SessionMetadata | null;\n};\n\nexport async function resolveSessionKeyForRequest(opts: {\n  cfg: Config;\n  sessionKey?: string;\n  sessionId?: string;\n  agentId?: string;\n}): Promise<SessionKeyResolution> {\n  requireXopcDatabase();\n  const explicitKey = opts.sessionKey?.trim();\n  const requestedSessionId = opts.sessionId?.trim();\n\n  let sessionKey = explicitKey;\n  if (requestedSessionId && !sessionKey) {\n    sessionKey = findSessionKeyByTranscriptId(requestedSessionId) ?? undefined;\n  }\n  if (requestedSessionId && !sessionKey) {\n    const storeAgentId = explicitKey\n      ? resolveAgentIdFromSessionKey(explicitKey)\n      : opts.agentId?.trim()\n        ? normalizeAgentId(opts.agentId)\n        : resolveDefaultAgentId(opts.cfg);\n    sessionKey = `agent:${normalizeAgentId(opts.agentId ?? storeAgentId)}:explicit:${requestedSessionId}`;\n  }\n\n  const sessionMetadata = sessionKey ? getSessionMetadata(sessionKey) : null;\n  return { sessionKey, sessionMetadata };\n}\n\nexport async function resolveSession(opts: {\n  cfg: Config;\n  sessionKey?: string;\n  sessionId?: string;\n  agentId?: string;\n}): Promise<SessionResolution> {\n  const sessionCfg = opts.cfg.session ?? SessionConfigSchema.parse({});\n  const { sessionKey, sessionMetadata } = await resolveSessionKeyForRequest(opts);\n  const now = Date.now();\n\n  const parsed = sessionKey ? parseSessionKey(sessionKey) : null;\n  const peerKind = parsed?.peerKind;\n  const resetType = resolveSessionResetType({\n    sessionKey,\n    isGroup: peerKind === 'group' || peerKind === 'channel',\n    isThread: Boolean(parsed?.threadId),\n  });\n  const channelReset = resolveChannelResetConfig({\n    sessionCfg,\n    channel: parsed?.source ?? sessionMetadata?.sourceChannel,\n  });\n  const resetPolicy = resolveSessionResetPolicy({\n    sessionCfg,\n    resetType,\n    resetOverride: channelReset,\n  });\n  const lifecycle = resolveSessionLifecycleTimestamps({\n    entry: sessionMetadata\n      ? {\n          updatedAt: Date.parse(sessionMetadata.updatedAt),\n          sessionStartedAt: sessionMetadata.sessionStartedAt\n            ? Date.parse(sessionMetadata.sessionStartedAt)\n            : undefined,\n          lastInteractionAt: sessionMetadata.lastInteractionAt\n            ? Date.parse(sessionMetadata.lastInteractionAt)\n            : undefined,\n        }\n      : undefined,\n  });\n  const freshness = sessionMetadata\n    ? evaluateSessionFreshness({\n        updatedAt: Date.parse(sessionMetadata.updatedAt),\n        ...lifecycle,\n        now,\n        policy: resetPolicy,\n      })\n    : { fresh: false };\n  const fresh = freshness.fresh;\n  const sessionId =\n    opts.sessionId?.trim() || (fresh ? sessionMetadata?.transcriptId : undefined) || randomUUID();\n  const isNewSession = !fresh && !opts.sessionId?.trim();\n\n  if (isNewSession && sessionKey) {\n    log.debug(\n      { sessionKey, previousSessionId: sessionMetadata?.transcriptId, sessionId, resetType },\n      'Session reset boundary — new transcript id for turn',\n    );\n  }\n\n  const persistedThinking =\n    fresh && sessionKey\n      ? normalizeThinkLevel(getSessionPersistedLevels(sessionKey)?.thinkingLevel ?? undefined)\n      : undefined;\n  const persistedVerbose =\n    fresh && sessionKey\n      ? normalizeVerboseLevel(getSessionPersistedLevels(sessionKey)?.verboseLevel ?? undefined)\n      : undefined;\n\n  return {\n    sessionId,\n    sessionKey,\n    sessionMetadata,\n    isNewSession,\n    persistedThinking,\n    persistedVerbose,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;aAEuE;kBACP;wBAIvB;kBACmB;aAOV;AAgBlD,MAAM,MAAM,aAAa,iBAAiB;AAgB1C,eAAsB,4BAA4B,MAKhB;AAChC,sBAAqB;CACrB,MAAM,cAAc,KAAK,YAAY,MAAM;CAC3C,MAAM,qBAAqB,KAAK,WAAW,MAAM;CAEjD,IAAI,aAAa;AACjB,KAAI,sBAAsB,CAAC,WACzB,cAAa,6BAA6B,mBAAmB,IAAI,KAAA;AAEnE,KAAI,sBAAsB,CAAC,YAAY;EACrC,MAAM,eAAe,cACjB,6BAA6B,YAAY,GACzC,KAAK,SAAS,MAAM,GAClB,iBAAiB,KAAK,QAAQ,GAC9B,sBAAsB,KAAK,IAAI;AACrC,eAAa,SAAS,iBAAiB,KAAK,WAAW,aAAa,CAAC,YAAY;;CAGnF,MAAM,kBAAkB,aAAa,mBAAmB,WAAW,GAAG;AACtE,QAAO;EAAE;EAAY;EAAiB;;AAGxC,eAAsB,eAAe,MAKN;CAC7B,MAAM,aAAa,KAAK,IAAI,WAAW,oBAAoB,MAAM,EAAE,CAAC;CACpE,MAAM,EAAE,YAAY,oBAAoB,MAAM,4BAA4B,KAAK;CAC/E,MAAM,MAAM,KAAK,KAAK;CAEtB,MAAM,SAAS,aAAa,gBAAgB,WAAW,GAAG;CAC1D,MAAM,WAAW,QAAQ;CACzB,MAAM,YAAY,wBAAwB;EACxC;EACA,SAAS,aAAa,WAAW,aAAa;EAC9C,UAAU,QAAQ,QAAQ,SAAS;EACpC,CAAC;CAKF,MAAM,cAAc,0BAA0B;EAC5C;EACA;EACA,eAPmB,0BAA0B;GAC7C;GACA,SAAS,QAAQ,UAAU,iBAAiB;GAC7C,CAI4B;EAC5B,CAAC;CACF,MAAM,YAAY,kCAAkC,EAClD,OAAO,kBACH;EACE,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,kBAAkB,gBAAgB,mBAC9B,KAAK,MAAM,gBAAgB,iBAAiB,GAC5C,KAAA;EACJ,mBAAmB,gBAAgB,oBAC/B,KAAK,MAAM,gBAAgB,kBAAkB,GAC7C,KAAA;EACL,GACD,KAAA,GACL,CAAC;CASF,MAAM,SARY,kBACd,yBAAyB;EACvB,WAAW,KAAK,MAAM,gBAAgB,UAAU;EAChD,GAAG;EACH;EACA,QAAQ;EACT,CAAC,GACF,EAAE,OAAO,OAAO,EACI;CACxB,MAAM,YACJ,KAAK,WAAW,MAAM,KAAK,QAAQ,iBAAiB,eAAe,KAAA,MAAc,YAAY;CAC/F,MAAM,eAAe,CAAC,SAAS,CAAC,KAAK,WAAW,MAAM;AAEtD,KAAI,gBAAgB,WAClB,KAAI,MACF;EAAE;EAAY,mBAAmB,iBAAiB;EAAc;EAAW;EAAW,EACtF,sDACD;AAYH,QAAO;EACL;EACA;EACA;EACA;EACA,mBAbA,SAAS,aACL,oBAAoB,0BAA0B,WAAW,EAAE,iBAAiB,KAAA,EAAU,GACtF,KAAA;EAYJ,kBAVA,SAAS,aACL,sBAAsB,0BAA0B,WAAW,EAAE,gBAAgB,KAAA,EAAU,GACvF,KAAA;EASL"}

package/dist/src/session/session-context-for-llm.js

@@ -32,7 +32,11 @@ function transcriptRowsFromJsonArray(arr) {
 /** Messages only — what providers and pi-agent should see. */
 function buildSessionContextForLlm(rows) {
 	const out = [];
-	for (const r of rows) if (!isTranscriptContextEntry(r)) out.push(r);
+	for (const r of rows) {
+		if (isTranscriptContextEntry(r)) continue;
+		if (r.type === "compaction") continue;
+		if (isLikelyAgentMessage(r)) out.push(r);
+	}
 	return out;
 }
 /**

package/dist/src/session/session-context-for-llm.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-context-for-llm.js","names":[],"sources":["../../../src/session/session-context-for-llm.ts"],"sourcesContent":["/**\n * Transcript rows persisted on disk may include non-LLM entries (e.g. `kind: 'context'`).\n * {@link buildSessionContextForLlm} is the single choke point for provider-facing history.\n *\n * Do not pass raw on-disk JSONL rows into pi-agent / providers — always run\n * {@link buildSessionContextForLlm} first (or use {@link SessionStore.loadMessages}, which already does).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\n/** Persisted-only row: never sent to the model as a chat message. */\nexport interface XopcTranscriptContextEntry {\n  kind: 'context';\n  id?: string;\n  /** Short human-readable line for UIs / logs. */\n  text?: string;\n  /** Structured payload (tool summaries, delivery metadata, etc.). */\n  data?: Record<string, unknown>;\n  createdAt?: string;\n}\n\nexport type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry;\n\nexport function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).kind === 'context';\n}\n\nconst LLM_ROLES = new Set(['user', 'assistant', 'system', 'tool', 'toolResult']);\n\nfunction isLikelyAgentMessage(x: unknown): x is AgentMessage {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return typeof role === 'string' && LLM_ROLES.has(role);\n}\n\n/**\n * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).\n */\nexport function transcriptRowsFromJsonArray(arr: unknown[]): TranscriptStoredRow[] {\n  const out: TranscriptStoredRow[] = [];\n  for (const x of arr) {\n    if (isTranscriptContextEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isLikelyAgentMessage(x)) {\n      out.push(x);\n    }\n  }\n  return out;\n}\n\n/** Messages only — what providers and pi-agent should see. */\nexport function buildSessionContextForLlm(rows: TranscriptStoredRow[]): AgentMessage[] {\n  const out: AgentMessage[] = [];\n  for (const r of rows) {\n    if (!isTranscriptContextEntry(r)) {\n      out.push(r);\n    }\n  }\n  return out;\n}\n\n/**\n * When persisting LLM messages, keep prior `kind: 'context'` rows in their relative positions:\n * each non-context slot in the previous file is replaced by the next incoming LLM message;\n * trailing new LLM rows are appended. Extra old LLM rows are dropped if the new list is shorter.\n */\nexport function mergeLlmMessagesPreservingContextRows(\n  prevRows: TranscriptStoredRow[],\n  llmMessages: AgentMessage[],\n): TranscriptStoredRow[] {\n  let i = 0;\n  const out: TranscriptStoredRow[] = [];\n  for (const r of prevRows) {\n    if (isTranscriptContextEntry(r)) {\n      out.push(r);\n    } else {\n      if (i < llmMessages.length) {\n        out.push(llmMessages[i]);\n        i += 1;\n      }\n    }\n  }\n  while (i < llmMessages.length) {\n    out.push(llmMessages[i]);\n    i += 1;\n  }\n  return out;\n}\n"],"mappings":";AAuBA,SAAgB,yBAAyB,GAA6C;AACpF,KAAI,CAAC,KAAK,OAAO,MAAM,SAAU,QAAO;AACxC,QAAQ,EAA8B,SAAS;;AAGjD,MAAM,YAAY,IAAI,IAAI;CAAC;CAAQ;CAAa;CAAU;CAAQ;CAAa,CAAC;AAEhF,SAAS,qBAAqB,GAA+B;AAC3D,KAAI,CAAC,KAAK,OAAO,MAAM,SAAU,QAAO;CACxC,MAAM,OAAQ,EAA8B;AAC5C,QAAO,OAAO,SAAS,YAAY,UAAU,IAAI,KAAK;;;;;AAMxD,SAAgB,4BAA4B,KAAuC;CACjF,MAAM,MAA6B,EAAE;AACrC,MAAK,MAAM,KAAK,KAAK;AACnB,MAAI,yBAAyB,EAAE,EAAE;AAC/B,OAAI,KAAK,EAAE;AACX;;AAEF,MAAI,qBAAqB,EAAE,CACzB,KAAI,KAAK,EAAE;;AAGf,QAAO;;;AAIT,SAAgB,0BAA0B,MAA6C;CACrF,MAAM,MAAsB,EAAE;AAC9B,MAAK,MAAM,KAAK,KACd,KAAI,CAAC,yBAAyB,EAAE,CAC9B,KAAI,KAAK,EAAE;AAGf,QAAO;;;;;;;AAQT,SAAgB,sCACd,UACA,aACuB;CACvB,IAAI,IAAI;CACR,MAAM,MAA6B,EAAE;AACrC,MAAK,MAAM,KAAK,SACd,KAAI,yBAAyB,EAAE,CAC7B,KAAI,KAAK,EAAE;UAEP,IAAI,YAAY,QAAQ;AAC1B,MAAI,KAAK,YAAY,GAAG;AACxB,OAAK;;AAIX,QAAO,IAAI,YAAY,QAAQ;AAC7B,MAAI,KAAK,YAAY,GAAG;AACxB,OAAK;;AAEP,QAAO"}
+{"version":3,"file":"session-context-for-llm.js","names":[],"sources":["../../../src/session/session-context-for-llm.ts"],"sourcesContent":["/**\n * Transcript rows persisted on disk may include non-LLM entries (e.g. `kind: 'context'`).\n * {@link buildSessionContextForLlm} is the single choke point for provider-facing history.\n *\n * Do not pass raw on-disk JSONL rows into pi-agent / providers — always run\n * {@link buildSessionContextForLlm} first (or use {@link SessionStore.loadMessages}, which already does).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\n/** Persisted-only row: never sent to the model as a chat message. */\nexport interface XopcTranscriptContextEntry {\n  kind: 'context';\n  id?: string;\n  /** Short human-readable line for UIs / logs. */\n  text?: string;\n  /** Structured payload (tool summaries, delivery metadata, etc.). */\n  data?: Record<string, unknown>;\n  createdAt?: string;\n}\n\nexport type TranscriptStoredRow = AgentMessage | XopcTranscriptContextEntry;\n\nexport function isTranscriptContextEntry(x: unknown): x is XopcTranscriptContextEntry {\n  if (!x || typeof x !== 'object') return false;\n  return (x as Record<string, unknown>).kind === 'context';\n}\n\nconst LLM_ROLES = new Set(['user', 'assistant', 'system', 'tool', 'toolResult']);\n\nfunction isLikelyAgentMessage(x: unknown): x is AgentMessage {\n  if (!x || typeof x !== 'object') return false;\n  const role = (x as Record<string, unknown>).role;\n  return typeof role === 'string' && LLM_ROLES.has(role);\n}\n\n/**\n * Normalize a JSON array from on-disk transcript into stored rows (drops unrecognized objects).\n */\nexport function transcriptRowsFromJsonArray(arr: unknown[]): TranscriptStoredRow[] {\n  const out: TranscriptStoredRow[] = [];\n  for (const x of arr) {\n    if (isTranscriptContextEntry(x)) {\n      out.push(x);\n      continue;\n    }\n    if (isLikelyAgentMessage(x)) {\n      out.push(x);\n    }\n  }\n  return out;\n}\n\n/** Messages only — what providers and pi-agent should see. */\nexport function buildSessionContextForLlm(rows: TranscriptStoredRow[]): AgentMessage[] {\n  const out: AgentMessage[] = [];\n  for (const r of rows) {\n    if (isTranscriptContextEntry(r)) {\n      continue;\n    }\n    if ((r as { type?: string }).type === 'compaction') {\n      continue;\n    }\n    if (isLikelyAgentMessage(r)) {\n      out.push(r);\n    }\n  }\n  return out;\n}\n\n/**\n * When persisting LLM messages, keep prior `kind: 'context'` rows in their relative positions:\n * each non-context slot in the previous file is replaced by the next incoming LLM message;\n * trailing new LLM rows are appended. Extra old LLM rows are dropped if the new list is shorter.\n */\nexport function mergeLlmMessagesPreservingContextRows(\n  prevRows: TranscriptStoredRow[],\n  llmMessages: AgentMessage[],\n): TranscriptStoredRow[] {\n  let i = 0;\n  const out: TranscriptStoredRow[] = [];\n  for (const r of prevRows) {\n    if (isTranscriptContextEntry(r)) {\n      out.push(r);\n    } else {\n      if (i < llmMessages.length) {\n        out.push(llmMessages[i]);\n        i += 1;\n      }\n    }\n  }\n  while (i < llmMessages.length) {\n    out.push(llmMessages[i]);\n    i += 1;\n  }\n  return out;\n}\n"],"mappings":";AAuBA,SAAgB,yBAAyB,GAA6C;AACpF,KAAI,CAAC,KAAK,OAAO,MAAM,SAAU,QAAO;AACxC,QAAQ,EAA8B,SAAS;;AAGjD,MAAM,YAAY,IAAI,IAAI;CAAC;CAAQ;CAAa;CAAU;CAAQ;CAAa,CAAC;AAEhF,SAAS,qBAAqB,GAA+B;AAC3D,KAAI,CAAC,KAAK,OAAO,MAAM,SAAU,QAAO;CACxC,MAAM,OAAQ,EAA8B;AAC5C,QAAO,OAAO,SAAS,YAAY,UAAU,IAAI,KAAK;;;;;AAMxD,SAAgB,4BAA4B,KAAuC;CACjF,MAAM,MAA6B,EAAE;AACrC,MAAK,MAAM,KAAK,KAAK;AACnB,MAAI,yBAAyB,EAAE,EAAE;AAC/B,OAAI,KAAK,EAAE;AACX;;AAEF,MAAI,qBAAqB,EAAE,CACzB,KAAI,KAAK,EAAE;;AAGf,QAAO;;;AAIT,SAAgB,0BAA0B,MAA6C;CACrF,MAAM,MAAsB,EAAE;AAC9B,MAAK,MAAM,KAAK,MAAM;AACpB,MAAI,yBAAyB,EAAE,CAC7B;AAEF,MAAK,EAAwB,SAAS,aACpC;AAEF,MAAI,qBAAqB,EAAE,CACzB,KAAI,KAAK,EAAE;;AAGf,QAAO;;;;;;;AAQT,SAAgB,sCACd,UACA,aACuB;CACvB,IAAI,IAAI;CACR,MAAM,MAA6B,EAAE;AACrC,MAAK,MAAM,KAAK,SACd,KAAI,yBAAyB,EAAE,CAC7B,KAAI,KAAK,EAAE;UAEP,IAAI,YAAY,QAAQ;AAC1B,MAAI,KAAK,YAAY,GAAG;AACxB,OAAK;;AAIX,QAAO,IAAI,YAAY,QAAQ;AAC7B,MAAI,KAAK,YAAY,GAAG;AACxB,OAAK;;AAEP,QAAO"}

package/dist/src/session/session-id.js

@@ -0,0 +1,12 @@
+//#region src/session/session-id.ts
+/** Same pattern as OpenClaw `config/sessions/paths.ts`. */
+const SAFE_SESSION_ID_RE = /^[a-z0-9][a-z0-9._-]{0,127}$/i;
+function validateSessionId(sessionId) {
+	const trimmed = sessionId.trim();
+	if (!SAFE_SESSION_ID_RE.test(trimmed)) throw new Error(`Invalid session ID: ${sessionId}`);
+	return trimmed;
+}
+//#endregion
+export { SAFE_SESSION_ID_RE, validateSessionId };
+
+//# sourceMappingURL=session-id.js.map

package/dist/src/session/session-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.js","names":[],"sources":["../../../src/session/session-id.ts"],"sourcesContent":["/** Same pattern as OpenClaw `config/sessions/paths.ts`. */\nexport const SAFE_SESSION_ID_RE = /^[a-z0-9][a-z0-9._-]{0,127}$/i;\n\nexport function validateSessionId(sessionId: string): string {\n  const trimmed = sessionId.trim();\n  if (!SAFE_SESSION_ID_RE.test(trimmed)) {\n    throw new Error(`Invalid session ID: ${sessionId}`);\n  }\n  return trimmed;\n}\n"],"mappings":";;AACA,MAAa,qBAAqB;AAElC,SAAgB,kBAAkB,WAA2B;CAC3D,MAAM,UAAU,UAAU,MAAM;AAChC,KAAI,CAAC,mBAAmB,KAAK,QAAQ,CACnC,OAAM,IAAI,MAAM,uBAAuB,YAAY;AAErD,QAAO"}

package/dist/src/session/session-title.js

@@ -1,7 +1,7 @@
-import { isCronSessionKey } from "../routing/session-key-utils.js";
-import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { isCronSessionKey } from "../routing/session-key-utils.js";
+import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { readAgentMessageContent } from "../agent/memory/agent-message-access.js";
 import { stripSessionStartupContextFromUserText } from "../agent/reply/startup-context.js";

package/dist/src/session/session-workspace.d.ts

@@ -2,7 +2,7 @@
  * Per-session markdown workspace override (stored in SessionAgentConfig).
  */
 import type { Config } from '../config/schema.js';
-import type { SessionAgentConfig } from './config-store.js';
+import type { SessionAgentConfig } from './config-types.js';
 /**
  * Normalize user input for `workingDirectoryOverride`. Rejects empty and filesystem roots.
  */

package/dist/src/session/session-workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-workspace.js","names":[],"sources":["../../../src/session/session-workspace.ts"],"sourcesContent":["/**\n * Per-session markdown workspace override (stored in SessionAgentConfig).\n */\n\nimport type { Config } from '../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport { resolveUserPath } from '../agent/agent-scope.js';\nimport { normalizeWorkspaceDir } from '../config/workspace-path.js';\nimport type { SessionAgentConfig } from './config-store.js';\n\n/**\n * Normalize user input for `workingDirectoryOverride`. Rejects empty and filesystem roots.\n */\nexport function normalizeWorkingDirectoryInput(raw: string): { ok: true; path: string } | { ok: false; error: string } {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return { ok: false, error: 'working directory is empty' };\n  }\n  const resolved = resolveUserPath(trimmed);\n  const normalized = normalizeWorkspaceDir(resolved);\n  if (!normalized) {\n    return { ok: false, error: 'invalid working directory path' };\n  }\n  return { ok: true, path: normalized };\n}\n\n/**\n * Resolved markdown workspace for tools/shell: session override or merged agent profile default.\n */\nexport function effectiveWorkspacePathForSession(\n  cfg: Config,\n  sessionKey: string,\n  sessionAgentConfig: SessionAgentConfig | null | undefined,\n): string {\n  const base = resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;\n  const o = sessionAgentConfig?.workingDirectoryOverride?.trim();\n  if (!o) {\n    return base;\n  }\n  const resolved = resolveUserPath(o);\n  const normalized = normalizeWorkspaceDir(resolved);\n  return normalized ?? base;\n}\n"],"mappings":";;;;kBAM0D;qBACU;;;;AAMpE,SAAgB,+BAA+B,KAAwE;CACrH,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO;EAAE,IAAI;EAAO,OAAO;EAA8B;CAG3D,MAAM,aAAa,sBADF,gBAAgB,QACgB,CAAC;AAClD,KAAI,CAAC,WACH,QAAO;EAAE,IAAI;EAAO,OAAO;EAAkC;AAE/D,QAAO;EAAE,IAAI;EAAM,MAAM;EAAY;;;;;AAMvC,SAAgB,iCACd,KACA,YACA,oBACQ;CACR,MAAM,OAAO,uCAAuC,KAAK,WAAW,CAAC;CACrE,MAAM,IAAI,oBAAoB,0BAA0B,MAAM;AAC9D,KAAI,CAAC,EACH,QAAO;AAIT,QADmB,sBADF,gBAAgB,EACgB,CAChC,IAAI"}
+{"version":3,"file":"session-workspace.js","names":[],"sources":["../../../src/session/session-workspace.ts"],"sourcesContent":["/**\n * Per-session markdown workspace override (stored in SessionAgentConfig).\n */\n\nimport type { Config } from '../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../config/agent-profile.js';\nimport { resolveUserPath } from '../agent/agent-scope.js';\nimport { normalizeWorkspaceDir } from '../config/workspace-path.js';\nimport type { SessionAgentConfig } from './config-types.js';\n\n/**\n * Normalize user input for `workingDirectoryOverride`. Rejects empty and filesystem roots.\n */\nexport function normalizeWorkingDirectoryInput(raw: string): { ok: true; path: string } | { ok: false; error: string } {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return { ok: false, error: 'working directory is empty' };\n  }\n  const resolved = resolveUserPath(trimmed);\n  const normalized = normalizeWorkspaceDir(resolved);\n  if (!normalized) {\n    return { ok: false, error: 'invalid working directory path' };\n  }\n  return { ok: true, path: normalized };\n}\n\n/**\n * Resolved markdown workspace for tools/shell: session override or merged agent profile default.\n */\nexport function effectiveWorkspacePathForSession(\n  cfg: Config,\n  sessionKey: string,\n  sessionAgentConfig: SessionAgentConfig | null | undefined,\n): string {\n  const base = resolveEffectiveAgentProfileForSession(cfg, sessionKey).resolvedWorkspacePath;\n  const o = sessionAgentConfig?.workingDirectoryOverride?.trim();\n  if (!o) {\n    return base;\n  }\n  const resolved = resolveUserPath(o);\n  const normalized = normalizeWorkspaceDir(resolved);\n  return normalized ?? base;\n}\n"],"mappings":";;;;kBAM0D;qBACU;;;;AAMpE,SAAgB,+BAA+B,KAAwE;CACrH,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO;EAAE,IAAI;EAAO,OAAO;EAA8B;CAG3D,MAAM,aAAa,sBADF,gBAAgB,QACgB,CAAC;AAClD,KAAI,CAAC,WACH,QAAO;EAAE,IAAI;EAAO,OAAO;EAAkC;AAE/D,QAAO;EAAE,IAAI;EAAM,MAAM;EAAY;;;;;AAMvC,SAAgB,iCACd,KACA,YACA,oBACQ;CACR,MAAM,OAAO,uCAAuC,KAAK,WAAW,CAAC;CACrE,MAAM,IAAI,oBAAoB,0BAA0B,MAAM;AAC9D,KAAI,CAAC,EACH,QAAO;AAIT,QADmB,sBADF,gBAAgB,EACgB,CAChC,IAAI"}

package/dist/src/session/store.d.ts

@@ -10,64 +10,27 @@ import type { Message } from './types.js';
 import type { SessionTranscriptUpdate } from './transcript-events.js';
 export interface SessionStoreOptions {
     config: Config;
-    agentId?: string;
-    sessionsDir?: string;
 }
 export declare class SessionStore {
     private options;
-    private sessionsDir;
-    private archiveDir;
-    private storePath;
     private window;
     private compactor;
-    private storeMutationDepth;
-    private storeMutationChain;
-    private allSessionsMapCache?;
-    /** Cache of per-agent sessions dirs to avoid re-resolution on every call. */
-    private agentSessionsDirCache;
     constructor(options: SessionStoreOptions, windowConfig?: Partial<WindowConfig>, compactionConfig?: Partial<CompactionConfig>);
-    getSessionsRoot(): string;
-    /**
-     * OpenClaw-aligned: resolve the sessions directory for a given session key.
-     * Extracts agentId from the session key and routes to `agents/<agentId>/sessions/`.
-     * Falls back to the default sessions directory when agentId cannot be parsed
-     * or when `sessionsDir` was explicitly provided in options.
-     */
-    private resolveSessionsDirForKey;
-    private resolveStorePathForKey;
+    private resolveWorkspaceCwd;
     private runStoreMutation;
     initialize(): Promise<void>;
-    private transcriptPathForEntry;
-    private readMapForKey;
-    private readMap;
-    private invalidateAllSessionsMapCache;
-    private discoverSessionMapPaths;
-    /**
-     * Unified cross-agent aggregation entry for global session views.
-     * Reads configured agents plus existing per-agent session maps under the state directory.
-     */
-    private readAllMaps;
-    private getDiskEntry;
-    private buildDefaultMetadata;
-    private parseSessionKey;
-    private extractRoutingFromKey;
-    /** Resolve on-disk transcript path; creates session row + empty JSONL when missing. */
+    getSessionsRoot(): string;
     resolveTranscriptPath(sessionKey: string): Promise<{
         sessionId: string;
-        absPath: string;
-        sessionsDir: string;
+        sessionKey: string;
     }>;
-    /** Ensure sessions.json has an entry and transcript file exist for `sessionKey`. */
-    private ensureSession;
-    private metadataFromEntry;
+    appendTranscriptMessage(sessionKey: string, message: AgentMessage): Promise<void>;
     getByAgent(agentId: string): Promise<SessionMetadata[]>;
     getByAccount(accountId: string): Promise<SessionMetadata[]>;
     getByPeer(peerKind: string, peerId: string): Promise<SessionMetadata[]>;
     getMainSession(channel: string, accountId: string): Promise<SessionMetadata | null>;
     refreshIndex(): Promise<void>;
     list(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>>;
-    private sessionMetadataMatchesSearch;
-    private sessionContentMatchesSearch;
     get(key: string, options?: {
         includeTranscriptSummary?: boolean;
         includeTranscriptRows?: boolean;
@@ -93,11 +56,6 @@ export declare class SessionStore {
     loadTranscriptRows(key: string): Promise<TranscriptStoredRow[]>;
     getMetadata(key: string): Promise<SessionMetadata | null>;
     updateMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void>;
-    /**
-     * Reset transcript for an existing session key: archive the current JSONL as
-     * `*.reset.*`, assign a new `sessionId`, and preserve per-session overrides
-     * on the disk entry (thinking/verbose) and in `sessions/config/*.json`.
-     */
     reset(key: string): Promise<{
         sessionId: string;
         previousSessionId: string;
@@ -112,22 +70,12 @@ export declare class SessionStore {
     unarchive(key: string): Promise<void>;
     pin(key: string): Promise<void>;
     unpin(key: string): Promise<void>;
-    private moveToArchive;
-    private findMostRecentDeletedTranscript;
-    private moveFromArchive;
-    loadMessages(key: string, options?: {
+    loadMessages(_key: string, _options?: {
         fromArchive?: boolean;
     }): Promise<AgentMessage[]>;
-    private loadDisplayMessages;
     loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null>;
-    private writeTranscriptAndSyncIndex;
-    /** Incremental sessions.json stats after guard append (OpenClaw transcript-events). */
-    syncSessionsJsonFromTranscriptUpdate(update: SessionTranscriptUpdate): Promise<void>;
+    syncEmbeddedTranscriptUpdate(update: SessionTranscriptUpdate): Promise<void>;
     appendTranscriptContextEntry(key: string, entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>): Promise<void>;
-    /**
-     * Bulk write entry point used by compaction, tests, and admin tools.
-     * Runtime agent turns must persist via {@link guardSessionManager} + appendMessage.
-     */
     saveMessages(key: string, messages: AgentMessage[]): Promise<void>;
     getWindowStats(messages: AgentMessage[]): {
         total: number;
@@ -145,11 +93,12 @@ export declare class SessionStore {
     prepareCompaction(key: string, messages: AgentMessage[], contextWindow: number): {
         needsCompaction: boolean;
         messages: AgentMessage[];
-        stats?: ReturnType<typeof this.compactor.needsCompaction>;
+        stats: {
+            needed: boolean;
+            reason: string;
+            usagePercent?: number;
+        };
     };
-    private checkpointBasename;
-    private pruneCompactionCheckpoints;
-    private captureCompactionCheckpoint;
     applyCompaction(key: string, messages: AgentMessage[], result: CompactionResult): Promise<AgentMessage[]>;
     compact(key: string, messages: AgentMessage[], contextWindow: number, instructions?: string, force?: boolean): Promise<CompactionResult>;
     getCompactionStats(key: string): Promise<{
@@ -171,9 +120,11 @@ export declare class SessionStore {
     getStats(): Promise<GlobalSessionStats>;
     archiveOld(olderThanDays: number): Promise<number>;
     estimateTokens(messages: AgentMessage[]): number;
+    private loadDisplayMessages;
+    private paginateDisplayMessages;
+    private displayMessageIdentity;
     private messageContent;
     private isCompactionSummaryMessage;
-    private displayMessageIdentity;
     private extractTextContent;
     private injectPostCompactionContext;
     private convertMessages;