@xopcai/xopc 0.0.29 → 0.0.31

package/dist/src/infra/write-file-atomic.js

@@ -0,0 +1,115 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import path from "node:path";
+import { chmodSync, closeSync, copyFileSync, fsyncSync, mkdirSync, openSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { chmod, copyFile, mkdir, open, rename, rm } from "node:fs/promises";
+//#region src/infra/write-file-atomic.ts
+/**
+* Durable single-file writes: temp file → fsync → rename to target.
+* Avoids torn JSON when the process dies mid-write.
+*/
+function errno(err) {
+	return err instanceof Error ? err.code : void 0;
+}
+function replaceTempWithTargetSync(tempPath, filePath, mode) {
+	try {
+		renameSync(tempPath, filePath);
+		return;
+	} catch (err) {
+		const code = errno(err);
+		if (process.platform !== "win32" || code !== "EPERM" && code !== "EEXIST") throw err;
+	}
+	copyFileSync(tempPath, filePath);
+	try {
+		chmodSync(filePath, mode);
+	} catch {}
+	rmSync(tempPath, { force: true });
+}
+async function replaceTempWithTarget(tempPath, filePath, mode) {
+	try {
+		await rename(tempPath, filePath);
+		return;
+	} catch (err) {
+		const code = errno(err);
+		if (process.platform !== "win32" || code !== "EPERM" && code !== "EEXIST") throw err;
+	}
+	await copyFile(tempPath, filePath);
+	try {
+		await chmod(filePath, mode);
+	} catch {}
+	await rm(tempPath, { force: true }).catch(() => void 0);
+}
+/**
+* Write UTF-8 text atomically. Creates parent directories when missing.
+*/
+async function writeTextAtomic(filePath, content, options) {
+	const mode = options?.mode ?? 384;
+	const dir = path.dirname(filePath);
+	const mkdirOpts = { recursive: true };
+	if (typeof options?.ensureDirMode === "number") mkdirOpts.mode = options.ensureDirMode;
+	await mkdir(dir, mkdirOpts);
+	const tmp = `${filePath}.${randomUUID()}.tmp`;
+	try {
+		const handle = await open(tmp, "w", mode);
+		try {
+			await handle.writeFile(content, { encoding: "utf8" });
+			await handle.sync();
+		} finally {
+			await handle.close().catch(() => void 0);
+		}
+		try {
+			await chmod(tmp, mode);
+		} catch {}
+		await replaceTempWithTarget(tmp, filePath, mode);
+		try {
+			await chmod(filePath, mode);
+		} catch {}
+	} finally {
+		await rm(tmp, { force: true }).catch(() => void 0);
+	}
+	try {
+		const dirHandle = await open(dir, "r");
+		try {
+			await dirHandle.sync();
+		} finally {
+			await dirHandle.close().catch(() => void 0);
+		}
+	} catch {}
+}
+/**
+* Synchronous atomic UTF-8 write (temp → fsync → rename). For CLI / sync stores.
+*/
+function writeTextAtomicSync(filePath, content, options) {
+	const mode = options?.mode ?? 384;
+	const dir = path.dirname(filePath);
+	const mkdirOpts = { recursive: true };
+	if (typeof options?.ensureDirMode === "number") mkdirOpts.mode = options.ensureDirMode;
+	mkdirSync(dir, mkdirOpts);
+	const tmp = `${filePath}.${randomUUID()}.tmp`;
+	try {
+		writeFileSync(tmp, content, { encoding: "utf8" });
+		const fd = openSync(tmp, "r+");
+		try {
+			fsyncSync(fd);
+		} finally {
+			closeSync(fd);
+		}
+		try {
+			chmodSync(tmp, mode);
+		} catch {}
+		replaceTempWithTargetSync(tmp, filePath, mode);
+		try {
+			chmodSync(filePath, mode);
+		} catch {}
+	} finally {
+		try {
+			rmSync(tmp, { force: true });
+		} catch {}
+	}
+}
+var init_write_file_atomic = __esmMin((() => {}));
+//#endregion
+init_write_file_atomic();
+export { init_write_file_atomic, writeTextAtomic, writeTextAtomicSync };
+
+//# sourceMappingURL=write-file-atomic.js.map

package/dist/src/infra/write-file-atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file-atomic.js","names":[],"sources":["../../../src/infra/write-file-atomic.ts"],"sourcesContent":["/**\n * Durable single-file writes: temp file → fsync → rename to target.\n * Avoids torn JSON when the process dies mid-write.\n */\n\nimport { randomUUID } from 'node:crypto';\nimport {\n  chmodSync,\n  closeSync,\n  copyFileSync,\n  fsyncSync,\n  mkdirSync,\n  openSync,\n  renameSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { mkdir, open, rename, rm, copyFile, chmod } from 'node:fs/promises';\nimport path from 'node:path';\n\nfunction errno(err: unknown): string | undefined {\n  return err instanceof Error ? (err as NodeJS.ErrnoException).code : undefined;\n}\n\nfunction replaceTempWithTargetSync(tempPath: string, filePath: string, mode: number): void {\n  try {\n    renameSync(tempPath, filePath);\n    return;\n  } catch (err) {\n    const code = errno(err);\n    if (process.platform !== 'win32' || (code !== 'EPERM' && code !== 'EEXIST')) {\n      throw err;\n    }\n  }\n\n  copyFileSync(tempPath, filePath);\n  try {\n    chmodSync(filePath, mode);\n  } catch {\n    /* best-effort */\n  }\n  rmSync(tempPath, { force: true });\n}\n\nasync function replaceTempWithTarget(tempPath: string, filePath: string, mode: number): Promise<void> {\n  try {\n    await rename(tempPath, filePath);\n    return;\n  } catch (err) {\n    const code = errno(err);\n    if (process.platform !== 'win32' || (code !== 'EPERM' && code !== 'EEXIST')) {\n      throw err;\n    }\n  }\n\n  await copyFile(tempPath, filePath);\n  try {\n    await chmod(filePath, mode);\n  } catch {\n    /* best-effort */\n  }\n  await rm(tempPath, { force: true }).catch(() => undefined);\n}\n\n/**\n * Write UTF-8 text atomically. Creates parent directories when missing.\n */\nexport async function writeTextAtomic(\n  filePath: string,\n  content: string,\n  options?: { mode?: number; ensureDirMode?: number },\n): Promise<void> {\n  const mode = options?.mode ?? 0o600;\n  const dir = path.dirname(filePath);\n  const mkdirOpts: { recursive: true; mode?: number } = { recursive: true };\n  if (typeof options?.ensureDirMode === 'number') {\n    mkdirOpts.mode = options.ensureDirMode;\n  }\n  await mkdir(dir, mkdirOpts);\n\n  const tmp = `${filePath}.${randomUUID()}.tmp`;\n  try {\n    const handle = await open(tmp, 'w', mode);\n    try {\n      await handle.writeFile(content, { encoding: 'utf8' });\n      await handle.sync();\n    } finally {\n      await handle.close().catch(() => undefined);\n    }\n    try {\n      await chmod(tmp, mode);\n    } catch {\n      /* best-effort */\n    }\n    await replaceTempWithTarget(tmp, filePath, mode);\n    try {\n      await chmod(filePath, mode);\n    } catch {\n      /* best-effort */\n    }\n  } finally {\n    await rm(tmp, { force: true }).catch(() => undefined);\n  }\n\n  try {\n    const dirHandle = await open(dir, 'r');\n    try {\n      await dirHandle.sync();\n    } finally {\n      await dirHandle.close().catch(() => undefined);\n    }\n  } catch {\n    /* best-effort directory sync */\n  }\n}\n\n/**\n * Synchronous atomic UTF-8 write (temp → fsync → rename). For CLI / sync stores.\n */\nexport function writeTextAtomicSync(\n  filePath: string,\n  content: string,\n  options?: { mode?: number; ensureDirMode?: number },\n): void {\n  const mode = options?.mode ?? 0o600;\n  const dir = path.dirname(filePath);\n  const mkdirOpts: { recursive: true; mode?: number } = { recursive: true };\n  if (typeof options?.ensureDirMode === 'number') {\n    mkdirOpts.mode = options.ensureDirMode;\n  }\n  mkdirSync(dir, mkdirOpts);\n\n  const tmp = `${filePath}.${randomUUID()}.tmp`;\n  try {\n    writeFileSync(tmp, content, { encoding: 'utf8' });\n    const fd = openSync(tmp, 'r+');\n    try {\n      fsyncSync(fd);\n    } finally {\n      closeSync(fd);\n    }\n    try {\n      chmodSync(tmp, mode);\n    } catch {\n      /* best-effort */\n    }\n    replaceTempWithTargetSync(tmp, filePath, mode);\n    try {\n      chmodSync(filePath, mode);\n    } catch {\n      /* best-effort */\n    }\n  } finally {\n    try {\n      rmSync(tmp, { force: true });\n    } catch {\n      /* ignore */\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAoBA,SAAS,MAAM,KAAkC;AAC/C,QAAO,eAAe,QAAS,IAA8B,OAAO,KAAA;;AAGtE,SAAS,0BAA0B,UAAkB,UAAkB,MAAoB;AACzF,KAAI;AACF,aAAW,UAAU,SAAS;AAC9B;UACO,KAAK;EACZ,MAAM,OAAO,MAAM,IAAI;AACvB,MAAI,QAAQ,aAAa,WAAY,SAAS,WAAW,SAAS,SAChE,OAAM;;AAIV,cAAa,UAAU,SAAS;AAChC,KAAI;AACF,YAAU,UAAU,KAAK;SACnB;AAGR,QAAO,UAAU,EAAE,OAAO,MAAM,CAAC;;AAGnC,eAAe,sBAAsB,UAAkB,UAAkB,MAA6B;AACpG,KAAI;AACF,QAAM,OAAO,UAAU,SAAS;AAChC;UACO,KAAK;EACZ,MAAM,OAAO,MAAM,IAAI;AACvB,MAAI,QAAQ,aAAa,WAAY,SAAS,WAAW,SAAS,SAChE,OAAM;;AAIV,OAAM,SAAS,UAAU,SAAS;AAClC,KAAI;AACF,QAAM,MAAM,UAAU,KAAK;SACrB;AAGR,OAAM,GAAG,UAAU,EAAE,OAAO,MAAM,CAAC,CAAC,YAAY,KAAA,EAAU;;;;;AAM5D,eAAsB,gBACpB,UACA,SACA,SACe;CACf,MAAM,OAAO,SAAS,QAAQ;CAC9B,MAAM,MAAM,KAAK,QAAQ,SAAS;CAClC,MAAM,YAAgD,EAAE,WAAW,MAAM;AACzE,KAAI,OAAO,SAAS,kBAAkB,SACpC,WAAU,OAAO,QAAQ;AAE3B,OAAM,MAAM,KAAK,UAAU;CAE3B,MAAM,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AACxC,KAAI;EACF,MAAM,SAAS,MAAM,KAAK,KAAK,KAAK,KAAK;AACzC,MAAI;AACF,SAAM,OAAO,UAAU,SAAS,EAAE,UAAU,QAAQ,CAAC;AACrD,SAAM,OAAO,MAAM;YACX;AACR,SAAM,OAAO,OAAO,CAAC,YAAY,KAAA,EAAU;;AAE7C,MAAI;AACF,SAAM,MAAM,KAAK,KAAK;UAChB;AAGR,QAAM,sBAAsB,KAAK,UAAU,KAAK;AAChD,MAAI;AACF,SAAM,MAAM,UAAU,KAAK;UACrB;WAGA;AACR,QAAM,GAAG,KAAK,EAAE,OAAO,MAAM,CAAC,CAAC,YAAY,KAAA,EAAU;;AAGvD,KAAI;EACF,MAAM,YAAY,MAAM,KAAK,KAAK,IAAI;AACtC,MAAI;AACF,SAAM,UAAU,MAAM;YACd;AACR,SAAM,UAAU,OAAO,CAAC,YAAY,KAAA,EAAU;;SAE1C;;;;;AAQV,SAAgB,oBACd,UACA,SACA,SACM;CACN,MAAM,OAAO,SAAS,QAAQ;CAC9B,MAAM,MAAM,KAAK,QAAQ,SAAS;CAClC,MAAM,YAAgD,EAAE,WAAW,MAAM;AACzE,KAAI,OAAO,SAAS,kBAAkB,SACpC,WAAU,OAAO,QAAQ;AAE3B,WAAU,KAAK,UAAU;CAEzB,MAAM,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AACxC,KAAI;AACF,gBAAc,KAAK,SAAS,EAAE,UAAU,QAAQ,CAAC;EACjD,MAAM,KAAK,SAAS,KAAK,KAAK;AAC9B,MAAI;AACF,aAAU,GAAG;YACL;AACR,aAAU,GAAG;;AAEf,MAAI;AACF,aAAU,KAAK,KAAK;UACd;AAGR,4BAA0B,KAAK,UAAU,KAAK;AAC9C,MAAI;AACF,aAAU,UAAU,KAAK;UACnB;WAGA;AACR,MAAI;AACF,UAAO,KAAK,EAAE,OAAO,MAAM,CAAC;UACtB"}

package/dist/src/session/abort-cutoff.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Webchat abort cutoff (OpenClaw-style): stale in-flight POSTs after /api/agent/abort
+ * are ignored when the client sends `clientCreatedAtMs` from send time.
+ */
+import type { SessionMetadata } from './types.js';
+export declare function shouldSkipWebchatInboundByAbortCutoff(meta: SessionMetadata | null | undefined, clientCreatedAtMs?: number): boolean;

package/dist/src/session/abort-cutoff.js

@@ -0,0 +1,10 @@
+//#region src/session/abort-cutoff.ts
+function shouldSkipWebchatInboundByAbortCutoff(meta, clientCreatedAtMs) {
+	if (!meta?.abortCutoffTimestamp) return false;
+	if (typeof clientCreatedAtMs !== "number" || !Number.isFinite(clientCreatedAtMs)) return false;
+	return clientCreatedAtMs <= meta.abortCutoffTimestamp;
+}
+//#endregion
+export { shouldSkipWebchatInboundByAbortCutoff };
+
+//# sourceMappingURL=abort-cutoff.js.map

package/dist/src/session/abort-cutoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-cutoff.js","names":[],"sources":["../../../src/session/abort-cutoff.ts"],"sourcesContent":["/**\n * Webchat abort cutoff (OpenClaw-style): stale in-flight POSTs after /api/agent/abort\n * are ignored when the client sends `clientCreatedAtMs` from send time.\n */\n\nimport type { SessionMetadata } from './types.js';\n\nexport function shouldSkipWebchatInboundByAbortCutoff(\n  meta: SessionMetadata | null | undefined,\n  clientCreatedAtMs?: number,\n): boolean {\n  if (!meta?.abortCutoffTimestamp) {\n    return false;\n  }\n  if (typeof clientCreatedAtMs !== 'number' || !Number.isFinite(clientCreatedAtMs)) {\n    return false;\n  }\n  return clientCreatedAtMs <= meta.abortCutoffTimestamp;\n}\n"],"mappings":";AAOA,SAAgB,sCACd,MACA,mBACS;AACT,KAAI,CAAC,MAAM,qBACT,QAAO;AAET,KAAI,OAAO,sBAAsB,YAAY,CAAC,OAAO,SAAS,kBAAkB,CAC9E,QAAO;AAET,QAAO,qBAAqB,KAAK"}

package/dist/src/session/compaction-checkpoints.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Pre-compaction transcript snapshots ({safeKey}.compaction-backup.{uuid}.json).
+ * OpenClaw-style listing and id normalization for gateway APIs.
+ */
+/**
+ * Accept raw uuid or full backup filename stem; returns lowercase uuid or null.
+ */
+export declare function normalizeCompactionCheckpointId(raw: string): string | null;

package/dist/src/session/compaction-checkpoints.js

@@ -0,0 +1,21 @@
+//#region src/session/compaction-checkpoints.ts
+/**
+* Pre-compaction transcript snapshots ({safeKey}.compaction-backup.{uuid}.json).
+* OpenClaw-style listing and id normalization for gateway APIs.
+*/
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+* Accept raw uuid or full backup filename stem; returns lowercase uuid or null.
+*/
+function normalizeCompactionCheckpointId(raw) {
+	const t = raw.trim();
+	if (!t) return null;
+	if (UUID_RE.test(t)) return t.toLowerCase();
+	const m = t.match(/\.compaction-backup\.([0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})\.json$/i);
+	if (m?.[1] && UUID_RE.test(m[1])) return m[1].toLowerCase();
+	return null;
+}
+//#endregion
+export { normalizeCompactionCheckpointId };
+
+//# sourceMappingURL=compaction-checkpoints.js.map

package/dist/src/session/compaction-checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-checkpoints.js","names":[],"sources":["../../../src/session/compaction-checkpoints.ts"],"sourcesContent":["/**\n * Pre-compaction transcript snapshots ({safeKey}.compaction-backup.{uuid}.json).\n * OpenClaw-style listing and id normalization for gateway APIs.\n */\n\nconst UUID_RE =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * Accept raw uuid or full backup filename stem; returns lowercase uuid or null.\n */\nexport function normalizeCompactionCheckpointId(raw: string): string | null {\n  const t = raw.trim();\n  if (!t) return null;\n  if (UUID_RE.test(t)) {\n    return t.toLowerCase();\n  }\n  const m = t.match(/\\.compaction-backup\\.([0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})\\.json$/i);\n  if (m?.[1] && UUID_RE.test(m[1])) {\n    return m[1].toLowerCase();\n  }\n  return null;\n}\n"],"mappings":";;;;;AAKA,MAAM,UACJ;;;;AAKF,SAAgB,gCAAgC,KAA4B;CAC1E,MAAM,IAAI,IAAI,MAAM;AACpB,KAAI,CAAC,EAAG,QAAO;AACf,KAAI,QAAQ,KAAK,EAAE,CACjB,QAAO,EAAE,aAAa;CAExB,MAAM,IAAI,EAAE,MAAM,yGAAyG;AAC3H,KAAI,IAAI,MAAM,QAAQ,KAAK,EAAE,GAAG,CAC9B,QAAO,EAAE,GAAG,aAAa;AAE3B,QAAO"}

package/dist/src/session/config-store.js

@@ -1,8 +1,9 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { join } from "path";
 import { existsSync } from "fs";
-import { mkdir, readFile, writeFile } from "fs/promises";
+import { mkdir, readFile } from "fs/promises";
 //#region src/session/config-store.ts
 /**
 * Session Config Store
@@ -11,6 +12,7 @@ import { mkdir, readFile, writeFile } from "fs/promises";
 * Stores thinking level, reasoning visibility, verbose mode, and other
 * session-specific settings that can be overridden via commands.
 */
+init_write_file_atomic();
 init_logger();
 const log = createLogger("SessionConfigStore");
 /**
@@ -64,7 +66,7 @@ var SessionConfigStore = class {
 			updatedAt: Date.now()
 		};
 		try {
-			await writeFile(configPath, JSON.stringify(configWithTimestamp, null, 2), "utf-8");
+			await writeTextAtomic(configPath, JSON.stringify(configWithTimestamp, null, 2));
 			log.debug({ sessionKey }, "Session config saved");
 		} catch (error) {
 			log.error({

package/dist/src/session/config-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-store.js","names":[],"sources":["../../../src/session/config-store.ts"],"sourcesContent":["/**\n * Session Config Store\n * \n * Manages session-level configuration persistence.\n * Stores thinking level, reasoning visibility, verbose mode, and other\n * session-specific settings that can be overridden via commands.\n */\n\nimport { readFile, writeFile, mkdir } from 'fs/promises';\nimport { join } from 'path';\nimport { existsSync } from 'fs';\nimport { createLogger } from '../utils/logger.js';\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel, ElevatedMode } from '../agent/transcript/thinking-types.js';\n\nconst log = createLogger('SessionConfigStore');\n\n/**\n * Session-level agent configuration.\n * These settings override agent defaults for a specific session.\n */\nexport interface SessionAgentConfig {\n  /** Thinking level for this session */\n  thinkingLevel?: ThinkLevel;\n  /** Reasoning visibility for this session */\n  reasoningLevel?: ReasoningLevel;\n  /** Verbose level for this session */\n  verboseLevel?: VerboseLevel;\n  /** Elevated mode for this session */\n  elevatedMode?: ElevatedMode;\n  /** Model override for this session */\n  modelOverride?: string;\n  /** Provider override for this session */\n  providerOverride?: string;\n  /** Absolute markdown workspace root for this session (set once; immutable after save). */\n  workingDirectoryOverride?: string;\n  /** Last updated timestamp */\n  updatedAt?: number;\n}\n\n/**\n * Session config store manager.\n * Each session can have its own configuration that overrides agent defaults.\n */\nexport class SessionConfigStore {\n  private configDir: string;\n\n  /** @param agentHomeDir — `resolveAgentHomeDir(…)` (parent of `sessions/` transcript store) */\n  constructor(agentHomeDir: string) {\n    this.configDir = join(agentHomeDir, 'sessions', 'config');\n  }\n\n  /**\n   * Initialize the config store\n   */\n  async initialize(): Promise<void> {\n    await mkdir(this.configDir, { recursive: true });\n    log.debug('Session config store initialized');\n  }\n\n  /**\n   * Get the config file path for a session\n   */\n  private getConfigPath(sessionKey: string): string {\n    // Sanitize session key to be a valid filename\n    const safeKey = sessionKey.replace(/[^a-zA-Z0-9_-]/g, '_');\n    return join(this.configDir, `${safeKey}.json`);\n  }\n\n  /**\n   * Get config for a session\n   */\n  async get(sessionKey: string): Promise<SessionAgentConfig | null> {\n    const configPath = this.getConfigPath(sessionKey);\n    \n    if (!existsSync(configPath)) {\n      return null;\n    }\n\n    try {\n      const content = await readFile(configPath, 'utf-8');\n      const config = JSON.parse(content) as SessionAgentConfig;\n      return config;\n    } catch (error) {\n      log.error({ sessionKey, error }, 'Failed to read session config');\n      return null;\n    }\n  }\n\n  /**\n   * Set config for a session (full replacement)\n   */\n  async set(sessionKey: string, config: SessionAgentConfig): Promise<void> {\n    const configPath = this.getConfigPath(sessionKey);\n    const configWithTimestamp = {\n      ...config,\n      updatedAt: Date.now(),\n    };\n\n    try {\n      await writeFile(configPath, JSON.stringify(configWithTimestamp, null, 2), 'utf-8');\n      log.debug({ sessionKey }, 'Session config saved');\n    } catch (error) {\n      log.error({ sessionKey, error }, 'Failed to save session config');\n      throw error;\n    }\n  }\n\n  /**\n   * Update config for a session (partial update)\n   */\n  async update(sessionKey: string, partial: Partial<SessionAgentConfig>): Promise<SessionAgentConfig> {\n    const existing = await this.get(sessionKey);\n    const updated = {\n      ...existing,\n      ...partial,\n      updatedAt: Date.now(),\n    };\n    \n    await this.set(sessionKey, updated);\n    return updated;\n  }\n\n  /**\n   * Delete config for a session\n   */\n  async delete(sessionKey: string): Promise<void> {\n    const configPath = this.getConfigPath(sessionKey);\n    \n    if (existsSync(configPath)) {\n      try {\n        const { unlink } = await import('fs/promises');\n        await unlink(configPath);\n        log.debug({ sessionKey }, 'Session config deleted');\n      } catch (error) {\n        log.error({ sessionKey, error }, 'Failed to delete session config');\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Check if config exists for a session\n   */\n  async has(sessionKey: string): Promise<boolean> {\n    const configPath = this.getConfigPath(sessionKey);\n    return existsSync(configPath);\n  }\n\n  /**\n   * Get all session configs\n   */\n  async getAll(): Promise<Map<string, SessionAgentConfig>> {\n    const { readdir } = await import('fs/promises');\n    const configs = new Map<string, SessionAgentConfig>();\n\n    try {\n      const files = await readdir(this.configDir);\n      \n      for (const file of files) {\n        if (!file.endsWith('.json')) continue;\n        \n        const sessionKey = file.replace('.json', '').replace(/_/g, '-');\n        const config = await this.get(sessionKey);\n        \n        if (config) {\n          configs.set(sessionKey, config);\n        }\n      }\n    } catch (error) {\n      log.error({ error }, 'Failed to list session configs');\n    }\n\n    return configs;\n  }\n\n  /**\n   * Clear all session configs\n   */\n  async clear(): Promise<void> {\n    const { readdir, rm } = await import('fs/promises');\n    \n    try {\n      const files = await readdir(this.configDir);\n      \n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          await rm(join(this.configDir, file), { force: true });\n        }\n      }\n      \n      log.debug('All session configs cleared');\n    } catch (error) {\n      log.error({ error }, 'Failed to clear session configs');\n      throw error;\n    }\n  }\n}\n\n// ========== Helper Functions ==========\n\n/**\n * Resolve thinking level for a session.\n * Returns session config if set, otherwise falls back to agent defaults.\n */\nexport async function resolveThinkingLevel(\n  sessionConfigStore: SessionConfigStore,\n  sessionKey: string,\n  agentDefault?: ThinkLevel\n): Promise<ThinkLevel | undefined> {\n  const config = await sessionConfigStore.get(sessionKey);\n  \n  if (config?.thinkingLevel) {\n    return config.thinkingLevel;\n  }\n  \n  return agentDefault;\n}\n\n/**\n * Resolve reasoning level for a session.\n */\nexport async function resolveReasoningLevel(\n  sessionConfigStore: SessionConfigStore,\n  sessionKey: string,\n  agentDefault?: ReasoningLevel\n): Promise<ReasoningLevel | undefined> {\n  const config = await sessionConfigStore.get(sessionKey);\n  \n  if (config?.reasoningLevel) {\n    return config.reasoningLevel;\n  }\n  \n  return agentDefault;\n}\n\n/**\n * Resolve verbose level for a session.\n */\nexport async function resolveVerboseLevel(\n  sessionConfigStore: SessionConfigStore,\n  sessionKey: string,\n  agentDefault?: VerboseLevel\n): Promise<VerboseLevel | undefined> {\n  const config = await sessionConfigStore.get(sessionKey);\n  \n  if (config?.verboseLevel) {\n    return config.verboseLevel;\n  }\n  \n  return agentDefault;\n}\n"],"mappings":"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"}
+{"version":3,"file":"config-store.js","names":[],"sources":["../../../src/session/config-store.ts"],"sourcesContent":["/**\n * Session Config Store\n * \n * Manages session-level configuration persistence.\n * Stores thinking level, reasoning visibility, verbose mode, and other\n * session-specific settings that can be overridden via commands.\n */\n\nimport { readFile, mkdir } from 'fs/promises';\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { join } from 'path';\nimport { existsSync } from 'fs';\nimport { createLogger } from '../utils/logger.js';\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel, ElevatedMode } from '../agent/transcript/thinking-types.js';\n\nconst log = createLogger('SessionConfigStore');\n\n/**\n * Session-level agent configuration.\n * These settings override agent defaults for a specific session.\n */\nexport interface SessionAgentConfig {\n  /** Thinking level for this session */\n  thinkingLevel?: ThinkLevel;\n  /** Reasoning visibility for this session */\n  reasoningLevel?: ReasoningLevel;\n  /** Verbose level for this session */\n  verboseLevel?: VerboseLevel;\n  /** Elevated mode for this session */\n  elevatedMode?: ElevatedMode;\n  /** Model override for this session */\n  modelOverride?: string;\n  /** Provider override for this session */\n  providerOverride?: string;\n  /** Absolute markdown workspace root for this session (set once; immutable after save). */\n  workingDirectoryOverride?: string;\n  /** Last updated timestamp */\n  updatedAt?: number;\n}\n\n/**\n * Session config store manager.\n * Each session can have its own configuration that overrides agent defaults.\n */\nexport class SessionConfigStore {\n  private configDir: string;\n\n  /** @param agentHomeDir — `resolveAgentHomeDir(…)` (parent of `sessions/` transcript store) */\n  constructor(agentHomeDir: string) {\n    this.configDir = join(agentHomeDir, 'sessions', 'config');\n  }\n\n  /**\n   * Initialize the config store\n   */\n  async initialize(): Promise<void> {\n    await mkdir(this.configDir, { recursive: true });\n    log.debug('Session config store initialized');\n  }\n\n  /**\n   * Get the config file path for a session\n   */\n  private getConfigPath(sessionKey: string): string {\n    // Sanitize session key to be a valid filename\n    const safeKey = sessionKey.replace(/[^a-zA-Z0-9_-]/g, '_');\n    return join(this.configDir, `${safeKey}.json`);\n  }\n\n  /**\n   * Get config for a session\n   */\n  async get(sessionKey: string): Promise<SessionAgentConfig | null> {\n    const configPath = this.getConfigPath(sessionKey);\n    \n    if (!existsSync(configPath)) {\n      return null;\n    }\n\n    try {\n      const content = await readFile(configPath, 'utf-8');\n      const config = JSON.parse(content) as SessionAgentConfig;\n      return config;\n    } catch (error) {\n      log.error({ sessionKey, error }, 'Failed to read session config');\n      return null;\n    }\n  }\n\n  /**\n   * Set config for a session (full replacement)\n   */\n  async set(sessionKey: string, config: SessionAgentConfig): Promise<void> {\n    const configPath = this.getConfigPath(sessionKey);\n    const configWithTimestamp = {\n      ...config,\n      updatedAt: Date.now(),\n    };\n\n    try {\n      await writeTextAtomic(configPath, JSON.stringify(configWithTimestamp, null, 2));\n      log.debug({ sessionKey }, 'Session config saved');\n    } catch (error) {\n      log.error({ sessionKey, error }, 'Failed to save session config');\n      throw error;\n    }\n  }\n\n  /**\n   * Update config for a session (partial update)\n   */\n  async update(sessionKey: string, partial: Partial<SessionAgentConfig>): Promise<SessionAgentConfig> {\n    const existing = await this.get(sessionKey);\n    const updated = {\n      ...existing,\n      ...partial,\n      updatedAt: Date.now(),\n    };\n    \n    await this.set(sessionKey, updated);\n    return updated;\n  }\n\n  /**\n   * Delete config for a session\n   */\n  async delete(sessionKey: string): Promise<void> {\n    const configPath = this.getConfigPath(sessionKey);\n    \n    if (existsSync(configPath)) {\n      try {\n        const { unlink } = await import('fs/promises');\n        await unlink(configPath);\n        log.debug({ sessionKey }, 'Session config deleted');\n      } catch (error) {\n        log.error({ sessionKey, error }, 'Failed to delete session config');\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Check if config exists for a session\n   */\n  async has(sessionKey: string): Promise<boolean> {\n    const configPath = this.getConfigPath(sessionKey);\n    return existsSync(configPath);\n  }\n\n  /**\n   * Get all session configs\n   */\n  async getAll(): Promise<Map<string, SessionAgentConfig>> {\n    const { readdir } = await import('fs/promises');\n    const configs = new Map<string, SessionAgentConfig>();\n\n    try {\n      const files = await readdir(this.configDir);\n      \n      for (const file of files) {\n        if (!file.endsWith('.json')) continue;\n        \n        const sessionKey = file.replace('.json', '').replace(/_/g, '-');\n        const config = await this.get(sessionKey);\n        \n        if (config) {\n          configs.set(sessionKey, config);\n        }\n      }\n    } catch (error) {\n      log.error({ error }, 'Failed to list session configs');\n    }\n\n    return configs;\n  }\n\n  /**\n   * Clear all session configs\n   */\n  async clear(): Promise<void> {\n    const { readdir, rm } = await import('fs/promises');\n    \n    try {\n      const files = await readdir(this.configDir);\n      \n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          await rm(join(this.configDir, file), { force: true });\n        }\n      }\n      \n      log.debug('All session configs cleared');\n    } catch (error) {\n      log.error({ error }, 'Failed to clear session configs');\n      throw error;\n    }\n  }\n}\n\n// ========== Helper Functions ==========\n\n/**\n * Resolve thinking level for a session.\n * Returns session config if set, otherwise falls back to agent defaults.\n */\nexport async function resolveThinkingLevel(\n  sessionConfigStore: SessionConfigStore,\n  sessionKey: string,\n  agentDefault?: ThinkLevel\n): Promise<ThinkLevel | undefined> {\n  const config = await sessionConfigStore.get(sessionKey);\n  \n  if (config?.thinkingLevel) {\n    return config.thinkingLevel;\n  }\n  \n  return agentDefault;\n}\n\n/**\n * Resolve reasoning level for a session.\n */\nexport async function resolveReasoningLevel(\n  sessionConfigStore: SessionConfigStore,\n  sessionKey: string,\n  agentDefault?: ReasoningLevel\n): Promise<ReasoningLevel | undefined> {\n  const config = await sessionConfigStore.get(sessionKey);\n  \n  if (config?.reasoningLevel) {\n    return config.reasoningLevel;\n  }\n  \n  return agentDefault;\n}\n\n/**\n * Resolve verbose level for a session.\n */\nexport async function resolveVerboseLevel(\n  sessionConfigStore: SessionConfigStore,\n  sessionKey: string,\n  agentDefault?: VerboseLevel\n): Promise<VerboseLevel | undefined> {\n  const config = await sessionConfigStore.get(sessionKey);\n  \n  if (config?.verboseLevel) {\n    return config.verboseLevel;\n  }\n  \n  return agentDefault;\n}\n"],"mappings":"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"}

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

@@ -9,8 +9,15 @@ export { SessionConfigStore, resolveThinkingLevel, resolveReasoningLevel, resolv
 export { resolveEffectiveThinkingLevel, resolveEffectiveReasoningLevel } from './thinking-resolve.js';
 export type { SessionAgentConfig } from './config-store.js';
 export { normalizeWorkingDirectoryInput, effectiveWorkspacePathForSession, } from './session-workspace.js';
-export { SessionStatus, type SessionMetadata, type SessionDetail, type SessionIndex, type SessionListQuery, type PaginatedResult, type SessionStats, type ExportFormat, type SessionExport, } from './types.js';
+export { SessionStatus, type SessionMetadata, type SessionDetail, type SessionIndex, type SessionListQuery, type PaginatedResult, type SessionStats, type ExportFormat, type SessionExport, type SessionTranscriptSummary, type CompactionCheckpointSummary, type CompactionCheckpointDetail, } from './types.js';
+export { normalizeCompactionCheckpointId } from './compaction-checkpoints.js';
+export { shouldSkipWebchatInboundByAbortCutoff } from './abort-cutoff.js';
+export { stripTrailingWebchatEarlySaveUserIfPresent } from './strip-webchat-early-save.js';
 export type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';
 export type { WindowConfig } from '../agent/memory/window.js';
 export { maybeAutoTitleSessionStore, generateSessionTitleFromMessages, sanitizeSessionTitle, fallbackTitleFromMessages, isWebchatSessionKey, shouldAutoTitleSessionKey, } from './session-title.js';
 export { messagesToClientHistory, flattenMessageContent, type ClientHistoryMessage } from './client-history.js';
+export { XOPC_SESSION_TRANSCRIPT_TYPE, CURRENT_SESSION_TRANSCRIPT_VERSION, parseStoredTranscriptJson, buildTranscriptEnvelope, } from './transcript-format.js';
+export { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray, type TranscriptStoredRow, type XopcTranscriptContextEntry, } from './session-context-for-llm.js';
+export type { XopcSessionTranscriptV1, TranscriptCompactionRecord, } from './transcript-format.js';
+export { applySessionPatchToMetadata, type SessionPatchBody } from './patch-metadata.js';

package/dist/src/session/index.js

@@ -1,13 +1,19 @@
 import { fileStemToSessionKey } from "./session-file-key.js";
+import { buildSessionContextForLlm, isTranscriptContextEntry, mergeLlmMessagesPreservingContextRows, transcriptRowsFromJsonArray } from "./session-context-for-llm.js";
+import { CURRENT_SESSION_TRANSCRIPT_VERSION, XOPC_SESSION_TRANSCRIPT_TYPE, buildTranscriptEnvelope, parseStoredTranscriptJson } from "./transcript-format.js";
 import { SessionSearchIndex } from "./search-index.js";
 import { getOrLoadSessionSearchIndex, invalidateSessionSearchIndexCache } from "./search-index-cache.js";
 import { fallbackTitleFromMessages, generateSessionTitleFromMessages, isWebchatSessionKey, maybeAutoTitleSessionStore, sanitizeSessionTitle, shouldAutoTitleSessionKey } from "./session-title.js";
 import { resolveSessionShardRelativePath, sanitizeSessionPathSegment } from "./shard-path.js";
 import { SessionStatus } from "./types.js";
+import { normalizeCompactionCheckpointId } from "./compaction-checkpoints.js";
 import { SessionStore } from "./store.js";
+import { applySessionPatchToMetadata } from "./patch-metadata.js";
 import { SessionManager } from "./manager.js";
 import { SessionConfigStore, resolveReasoningLevel, resolveThinkingLevel, resolveVerboseLevel } from "./config-store.js";
 import { resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel } from "./thinking-resolve.js";
 import { effectiveWorkspacePathForSession, normalizeWorkingDirectoryInput } from "./session-workspace.js";
+import { shouldSkipWebchatInboundByAbortCutoff } from "./abort-cutoff.js";
+import { stripTrailingWebchatEarlySaveUserIfPresent } from "./strip-webchat-early-save.js";
 import { flattenMessageContent, messagesToClientHistory } from "./client-history.js";
-export { SessionConfigStore, SessionManager, SessionSearchIndex, SessionStatus, SessionStore, effectiveWorkspacePathForSession, fallbackTitleFromMessages, fileStemToSessionKey, flattenMessageContent, generateSessionTitleFromMessages, getOrLoadSessionSearchIndex, invalidateSessionSearchIndexCache, isWebchatSessionKey, maybeAutoTitleSessionStore, messagesToClientHistory, normalizeWorkingDirectoryInput, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveSessionShardRelativePath, resolveThinkingLevel, resolveVerboseLevel, sanitizeSessionPathSegment, sanitizeSessionTitle, shouldAutoTitleSessionKey };
+export { CURRENT_SESSION_TRANSCRIPT_VERSION, SessionConfigStore, SessionManager, SessionSearchIndex, SessionStatus, SessionStore, XOPC_SESSION_TRANSCRIPT_TYPE, applySessionPatchToMetadata, buildSessionContextForLlm, buildTranscriptEnvelope, effectiveWorkspacePathForSession, fallbackTitleFromMessages, fileStemToSessionKey, flattenMessageContent, generateSessionTitleFromMessages, getOrLoadSessionSearchIndex, invalidateSessionSearchIndexCache, isTranscriptContextEntry, isWebchatSessionKey, maybeAutoTitleSessionStore, mergeLlmMessagesPreservingContextRows, messagesToClientHistory, normalizeCompactionCheckpointId, normalizeWorkingDirectoryInput, parseStoredTranscriptJson, resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel, resolveReasoningLevel, resolveSessionShardRelativePath, resolveThinkingLevel, resolveVerboseLevel, sanitizeSessionPathSegment, sanitizeSessionTitle, shouldAutoTitleSessionKey, shouldSkipWebchatInboundByAbortCutoff, stripTrailingWebchatEarlySaveUserIfPresent, transcriptRowsFromJsonArray };

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

@@ -3,6 +3,9 @@ import { SessionStore } from './store.js';
 import type { SessionMetadata, SessionDetail, SessionListQuery, PaginatedResult, GlobalSessionStats, ExportFormat, SessionStatus } from './types.js';
 import type { Message } from './types.js';
 import type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';
+import type { XopcSessionTranscriptV1 } from './transcript-format.js';
+import type { XopcTranscriptContextEntry } from './session-context-for-llm.js';
+import { type SessionPatchBody } from './patch-metadata.js';
 import type { WindowConfig } from '../agent/memory/window.js';
 import type { Config } from '../config/schema.js';
 export interface SessionManagerConfig {
@@ -24,7 +27,19 @@ export declare class SessionManager extends EventEmitter {
      * Subagent sessions have keys starting with 'subagent:'.
      */
     listSubagents(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>>;
-    getSession(key: string): Promise<SessionDetail | null>;
+    getSession(key: string, options?: {
+        includeTranscriptSummary?: boolean;
+        includeTranscriptRows?: boolean;
+    }): Promise<SessionDetail | null>;
+    /**
+     * OpenClaw-style `sessions.patch`: partial metadata (name, tags, customData shallow merge).
+     */
+    patchSession(key: string, patch: SessionPatchBody): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    }>;
     getSessionMetadata(key: string): Promise<SessionMetadata | null>;
     deleteSession(key: string): Promise<boolean>;
     deleteSessions(keys: string[]): Promise<{
@@ -77,8 +92,14 @@ export declare class SessionManager extends EventEmitter {
     }) => void): void;
     /** Load messages for a session key */
     loadMessages(key: string): Promise<import("@mariozechner/pi-agent-core/dist/types.js").AgentMessage[]>;
+    /** Wrapped transcript document (stable id, compaction history); null if missing or not a valid envelope. */
+    loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null>;
     /** Save messages for a session key */
     saveMessages(key: string, messages: any[]): Promise<void>;
+    /**
+     * Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).
+     */
+    appendTranscriptContextEntry(key: string, entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>): Promise<void>;
     /** Delete session data */
     delete(key: string): Promise<void>;
     /** Token/window stats for a message list */
@@ -105,6 +126,10 @@ export declare class SessionManager extends EventEmitter {
         totalTokensAfter: number;
         lastCompactionAt: any;
     }>;
+    /** List pre-compaction transcript snapshots (newest first). */
+    listCompactionCheckpoints(key: string): Promise<import("./types.js").CompactionCheckpointSummary[]>;
+    getCompactionCheckpointDetail(key: string, checkpointId: string): Promise<import("./types.js").CompactionCheckpointDetail>;
+    restoreCompactionCheckpoint(key: string, checkpointId: string): Promise<void>;
     /** Estimate token usage for messages */
     estimateTokenUsage(key: string, messages: any[]): Promise<number>;
 }

package/dist/src/session/manager.js

@@ -1,6 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { SessionStore } from "./store.js";
+import { applySessionPatchToMetadata } from "./patch-metadata.js";
 import EventEmitter$1 from "events";
 //#region src/session/manager.ts
 init_logger();
@@ -44,11 +45,26 @@ var SessionManager = class extends EventEmitter$1 {
 			hasMore: false
 		};
 	}
-	async getSession(key) {
-		const session = await this.store.get(key);
+	async getSession(key, options) {
+		const session = await this.store.get(key, options);
 		if (session) this.emit("sessionAccessed", { key });
 		return session;
 	}
+	/**
+	* OpenClaw-style `sessions.patch`: partial metadata (name, tags, customData shallow merge).
+	*/
+	async patchSession(key, patch) {
+		const meta = await this.store.getMetadata(key);
+		if (!meta) return {
+			ok: false,
+			error: "Session not found"
+		};
+		const updates = applySessionPatchToMetadata(meta, patch);
+		if (Object.keys(updates).length === 0) return { ok: true };
+		await this.store.updateMetadata(key, updates);
+		this.emit("sessionUpdated", { key });
+		return { ok: true };
+	}
 	async getSessionMetadata(key) {
 		return this.store.getMetadata(key);
 	}
@@ -178,10 +194,21 @@ var SessionManager = class extends EventEmitter$1 {
 	async loadMessages(key) {
 		return this.store.loadMessages(key);
 	}
+	/** Wrapped transcript document (stable id, compaction history); null if missing or not a valid envelope. */
+	async loadTranscriptDocument(key) {
+		return this.store.loadTranscriptDocument(key);
+	}
 	/** Save messages for a session key */
 	async saveMessages(key, messages) {
 		return this.store.saveMessages(key, messages);
 	}
+	/**
+	* Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).
+	*/
+	async appendTranscriptContextEntry(key, entry) {
+		await this.store.appendTranscriptContextEntry(key, entry);
+		this.emit("sessionUpdated", { key });
+	}
 	/** Delete session data */
 	async delete(key) {
 		await this.store.delete(key);
@@ -202,6 +229,16 @@ var SessionManager = class extends EventEmitter$1 {
 	async getCompactionStats(key) {
 		return this.store.getCompactionStats(key);
 	}
+	/** List pre-compaction transcript snapshots (newest first). */
+	listCompactionCheckpoints(key) {
+		return this.store.listCompactionCheckpoints(key);
+	}
+	getCompactionCheckpointDetail(key, checkpointId) {
+		return this.store.getCompactionCheckpointDetail(key, checkpointId);
+	}
+	restoreCompactionCheckpoint(key, checkpointId) {
+		return this.store.restoreCompactionCheckpoint(key, checkpointId);
+	}
 	/** Estimate token usage for messages */
 	async estimateTokenUsage(key, messages) {
 		return this.store.estimateTokens(messages);

package/dist/src/session/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":["EventEmitter"],"sources":["../../../src/session/manager.ts"],"sourcesContent":["// Session manager - high-level session management service\n\nimport EventEmitter from 'events';\nimport { createLogger } from '../utils/logger.js';\nimport { SessionStore } from './store.js';\nimport type {\n  SessionMetadata,\n  SessionDetail,\n  SessionListQuery,\n  PaginatedResult,\n  GlobalSessionStats,\n  ExportFormat,\n  SessionStatus,\n} from './types.js';\nimport type { Message } from './types.js';\nimport type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';\nimport type { WindowConfig } from '../agent/memory/window.js';\nimport type { Config } from '../config/schema.js';\n\nconst log = createLogger('SessionManager');\n\nexport interface SessionManagerConfig {\n  config: Config;\n  agentId?: string;\n  sessionsDir?: string;\n  windowConfig?: Partial<WindowConfig>;\n  compactionConfig?: Partial<CompactionConfig>;\n}\n\nexport class SessionManager extends EventEmitter {\n  private store: SessionStore;\n\n  constructor(config: SessionManagerConfig) {\n    super();\n    this.store = new SessionStore(\n      {\n        config: config.config,\n        agentId: config.agentId,\n        sessionsDir: config.sessionsDir,\n      },\n      config.windowConfig,\n      config.compactionConfig\n    );\n  }\n\n  async initialize(): Promise<void> {\n    await this.store.initialize();\n    this.emit('ready');\n  }\n\n  /** Low-level store (e.g. cron resolving weixin delivery from session index). */\n  getStore(): SessionStore {\n    return this.store;\n  }\n\n  // ========== CRUD Operations ==========\n\n  async listSessions(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>> {\n    return this.store.list(query);\n  }\n\n  /**\n   * List all subagent sessions.\n   * Subagent sessions have keys starting with 'subagent:'.\n   */\n  async listSubagents(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    // Filter for subagent sessions only\n    const subagentQuery: SessionListQuery = {\n      ...query,\n      search: query.search ? `subagent:${query.search}` : 'subagent:',\n    };\n    \n    const result = await this.store.list(subagentQuery);\n    \n    // Additional filtering to ensure only subagent sessions\n    const subagentSessions = result.items.filter((s) => s.key.startsWith('subagent:'));\n    \n    return {\n      ...result,\n      items: subagentSessions,\n      total: subagentSessions.length,\n      hasMore: false, // Simplified for now\n    };\n  }\n\n  async getSession(key: string): Promise<SessionDetail | null> {\n    const session = await this.store.get(key);\n    if (session) {\n      this.emit('sessionAccessed', { key });\n    }\n    return session;\n  }\n\n  async getSessionMetadata(key: string): Promise<SessionMetadata | null> {\n    return this.store.getMetadata(key);\n  }\n\n  async deleteSession(key: string): Promise<boolean> {\n    const result = await this.store.delete(key);\n    if (result) {\n      this.emit('sessionDeleted', { key });\n    }\n    return result;\n  }\n\n  async deleteSessions(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    const result = await this.store.deleteMany(keys);\n    for (const key of result.success) {\n      this.emit('sessionDeleted', { key });\n    }\n    return result;\n  }\n\n  // ========== Metadata Updates ==========\n\n  async renameSession(key: string, name: string): Promise<void> {\n    await this.store.updateMetadata(key, { name });\n    this.emit('sessionUpdated', { key, name });\n  }\n\n  /** Partial metadata update (caller merges nested fields like `customData` when needed). */\n  async updateSessionMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void> {\n    await this.store.updateMetadata(key, updates);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async tagSession(key: string, tags: string[]): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    if (!existing) {\n      throw new Error(`Session not found: ${key}`);\n    }\n\n    // Merge tags, remove duplicates\n    const mergedTags = [...new Set([...existing.tags, ...tags])];\n    await this.store.updateMetadata(key, { tags: mergedTags });\n    this.emit('sessionUpdated', { key, tags: mergedTags });\n  }\n\n  async untagSession(key: string, tags: string[]): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    if (!existing) {\n      throw new Error(`Session not found: ${key}`);\n    }\n\n    const filteredTags = existing.tags.filter((t) => !tags.includes(t));\n    await this.store.updateMetadata(key, { tags: filteredTags });\n    this.emit('sessionUpdated', { key, tags: filteredTags });\n  }\n\n  async setSessionTags(key: string, tags: string[]): Promise<void> {\n    await this.store.updateMetadata(key, { tags: [...new Set(tags)] });\n    this.emit('sessionUpdated', { key, tags });\n  }\n\n  // ========== Status Management ==========\n\n  async archiveSession(key: string): Promise<void> {\n    await this.store.archive(key);\n    this.emit('sessionArchived', { key });\n  }\n\n  async unarchiveSession(key: string): Promise<void> {\n    await this.store.unarchive(key);\n    this.emit('sessionRestored', { key });\n  }\n\n  async pinSession(key: string): Promise<void> {\n    await this.store.pin(key);\n    this.emit('sessionPinned', { key });\n  }\n\n  async unpinSession(key: string): Promise<void> {\n    await this.store.unpin(key);\n    this.emit('sessionUnpinned', { key });\n  }\n\n  async setSessionStatus(key: string, status: SessionStatus): Promise<void> {\n    await this.store.setStatus(key, status);\n    this.emit('sessionStatusChanged', { key, status });\n  }\n\n  // ========== Search ==========\n\n  async searchSessions(query: string): Promise<SessionMetadata[]> {\n    const result = await this.store.list({ search: query, limit: 100 });\n    return result.items;\n  }\n\n  async searchInSession(key: string, keyword: string): Promise<Message[]> {\n    return this.store.searchInSession(key, keyword);\n  }\n\n  // ========== Export/Import ==========\n\n  async exportSession(key: string, format: ExportFormat): Promise<string> {\n    return this.store.exportSession(key, format);\n  }\n\n  // ========== Statistics ==========\n\n  async getStats(): Promise<GlobalSessionStats> {\n    return this.store.getStats();\n  }\n\n  // ========== Maintenance ==========\n\n  async archiveOldSessions(olderThanDays: number): Promise<number> {\n    const count = await this.store.archiveOld(olderThanDays);\n    log.info({ count, olderThanDays }, 'Archived old sessions');\n    return count;\n  }\n\n  // ========== Event Helpers ==========\n\n  onSessionCreated(callback: (metadata: SessionMetadata) => void): void {\n    this.on('sessionCreated', callback);\n  }\n\n  onSessionUpdated(callback: (data: { key: string; name?: string; tags?: string[] }) => void): void {\n    this.on('sessionUpdated', callback);\n  }\n\n  onSessionDeleted(callback: (data: { key: string }) => void): void {\n    this.on('sessionDeleted', callback);\n  }\n\n  onSessionArchived(callback: (data: { key: string }) => void): void {\n    this.on('sessionArchived', callback);\n  }\n\n  onSessionRestored(callback: (data: { key: string }) => void): void {\n    this.on('sessionRestored', callback);\n  }\n\n  onSessionPinned(callback: (data: { key: string }) => void): void {\n    this.on('sessionPinned', callback);\n  }\n\n  onSessionUnpinned(callback: (data: { key: string }) => void): void {\n    this.on('sessionUnpinned', callback);\n  }\n\n  onSessionStatusChanged(callback: (data: { key: string; status: SessionStatus }) => void): void {\n    this.on('sessionStatusChanged', callback);\n  }\n\n  onSessionAccessed(callback: (data: { key: string }) => void): void {\n    this.on('sessionAccessed', callback);\n  }\n\n  // ========== Store delegation (messages, compaction) ==========\n\n  /** Load messages for a session key */\n  async loadMessages(key: string) {\n    return this.store.loadMessages(key);\n  }\n\n  /** Save messages for a session key */\n  async saveMessages(key: string, messages: any[]) {\n    return this.store.saveMessages(key, messages);\n  }\n\n  /** Delete session data */\n  async delete(key: string): Promise<void> {\n    await this.store.delete(key);\n  }\n\n  /** Token/window stats for a message list */\n  getWindowStats(messages: any[]) {\n    return this.store.getWindowStats(messages);\n  }\n\n  /** Prepare compaction run */\n  prepareCompaction(key: string, messages: any[], contextWindow: number) {\n    return this.store.prepareCompaction(key, messages, contextWindow);\n  }\n\n  /** Compact session messages */\n  compact(\n    key: string,\n    messages: any[],\n    contextWindow: number,\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    return this.store.compact(key, messages, contextWindow, instructions, force);\n  }\n\n  /** Compaction stats for a session */\n  async getCompactionStats(key: string) {\n    return this.store.getCompactionStats(key);\n  }\n\n  /** Estimate token usage for messages */\n  async estimateTokenUsage(key: string, messages: any[]): Promise<number> {\n    return this.store.estimateTokens(messages);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"manager.js","names":["EventEmitter"],"sources":["../../../src/session/manager.ts"],"sourcesContent":["// Session manager - high-level session management service\n\nimport EventEmitter from 'events';\nimport { createLogger } from '../utils/logger.js';\nimport { SessionStore } from './store.js';\nimport type {\n  SessionMetadata,\n  SessionDetail,\n  SessionListQuery,\n  PaginatedResult,\n  GlobalSessionStats,\n  ExportFormat,\n  SessionStatus,\n} from './types.js';\nimport type { Message } from './types.js';\nimport type { CompactionConfig, CompactionResult } from '../agent/memory/compaction.js';\nimport type { XopcSessionTranscriptV1 } from './transcript-format.js';\nimport type { XopcTranscriptContextEntry } from './session-context-for-llm.js';\nimport { applySessionPatchToMetadata, type SessionPatchBody } from './patch-metadata.js';\nimport type { WindowConfig } from '../agent/memory/window.js';\nimport type { Config } from '../config/schema.js';\n\nconst log = createLogger('SessionManager');\n\nexport interface SessionManagerConfig {\n  config: Config;\n  agentId?: string;\n  sessionsDir?: string;\n  windowConfig?: Partial<WindowConfig>;\n  compactionConfig?: Partial<CompactionConfig>;\n}\n\nexport class SessionManager extends EventEmitter {\n  private store: SessionStore;\n\n  constructor(config: SessionManagerConfig) {\n    super();\n    this.store = new SessionStore(\n      {\n        config: config.config,\n        agentId: config.agentId,\n        sessionsDir: config.sessionsDir,\n      },\n      config.windowConfig,\n      config.compactionConfig\n    );\n  }\n\n  async initialize(): Promise<void> {\n    await this.store.initialize();\n    this.emit('ready');\n  }\n\n  /** Low-level store (e.g. cron resolving weixin delivery from session index). */\n  getStore(): SessionStore {\n    return this.store;\n  }\n\n  // ========== CRUD Operations ==========\n\n  async listSessions(query?: SessionListQuery): Promise<PaginatedResult<SessionMetadata>> {\n    return this.store.list(query);\n  }\n\n  /**\n   * List all subagent sessions.\n   * Subagent sessions have keys starting with 'subagent:'.\n   */\n  async listSubagents(query: SessionListQuery = {}): Promise<PaginatedResult<SessionMetadata>> {\n    // Filter for subagent sessions only\n    const subagentQuery: SessionListQuery = {\n      ...query,\n      search: query.search ? `subagent:${query.search}` : 'subagent:',\n    };\n    \n    const result = await this.store.list(subagentQuery);\n    \n    // Additional filtering to ensure only subagent sessions\n    const subagentSessions = result.items.filter((s) => s.key.startsWith('subagent:'));\n    \n    return {\n      ...result,\n      items: subagentSessions,\n      total: subagentSessions.length,\n      hasMore: false, // Simplified for now\n    };\n  }\n\n  async getSession(\n    key: string,\n    options?: { includeTranscriptSummary?: boolean; includeTranscriptRows?: boolean },\n  ): Promise<SessionDetail | null> {\n    const session = await this.store.get(key, options);\n    if (session) {\n      this.emit('sessionAccessed', { key });\n    }\n    return session;\n  }\n\n  /**\n   * OpenClaw-style `sessions.patch`: partial metadata (name, tags, customData shallow merge).\n   */\n  async patchSession(\n    key: string,\n    patch: SessionPatchBody,\n  ): Promise<{ ok: true } | { ok: false; error: string }> {\n    const meta = await this.store.getMetadata(key);\n    if (!meta) {\n      return { ok: false, error: 'Session not found' };\n    }\n    const updates = applySessionPatchToMetadata(meta, patch);\n    if (Object.keys(updates).length === 0) {\n      return { ok: true };\n    }\n    await this.store.updateMetadata(key, updates);\n    this.emit('sessionUpdated', { key });\n    return { ok: true };\n  }\n\n  async getSessionMetadata(key: string): Promise<SessionMetadata | null> {\n    return this.store.getMetadata(key);\n  }\n\n  async deleteSession(key: string): Promise<boolean> {\n    const result = await this.store.delete(key);\n    if (result) {\n      this.emit('sessionDeleted', { key });\n    }\n    return result;\n  }\n\n  async deleteSessions(keys: string[]): Promise<{ success: string[]; failed: string[] }> {\n    const result = await this.store.deleteMany(keys);\n    for (const key of result.success) {\n      this.emit('sessionDeleted', { key });\n    }\n    return result;\n  }\n\n  // ========== Metadata Updates ==========\n\n  async renameSession(key: string, name: string): Promise<void> {\n    await this.store.updateMetadata(key, { name });\n    this.emit('sessionUpdated', { key, name });\n  }\n\n  /** Partial metadata update (caller merges nested fields like `customData` when needed). */\n  async updateSessionMetadata(key: string, updates: Partial<SessionMetadata>): Promise<void> {\n    await this.store.updateMetadata(key, updates);\n    this.emit('sessionUpdated', { key });\n  }\n\n  async tagSession(key: string, tags: string[]): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    if (!existing) {\n      throw new Error(`Session not found: ${key}`);\n    }\n\n    // Merge tags, remove duplicates\n    const mergedTags = [...new Set([...existing.tags, ...tags])];\n    await this.store.updateMetadata(key, { tags: mergedTags });\n    this.emit('sessionUpdated', { key, tags: mergedTags });\n  }\n\n  async untagSession(key: string, tags: string[]): Promise<void> {\n    const existing = await this.store.getMetadata(key);\n    if (!existing) {\n      throw new Error(`Session not found: ${key}`);\n    }\n\n    const filteredTags = existing.tags.filter((t) => !tags.includes(t));\n    await this.store.updateMetadata(key, { tags: filteredTags });\n    this.emit('sessionUpdated', { key, tags: filteredTags });\n  }\n\n  async setSessionTags(key: string, tags: string[]): Promise<void> {\n    await this.store.updateMetadata(key, { tags: [...new Set(tags)] });\n    this.emit('sessionUpdated', { key, tags });\n  }\n\n  // ========== Status Management ==========\n\n  async archiveSession(key: string): Promise<void> {\n    await this.store.archive(key);\n    this.emit('sessionArchived', { key });\n  }\n\n  async unarchiveSession(key: string): Promise<void> {\n    await this.store.unarchive(key);\n    this.emit('sessionRestored', { key });\n  }\n\n  async pinSession(key: string): Promise<void> {\n    await this.store.pin(key);\n    this.emit('sessionPinned', { key });\n  }\n\n  async unpinSession(key: string): Promise<void> {\n    await this.store.unpin(key);\n    this.emit('sessionUnpinned', { key });\n  }\n\n  async setSessionStatus(key: string, status: SessionStatus): Promise<void> {\n    await this.store.setStatus(key, status);\n    this.emit('sessionStatusChanged', { key, status });\n  }\n\n  // ========== Search ==========\n\n  async searchSessions(query: string): Promise<SessionMetadata[]> {\n    const result = await this.store.list({ search: query, limit: 100 });\n    return result.items;\n  }\n\n  async searchInSession(key: string, keyword: string): Promise<Message[]> {\n    return this.store.searchInSession(key, keyword);\n  }\n\n  // ========== Export/Import ==========\n\n  async exportSession(key: string, format: ExportFormat): Promise<string> {\n    return this.store.exportSession(key, format);\n  }\n\n  // ========== Statistics ==========\n\n  async getStats(): Promise<GlobalSessionStats> {\n    return this.store.getStats();\n  }\n\n  // ========== Maintenance ==========\n\n  async archiveOldSessions(olderThanDays: number): Promise<number> {\n    const count = await this.store.archiveOld(olderThanDays);\n    log.info({ count, olderThanDays }, 'Archived old sessions');\n    return count;\n  }\n\n  // ========== Event Helpers ==========\n\n  onSessionCreated(callback: (metadata: SessionMetadata) => void): void {\n    this.on('sessionCreated', callback);\n  }\n\n  onSessionUpdated(callback: (data: { key: string; name?: string; tags?: string[] }) => void): void {\n    this.on('sessionUpdated', callback);\n  }\n\n  onSessionDeleted(callback: (data: { key: string }) => void): void {\n    this.on('sessionDeleted', callback);\n  }\n\n  onSessionArchived(callback: (data: { key: string }) => void): void {\n    this.on('sessionArchived', callback);\n  }\n\n  onSessionRestored(callback: (data: { key: string }) => void): void {\n    this.on('sessionRestored', callback);\n  }\n\n  onSessionPinned(callback: (data: { key: string }) => void): void {\n    this.on('sessionPinned', callback);\n  }\n\n  onSessionUnpinned(callback: (data: { key: string }) => void): void {\n    this.on('sessionUnpinned', callback);\n  }\n\n  onSessionStatusChanged(callback: (data: { key: string; status: SessionStatus }) => void): void {\n    this.on('sessionStatusChanged', callback);\n  }\n\n  onSessionAccessed(callback: (data: { key: string }) => void): void {\n    this.on('sessionAccessed', callback);\n  }\n\n  // ========== Store delegation (messages, compaction) ==========\n\n  /** Load messages for a session key */\n  async loadMessages(key: string) {\n    return this.store.loadMessages(key);\n  }\n\n  /** Wrapped transcript document (stable id, compaction history); null if missing or not a valid envelope. */\n  async loadTranscriptDocument(key: string): Promise<XopcSessionTranscriptV1 | null> {\n    return this.store.loadTranscriptDocument(key);\n  }\n\n  /** Save messages for a session key */\n  async saveMessages(key: string, messages: any[]) {\n    return this.store.saveMessages(key, messages);\n  }\n\n  /**\n   * Append `kind: 'context'` transcript row (persisted, excluded from {@link loadMessages} / LLM).\n   */\n  async appendTranscriptContextEntry(\n    key: string,\n    entry: Omit<XopcTranscriptContextEntry, 'kind'> & Partial<Pick<XopcTranscriptContextEntry, 'kind'>>,\n  ): Promise<void> {\n    await this.store.appendTranscriptContextEntry(key, entry);\n    this.emit('sessionUpdated', { key });\n  }\n\n  /** Delete session data */\n  async delete(key: string): Promise<void> {\n    await this.store.delete(key);\n  }\n\n  /** Token/window stats for a message list */\n  getWindowStats(messages: any[]) {\n    return this.store.getWindowStats(messages);\n  }\n\n  /** Prepare compaction run */\n  prepareCompaction(key: string, messages: any[], contextWindow: number) {\n    return this.store.prepareCompaction(key, messages, contextWindow);\n  }\n\n  /** Compact session messages */\n  compact(\n    key: string,\n    messages: any[],\n    contextWindow: number,\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    return this.store.compact(key, messages, contextWindow, instructions, force);\n  }\n\n  /** Compaction stats for a session */\n  async getCompactionStats(key: string) {\n    return this.store.getCompactionStats(key);\n  }\n\n  /** List pre-compaction transcript snapshots (newest first). */\n  listCompactionCheckpoints(key: string) {\n    return this.store.listCompactionCheckpoints(key);\n  }\n\n  getCompactionCheckpointDetail(key: string, checkpointId: string) {\n    return this.store.getCompactionCheckpointDetail(key, checkpointId);\n  }\n\n  restoreCompactionCheckpoint(key: string, checkpointId: string) {\n    return this.store.restoreCompactionCheckpoint(key, checkpointId);\n  }\n\n  /** Estimate token usage for messages */\n  async estimateTokenUsage(key: string, messages: any[]): Promise<number> {\n    return this.store.estimateTokens(messages);\n  }\n}\n"],"mappings":"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"}

package/dist/src/session/patch-metadata.d.ts

@@ -0,0 +1,12 @@
+/**
+ * OpenClaw-style partial session row updates: merge tags and shallow-merge customData.
+ */
+import type { SessionMetadata } from './types.js';
+export type SessionPatchBody = {
+    name?: string;
+    tags?: string[];
+    /** When true, `tags` replaces the tag list; otherwise tags are union-merged. */
+    replaceTags?: boolean;
+    customData?: Record<string, unknown>;
+};
+export declare function applySessionPatchToMetadata(existing: SessionMetadata, patch: SessionPatchBody): Partial<SessionMetadata>;

package/dist/src/session/patch-metadata.js

@@ -0,0 +1,23 @@
+//#region src/session/patch-metadata.ts
+function applySessionPatchToMetadata(existing, patch) {
+	const out = {};
+	if (typeof patch.name === "string") {
+		const t = patch.name.trim();
+		if (t.length > 0) out.name = t;
+		else out.name = void 0;
+	}
+	if (patch.tags !== void 0 && Array.isArray(patch.tags)) {
+		const normalized = [...new Set(patch.tags.map((t) => String(t).trim()).filter(Boolean))];
+		if (patch.replaceTags) out.tags = normalized;
+		else out.tags = [...new Set([...existing.tags, ...normalized])];
+	}
+	if (patch.customData !== void 0 && typeof patch.customData === "object" && patch.customData !== null) out.customData = {
+		...existing.customData ?? {},
+		...patch.customData
+	};
+	return out;
+}
+//#endregion
+export { applySessionPatchToMetadata };
+
+//# sourceMappingURL=patch-metadata.js.map

package/dist/src/session/patch-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-metadata.js","names":[],"sources":["../../../src/session/patch-metadata.ts"],"sourcesContent":["/**\n * OpenClaw-style partial session row updates: merge tags and shallow-merge customData.\n */\n\nimport type { SessionMetadata } from './types.js';\n\nexport type SessionPatchBody = {\n  name?: string;\n  tags?: string[];\n  /** When true, `tags` replaces the tag list; otherwise tags are union-merged. */\n  replaceTags?: boolean;\n  customData?: Record<string, unknown>;\n};\n\nexport function applySessionPatchToMetadata(\n  existing: SessionMetadata,\n  patch: SessionPatchBody,\n): Partial<SessionMetadata> {\n  const out: Partial<SessionMetadata> = {};\n\n  if (typeof patch.name === 'string') {\n    const t = patch.name.trim();\n    if (t.length > 0) {\n      out.name = t;\n    } else {\n      out.name = undefined;\n    }\n  }\n\n  if (patch.tags !== undefined && Array.isArray(patch.tags)) {\n    const normalized = [...new Set(patch.tags.map((t) => String(t).trim()).filter(Boolean))];\n    if (patch.replaceTags) {\n      out.tags = normalized;\n    } else {\n      out.tags = [...new Set([...existing.tags, ...normalized])];\n    }\n  }\n\n  if (patch.customData !== undefined && typeof patch.customData === 'object' && patch.customData !== null) {\n    out.customData = { ...(existing.customData ?? {}), ...patch.customData };\n  }\n\n  return out;\n}\n"],"mappings":";AAcA,SAAgB,4BACd,UACA,OAC0B;CAC1B,MAAM,MAAgC,EAAE;AAExC,KAAI,OAAO,MAAM,SAAS,UAAU;EAClC,MAAM,IAAI,MAAM,KAAK,MAAM;AAC3B,MAAI,EAAE,SAAS,EACb,KAAI,OAAO;MAEX,KAAI,OAAO,KAAA;;AAIf,KAAI,MAAM,SAAS,KAAA,KAAa,MAAM,QAAQ,MAAM,KAAK,EAAE;EACzD,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,MAAM,KAAK,KAAK,MAAM,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC;AACxF,MAAI,MAAM,YACR,KAAI,OAAO;MAEX,KAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC;;AAI9D,KAAI,MAAM,eAAe,KAAA,KAAa,OAAO,MAAM,eAAe,YAAY,MAAM,eAAe,KACjG,KAAI,aAAa;EAAE,GAAI,SAAS,cAAc,EAAE;EAAG,GAAG,MAAM;EAAY;AAG1E,QAAO"}

package/dist/src/session/search-index.d.ts

@@ -17,5 +17,7 @@ export declare class SessionSearchIndex {
     private extractSessionKeyFromPath;
     private findSessionJsonFiles;
     private buildWordIndex;
+    /** Index `kind: 'context'` `text` / `id` so session search matches audit rows (synthetic slot indices). */
+    private mergeContextTextIntoWordIndex;
     private mergeIntoGlobalIndex;
 }

package/dist/src/session/search-index.js

@@ -1,5 +1,7 @@
 import { FILENAMES, init_paths } from "../config/paths.js";
 import { fileStemToSessionKey } from "./session-file-key.js";
+import { isTranscriptContextEntry } from "./session-context-for-llm.js";
+import { parseStoredTranscriptJson } from "./transcript-format.js";
 import { basename, join } from "node:path";
 import { readFile, readdir } from "node:fs/promises";
 //#region src/session/search-index.ts
@@ -19,10 +21,17 @@ var SessionSearchIndex = class {
 		const files = await this.findSessionJsonFiles(sessionsRoot);
 		for (const file of files) try {
 			const raw = await readFile(file, "utf-8");
-			const messages = JSON.parse(raw);
-			if (!Array.isArray(messages)) continue;
+			if (!raw.trim()) continue;
+			try {
+				JSON.parse(raw);
+			} catch {
+				continue;
+			}
+			const { messages, rows, envelope } = parseStoredTranscriptJson(raw);
+			if (!envelope) continue;
 			const key = this.extractSessionKeyFromPath(file);
 			const wordIndex = this.buildWordIndex(messages);
+			this.mergeContextTextIntoWordIndex(wordIndex, rows, messages.length);
 			const indexed = {
 				key,
 				messages,
@@ -84,6 +93,25 @@ var SessionSearchIndex = class {
 		}
 		return index;
 	}
+	/** Index `kind: 'context'` `text` / `id` so session search matches audit rows (synthetic slot indices). */
+	mergeContextTextIntoWordIndex(wordIndex, rows, llmMessageCount) {
+		let slot = 0;
+		for (const r of rows) {
+			if (!isTranscriptContextEntry(r)) continue;
+			const parts = [];
+			if (typeof r.text === "string" && r.text.trim()) parts.push(r.text);
+			if (typeof r.id === "string" && r.id.trim()) parts.push(r.id);
+			const blob = parts.join(" ");
+			if (!blob.trim()) continue;
+			const words = tokenizeWords(blob);
+			const idx = llmMessageCount + slot;
+			slot += 1;
+			for (const word of words) {
+				if (!wordIndex.has(word)) wordIndex.set(word, /* @__PURE__ */ new Set());
+				wordIndex.get(word).add(idx);
+			}
+		}
+	}
 	mergeIntoGlobalIndex(sessionKey, wordIndex) {
 		for (const word of wordIndex.keys()) {
 			if (!this.globalWordIndex.has(word)) this.globalWordIndex.set(word, /* @__PURE__ */ new Set());