@xopcai/xopc 0.0.95 → 0.0.97

package/dist/src/session/parity/sessions-json-cache.js

@@ -1,98 +0,0 @@
-import { readSessionsJsonFileRaw } from "./sessions-json-file-read.js";
-import { existsSync } from "node:fs";
-import { stat } from "node:fs/promises";
-//#region src/session/parity/sessions-json-cache.ts
-const readCache = /* @__PURE__ */ new Map();
-const serializedWriteCache = /* @__PURE__ */ new Map();
-let writeStats = {
-	performed: 0,
-	skippedUnchanged: 0
-};
-function getSessionsJsonWriteStats() {
-	return writeStats;
-}
-function resetSessionsJsonCacheForTest() {
-	readCache.clear();
-	serializedWriteCache.clear();
-	writeStats = {
-		performed: 0,
-		skippedUnchanged: 0
-	};
-}
-function invalidateSessionsJsonCache(storePath) {
-	readCache.delete(storePath);
-	serializedWriteCache.delete(storePath);
-}
-function serializeSessionsJson(store) {
-	return `${JSON.stringify(store, null, 2)}\n`;
-}
-async function readSessionsJsonCached(storePath) {
-	if (!existsSync(storePath)) return {
-		store: {},
-		serialized: "{}\n"
-	};
-	let mtimeMs = 0;
-	let sizeBytes = 0;
-	try {
-		const st = await stat(storePath);
-		mtimeMs = st.mtimeMs;
-		sizeBytes = st.size;
-	} catch {
-		return {
-			store: {},
-			serialized: "{}\n"
-		};
-	}
-	const cached = readCache.get(storePath);
-	if (cached && cached.mtimeMs === mtimeMs && cached.sizeBytes === sizeBytes) return {
-		store: structuredClone(cached.parsed),
-		serialized: cached.serialized
-	};
-	const store = await readSessionsJsonFileRaw(storePath);
-	const serialized = serializeSessionsJson(store);
-	readCache.set(storePath, {
-		mtimeMs,
-		sizeBytes,
-		parsed: structuredClone(store),
-		serialized
-	});
-	serializedWriteCache.set(storePath, serialized);
-	return {
-		store: structuredClone(store),
-		serialized
-	};
-}
-function commitSessionsJsonWrite(storePath, store, serialized) {
-	if (serializedWriteCache.get(storePath) === serialized) {
-		writeStats.skippedUnchanged += 1;
-		readCache.set(storePath, {
-			mtimeMs: readCache.get(storePath)?.mtimeMs ?? Date.now(),
-			sizeBytes: serialized.length,
-			parsed: structuredClone(store),
-			serialized
-		});
-		return false;
-	}
-	serializedWriteCache.set(storePath, serialized);
-	writeStats.performed += 1;
-	readCache.set(storePath, {
-		mtimeMs: Date.now(),
-		sizeBytes: serialized.length,
-		parsed: structuredClone(store),
-		serialized
-	});
-	return true;
-}
-function noteSessionsJsonWritten(storePath, serialized, store) {
-	serializedWriteCache.set(storePath, serialized);
-	readCache.set(storePath, {
-		mtimeMs: Date.now(),
-		sizeBytes: serialized.length,
-		parsed: structuredClone(store),
-		serialized
-	});
-}
-//#endregion
-export { commitSessionsJsonWrite, getSessionsJsonWriteStats, invalidateSessionsJsonCache, noteSessionsJsonWritten, readSessionsJsonCached, resetSessionsJsonCacheForTest };
-
-//# sourceMappingURL=sessions-json-cache.js.map

package/dist/src/session/parity/sessions-json-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sessions-json-cache.js","names":[],"sources":["../../../../src/session/parity/sessions-json-cache.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\n\nimport { readSessionsJsonFileRaw } from './sessions-json-file-read.js';\n\ntype ReadCacheEntry = {\n  mtimeMs: number;\n  sizeBytes: number;\n  parsed: Record<string, unknown>;\n  serialized: string;\n};\n\nconst readCache = new Map<string, ReadCacheEntry>();\nconst serializedWriteCache = new Map<string, string>();\n\nlet writeStats = {\n  performed: 0,\n  skippedUnchanged: 0,\n};\n\nexport function getSessionsJsonWriteStats(): Readonly<typeof writeStats> {\n  return writeStats;\n}\n\nexport function resetSessionsJsonCacheForTest(): void {\n  readCache.clear();\n  serializedWriteCache.clear();\n  writeStats = { performed: 0, skippedUnchanged: 0 };\n}\n\nexport function invalidateSessionsJsonCache(storePath: string): void {\n  readCache.delete(storePath);\n  serializedWriteCache.delete(storePath);\n}\n\nfunction serializeSessionsJson(store: Record<string, unknown>): string {\n  return `${JSON.stringify(store, null, 2)}\\n`;\n}\n\nexport async function readSessionsJsonCached(\n  storePath: string,\n): Promise<{ store: Record<string, unknown>; serialized: string }> {\n  if (!existsSync(storePath)) {\n    return { store: {}, serialized: '{}\\n' };\n  }\n\n  let mtimeMs = 0;\n  let sizeBytes = 0;\n  try {\n    const st = await stat(storePath);\n    mtimeMs = st.mtimeMs;\n    sizeBytes = st.size;\n  } catch {\n    return { store: {}, serialized: '{}\\n' };\n  }\n\n  const cached = readCache.get(storePath);\n  if (cached && cached.mtimeMs === mtimeMs && cached.sizeBytes === sizeBytes) {\n    return { store: structuredClone(cached.parsed), serialized: cached.serialized };\n  }\n\n  const store = await readSessionsJsonFileRaw(storePath);\n  const serialized = serializeSessionsJson(store);\n  readCache.set(storePath, { mtimeMs, sizeBytes, parsed: structuredClone(store), serialized });\n  serializedWriteCache.set(storePath, serialized);\n  return { store: structuredClone(store), serialized };\n}\n\nexport function commitSessionsJsonWrite(\n  storePath: string,\n  store: Record<string, unknown>,\n  serialized: string,\n): boolean {\n  const previous = serializedWriteCache.get(storePath);\n  if (previous === serialized) {\n    writeStats.skippedUnchanged += 1;\n    readCache.set(storePath, {\n      mtimeMs: readCache.get(storePath)?.mtimeMs ?? Date.now(),\n      sizeBytes: serialized.length,\n      parsed: structuredClone(store),\n      serialized,\n    });\n    return false;\n  }\n\n  serializedWriteCache.set(storePath, serialized);\n  writeStats.performed += 1;\n  readCache.set(storePath, {\n    mtimeMs: Date.now(),\n    sizeBytes: serialized.length,\n    parsed: structuredClone(store),\n    serialized,\n  });\n  return true;\n}\n\nexport function noteSessionsJsonWritten(storePath: string, serialized: string, store: Record<string, unknown>): void {\n  serializedWriteCache.set(storePath, serialized);\n  readCache.set(storePath, {\n    mtimeMs: Date.now(),\n    sizeBytes: serialized.length,\n    parsed: structuredClone(store),\n    serialized,\n  });\n}\n"],"mappings":";;;;AAYA,MAAM,4BAAY,IAAI,KAA6B;AACnD,MAAM,uCAAuB,IAAI,KAAqB;AAEtD,IAAI,aAAa;CACf,WAAW;CACX,kBAAkB;CACnB;AAED,SAAgB,4BAAyD;AACvE,QAAO;;AAGT,SAAgB,gCAAsC;AACpD,WAAU,OAAO;AACjB,sBAAqB,OAAO;AAC5B,cAAa;EAAE,WAAW;EAAG,kBAAkB;EAAG;;AAGpD,SAAgB,4BAA4B,WAAyB;AACnE,WAAU,OAAO,UAAU;AAC3B,sBAAqB,OAAO,UAAU;;AAGxC,SAAS,sBAAsB,OAAwC;AACrE,QAAO,GAAG,KAAK,UAAU,OAAO,MAAM,EAAE,CAAC;;AAG3C,eAAsB,uBACpB,WACiE;AACjE,KAAI,CAAC,WAAW,UAAU,CACxB,QAAO;EAAE,OAAO,EAAE;EAAE,YAAY;EAAQ;CAG1C,IAAI,UAAU;CACd,IAAI,YAAY;AAChB,KAAI;EACF,MAAM,KAAK,MAAM,KAAK,UAAU;AAChC,YAAU,GAAG;AACb,cAAY,GAAG;SACT;AACN,SAAO;GAAE,OAAO,EAAE;GAAE,YAAY;GAAQ;;CAG1C,MAAM,SAAS,UAAU,IAAI,UAAU;AACvC,KAAI,UAAU,OAAO,YAAY,WAAW,OAAO,cAAc,UAC/D,QAAO;EAAE,OAAO,gBAAgB,OAAO,OAAO;EAAE,YAAY,OAAO;EAAY;CAGjF,MAAM,QAAQ,MAAM,wBAAwB,UAAU;CACtD,MAAM,aAAa,sBAAsB,MAAM;AAC/C,WAAU,IAAI,WAAW;EAAE;EAAS;EAAW,QAAQ,gBAAgB,MAAM;EAAE;EAAY,CAAC;AAC5F,sBAAqB,IAAI,WAAW,WAAW;AAC/C,QAAO;EAAE,OAAO,gBAAgB,MAAM;EAAE;EAAY;;AAGtD,SAAgB,wBACd,WACA,OACA,YACS;AAET,KADiB,qBAAqB,IAAI,UAC9B,KAAK,YAAY;AAC3B,aAAW,oBAAoB;AAC/B,YAAU,IAAI,WAAW;GACvB,SAAS,UAAU,IAAI,UAAU,EAAE,WAAW,KAAK,KAAK;GACxD,WAAW,WAAW;GACtB,QAAQ,gBAAgB,MAAM;GAC9B;GACD,CAAC;AACF,SAAO;;AAGT,sBAAqB,IAAI,WAAW,WAAW;AAC/C,YAAW,aAAa;AACxB,WAAU,IAAI,WAAW;EACvB,SAAS,KAAK,KAAK;EACnB,WAAW,WAAW;EACtB,QAAQ,gBAAgB,MAAM;EAC9B;EACD,CAAC;AACF,QAAO;;AAGT,SAAgB,wBAAwB,WAAmB,YAAoB,OAAsC;AACnH,sBAAqB,IAAI,WAAW,WAAW;AAC/C,WAAU,IAAI,WAAW;EACvB,SAAS,KAAK,KAAK;EACnB,WAAW,WAAW;EACtB,QAAQ,gBAAgB,MAAM;EAC9B;EACD,CAAC"}

package/dist/src/session/parity/sessions-json-file-read.d.ts

@@ -1,6 +0,0 @@
-type SessionsJsonMap<T> = Record<string, T>;
-/**
- * Raw disk read for sessions.json (no in-memory cache).
- */
-export declare function readSessionsJsonFileRaw<T extends Record<string, unknown>>(storePath: string): Promise<SessionsJsonMap<T>>;
-export {};

package/dist/src/session/parity/sessions-json-file-read.js

@@ -1,19 +0,0 @@
-import { readFile } from "node:fs/promises";
-//#region src/session/parity/sessions-json-file-read.ts
-/**
-* Raw disk read for sessions.json (no in-memory cache).
-*/
-async function readSessionsJsonFileRaw(storePath) {
-	try {
-		const raw = await readFile(storePath, "utf-8");
-		const parsed = JSON.parse(raw);
-		if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
-		return parsed;
-	} catch {
-		return {};
-	}
-}
-//#endregion
-export { readSessionsJsonFileRaw };
-
-//# sourceMappingURL=sessions-json-file-read.js.map

package/dist/src/session/parity/sessions-json-file-read.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sessions-json-file-read.js","names":[],"sources":["../../../../src/session/parity/sessions-json-file-read.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\n\n// Type duplicated inline — `sessions-json-file.ts` imports a value from this\n// file (cache.ts → file-read.ts → file.ts), so re-importing the type back\n// would close the loop. The shape is trivial so we declare it locally.\ntype SessionsJsonMap<T> = Record<string, T>;\n\n/**\n * Raw disk read for sessions.json (no in-memory cache).\n */\nexport async function readSessionsJsonFileRaw<T extends Record<string, unknown>>(\n  storePath: string,\n): Promise<SessionsJsonMap<T>> {\n  try {\n    const raw = await readFile(storePath, 'utf-8');\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {\n      return {};\n    }\n    return parsed as SessionsJsonMap<T>;\n  } catch {\n    return {};\n  }\n}\n"],"mappings":";;;;;AAUA,eAAsB,wBACpB,WAC6B;AAC7B,KAAI;EACF,MAAM,MAAM,MAAM,SAAS,WAAW,QAAQ;EAC9C,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,CAChE,QAAO,EAAE;AAEX,SAAO;SACD;AACN,SAAO,EAAE"}

package/dist/src/session/parity/sessions-json-file.d.ts

@@ -1,11 +0,0 @@
-export type SessionsJsonMap<T> = Record<string, T>;
-/**
- * Read JSON object from `sessions.json`. Missing file → `{}`.
- * Uses mtime/size cache when enabled.
- */
-export declare function readSessionsJsonFile<T extends Record<string, unknown>>(storePath: string): Promise<SessionsJsonMap<T>>;
-/**
- * Exclusive update: lock → read → mutate → atomic write (skipped when serialized unchanged) → unlock.
- */
-export declare function withSessionsJsonLock<T>(storePath: string, fn: (store: SessionsJsonMap<Record<string, unknown>>) => Promise<T>): Promise<T>;
-export { invalidateSessionsJsonCache, getSessionsJsonWriteStats, resetSessionsJsonCacheForTest } from './sessions-json-cache.js';

package/dist/src/session/parity/sessions-json-file.js

@@ -1,52 +0,0 @@
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
-import { readSessionsJsonFileRaw } from "./sessions-json-file-read.js";
-import { commitSessionsJsonWrite, getSessionsJsonWriteStats, invalidateSessionsJsonCache, noteSessionsJsonWritten, readSessionsJsonCached, resetSessionsJsonCacheForTest } from "./sessions-json-cache.js";
-import { dirname } from "node:path";
-import { existsSync } from "node:fs";
-import { mkdir } from "node:fs/promises";
-import lockfile from "proper-lockfile";
-//#region src/session/parity/sessions-json-file.ts
-init_write_file_atomic();
-async function ensureDirForFile(filePath) {
-	await mkdir(dirname(filePath), { recursive: true });
-}
-function serializeSessionsJson(store) {
-	return `${JSON.stringify(store, null, 2)}\n`;
-}
-/**
-* Read JSON object from `sessions.json`. Missing file → `{}`.
-* Uses mtime/size cache when enabled.
-*/
-async function readSessionsJsonFile(storePath) {
-	if (!existsSync(storePath)) return {};
-	const { store } = await readSessionsJsonCached(storePath);
-	return store;
-}
-/**
-* Exclusive update: lock → read → mutate → atomic write (skipped when serialized unchanged) → unlock.
-*/
-async function withSessionsJsonLock(storePath, fn) {
-	await ensureDirForFile(storePath);
-	if (!existsSync(storePath)) {
-		await writeTextAtomic(storePath, "{}\n");
-		noteSessionsJsonWritten(storePath, "{}\n", {});
-	}
-	const release = await lockfile.lock(storePath, { retries: {
-		retries: 30,
-		minTimeout: 50,
-		maxTimeout: 500
-	} });
-	try {
-		const data = existsSync(storePath) ? await readSessionsJsonFileRaw(storePath) : {};
-		const result = await fn(data);
-		const serialized = serializeSessionsJson(data);
-		if (commitSessionsJsonWrite(storePath, data, serialized)) await writeTextAtomic(storePath, serialized);
-		return result;
-	} finally {
-		await release();
-	}
-}
-//#endregion
-export { getSessionsJsonWriteStats, invalidateSessionsJsonCache, readSessionsJsonFile, resetSessionsJsonCacheForTest, withSessionsJsonLock };
-
-//# sourceMappingURL=sessions-json-file.js.map

package/dist/src/session/parity/sessions-json-file.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sessions-json-file.js","names":[],"sources":["../../../../src/session/parity/sessions-json-file.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport { existsSync } from 'node:fs';\n\nimport lockfile from 'proper-lockfile';\n\nimport { writeTextAtomic } from '../../infra/write-file-atomic.js';\nimport {\n  commitSessionsJsonWrite,\n  noteSessionsJsonWritten,\n  readSessionsJsonCached,\n} from './sessions-json-cache.js';\nimport { readSessionsJsonFileRaw } from './sessions-json-file-read.js';\n\nexport type SessionsJsonMap<T> = Record<string, T>;\n\nasync function ensureDirForFile(filePath: string): Promise<void> {\n  await mkdir(dirname(filePath), { recursive: true });\n}\n\nfunction serializeSessionsJson(store: Record<string, unknown>): string {\n  return `${JSON.stringify(store, null, 2)}\\n`;\n}\n\n/**\n * Read JSON object from `sessions.json`. Missing file → `{}`.\n * Uses mtime/size cache when enabled.\n */\nexport async function readSessionsJsonFile<T extends Record<string, unknown>>(\n  storePath: string,\n): Promise<SessionsJsonMap<T>> {\n  if (!existsSync(storePath)) {\n    return {};\n  }\n  const { store } = await readSessionsJsonCached(storePath);\n  return store as SessionsJsonMap<T>;\n}\n\n/**\n * Exclusive update: lock → read → mutate → atomic write (skipped when serialized unchanged) → unlock.\n */\nexport async function withSessionsJsonLock<T>(\n  storePath: string,\n  fn: (store: SessionsJsonMap<Record<string, unknown>>) => Promise<T>,\n): Promise<T> {\n  await ensureDirForFile(storePath);\n  if (!existsSync(storePath)) {\n    await writeTextAtomic(storePath, '{}\\n');\n    noteSessionsJsonWritten(storePath, '{}\\n', {});\n  }\n  const release = await lockfile.lock(storePath, {\n    retries: {\n      retries: 30,\n      minTimeout: 50,\n      maxTimeout: 500,\n    },\n  });\n  try {\n    const data = existsSync(storePath)\n      ? await readSessionsJsonFileRaw<Record<string, unknown>>(storePath)\n      : {};\n    const result = await fn(data);\n    const serialized = serializeSessionsJson(data);\n    if (commitSessionsJsonWrite(storePath, data, serialized)) {\n      await writeTextAtomic(storePath, serialized);\n    }\n    return result;\n  } finally {\n    await release();\n  }\n}\n\nexport { invalidateSessionsJsonCache, getSessionsJsonWriteStats, resetSessionsJsonCacheForTest } from './sessions-json-cache.js';\n"],"mappings":";;;;;;;;wBAMmE;AAUnE,eAAe,iBAAiB,UAAiC;AAC/D,OAAM,MAAM,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;;AAGrD,SAAS,sBAAsB,OAAwC;AACrE,QAAO,GAAG,KAAK,UAAU,OAAO,MAAM,EAAE,CAAC;;;;;;AAO3C,eAAsB,qBACpB,WAC6B;AAC7B,KAAI,CAAC,WAAW,UAAU,CACxB,QAAO,EAAE;CAEX,MAAM,EAAE,UAAU,MAAM,uBAAuB,UAAU;AACzD,QAAO;;;;;AAMT,eAAsB,qBACpB,WACA,IACY;AACZ,OAAM,iBAAiB,UAAU;AACjC,KAAI,CAAC,WAAW,UAAU,EAAE;AAC1B,QAAM,gBAAgB,WAAW,OAAO;AACxC,0BAAwB,WAAW,QAAQ,EAAE,CAAC;;CAEhD,MAAM,UAAU,MAAM,SAAS,KAAK,WAAW,EAC7C,SAAS;EACP,SAAS;EACT,YAAY;EACZ,YAAY;EACb,EACF,CAAC;AACF,KAAI;EACF,MAAM,OAAO,WAAW,UAAU,GAC9B,MAAM,wBAAiD,UAAU,GACjE,EAAE;EACN,MAAM,SAAS,MAAM,GAAG,KAAK;EAC7B,MAAM,aAAa,sBAAsB,KAAK;AAC9C,MAAI,wBAAwB,WAAW,MAAM,WAAW,CACtD,OAAM,gBAAgB,WAAW,WAAW;AAE9C,SAAO;WACC;AACR,QAAM,SAAS"}

package/dist/src/session/parity/sessions-json-patch.d.ts

@@ -1,14 +0,0 @@
-import type { XopcSessionDiskEntry } from './xopc-session-disk-entry.js';
-export type SessionsJsonStatsPatch = {
-    messageCount: number;
-    estimatedTokens: number;
-    lastTurnAt: number;
-};
-export declare function buildSessionsJsonStatsPatch(messageCount: number, estimatedTokens: number): SessionsJsonStatsPatch;
-/** Apply stats + timestamps to a single sessions.json entry (in-memory patch). */
-export declare function patchSessionsJsonEntryStats(entry: XopcSessionDiskEntry, stats: SessionsJsonStatsPatch): void;
-export declare function isAppendOnlyLlmTranscriptMessage(message: unknown): boolean;
-/** Increment stats for a single appended LLM row (hot path). */
-export declare function incrementSessionsJsonStatsForAppend(entry: XopcSessionDiskEntry, opts?: {
-    tokenDelta?: number;
-}): void;

package/dist/src/session/parity/sessions-json-patch.js

@@ -1,40 +0,0 @@
-//#region src/session/parity/sessions-json-patch.ts
-function buildSessionsJsonStatsPatch(messageCount, estimatedTokens) {
-	return {
-		messageCount,
-		estimatedTokens,
-		lastTurnAt: Date.now()
-	};
-}
-/** Apply stats + timestamps to a single sessions.json entry (in-memory patch). */
-function patchSessionsJsonEntryStats(entry, stats) {
-	if (!entry.pluginExtensions?.xopc?.metadata) return;
-	const meta = entry.pluginExtensions.xopc.metadata;
-	meta.messageCount = stats.messageCount;
-	meta.estimatedTokens = stats.estimatedTokens;
-	meta.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-	meta.lastAccessedAt = meta.updatedAt;
-	meta.stats = {
-		messageCount: stats.messageCount,
-		tokenCount: stats.estimatedTokens,
-		lastTurnAt: stats.lastTurnAt
-	};
-	entry.updatedAt = stats.lastTurnAt;
-}
-function isAppendOnlyLlmTranscriptMessage(message) {
-	if (!message || typeof message !== "object") return false;
-	const role = message.role;
-	return role === "user" || role === "assistant" || role === "tool" || role === "toolResult";
-}
-/** Increment stats for a single appended LLM row (hot path). */
-function incrementSessionsJsonStatsForAppend(entry, opts) {
-	if (!entry.pluginExtensions?.xopc?.metadata) return;
-	const meta = entry.pluginExtensions.xopc.metadata;
-	const nextCount = (meta.messageCount ?? 0) + 1;
-	const tokenDelta = opts?.tokenDelta ?? 0;
-	patchSessionsJsonEntryStats(entry, buildSessionsJsonStatsPatch(nextCount, (meta.estimatedTokens ?? 0) + tokenDelta));
-}
-//#endregion
-export { buildSessionsJsonStatsPatch, incrementSessionsJsonStatsForAppend, isAppendOnlyLlmTranscriptMessage, patchSessionsJsonEntryStats };
-
-//# sourceMappingURL=sessions-json-patch.js.map

package/dist/src/session/parity/sessions-json-patch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sessions-json-patch.js","names":[],"sources":["../../../../src/session/parity/sessions-json-patch.ts"],"sourcesContent":["import type { XopcSessionDiskEntry } from './xopc-session-disk-entry.js';\n\nexport type SessionsJsonStatsPatch = {\n  messageCount: number;\n  estimatedTokens: number;\n  lastTurnAt: number;\n};\n\nexport function buildSessionsJsonStatsPatch(\n  messageCount: number,\n  estimatedTokens: number,\n): SessionsJsonStatsPatch {\n  const now = Date.now();\n  return {\n    messageCount,\n    estimatedTokens,\n    lastTurnAt: now,\n  };\n}\n\n/** Apply stats + timestamps to a single sessions.json entry (in-memory patch). */\nexport function patchSessionsJsonEntryStats(\n  entry: XopcSessionDiskEntry,\n  stats: SessionsJsonStatsPatch,\n): void {\n  if (!entry.pluginExtensions?.xopc?.metadata) {\n    return;\n  }\n  const meta = entry.pluginExtensions.xopc.metadata;\n  meta.messageCount = stats.messageCount;\n  meta.estimatedTokens = stats.estimatedTokens;\n  meta.updatedAt = new Date().toISOString();\n  meta.lastAccessedAt = meta.updatedAt;\n  meta.stats = {\n    messageCount: stats.messageCount,\n    tokenCount: stats.estimatedTokens,\n    lastTurnAt: stats.lastTurnAt,\n  };\n  entry.updatedAt = stats.lastTurnAt;\n}\n\nexport function isAppendOnlyLlmTranscriptMessage(message: unknown): boolean {\n  if (!message || typeof message !== 'object') {\n    return false;\n  }\n  const role = (message as { role?: string }).role;\n  return role === 'user' || role === 'assistant' || role === 'tool' || role === 'toolResult';\n}\n\n/** Increment stats for a single appended LLM row (hot path). */\nexport function incrementSessionsJsonStatsForAppend(\n  entry: XopcSessionDiskEntry,\n  opts?: { tokenDelta?: number },\n): void {\n  if (!entry.pluginExtensions?.xopc?.metadata) {\n    return;\n  }\n  const meta = entry.pluginExtensions.xopc.metadata;\n  const nextCount = (meta.messageCount ?? 0) + 1;\n  const tokenDelta = opts?.tokenDelta ?? 0;\n  const nextTokens = (meta.estimatedTokens ?? 0) + tokenDelta;\n  patchSessionsJsonEntryStats(entry, buildSessionsJsonStatsPatch(nextCount, nextTokens));\n}\n"],"mappings":";AAQA,SAAgB,4BACd,cACA,iBACwB;AAExB,QAAO;EACL;EACA;EACA,YAJU,KAAK,KAIA;EAChB;;;AAIH,SAAgB,4BACd,OACA,OACM;AACN,KAAI,CAAC,MAAM,kBAAkB,MAAM,SACjC;CAEF,MAAM,OAAO,MAAM,iBAAiB,KAAK;AACzC,MAAK,eAAe,MAAM;AAC1B,MAAK,kBAAkB,MAAM;AAC7B,MAAK,6BAAY,IAAI,MAAM,EAAC,aAAa;AACzC,MAAK,iBAAiB,KAAK;AAC3B,MAAK,QAAQ;EACX,cAAc,MAAM;EACpB,YAAY,MAAM;EAClB,YAAY,MAAM;EACnB;AACD,OAAM,YAAY,MAAM;;AAG1B,SAAgB,iCAAiC,SAA2B;AAC1E,KAAI,CAAC,WAAW,OAAO,YAAY,SACjC,QAAO;CAET,MAAM,OAAQ,QAA8B;AAC5C,QAAO,SAAS,UAAU,SAAS,eAAe,SAAS,UAAU,SAAS;;;AAIhF,SAAgB,oCACd,OACA,MACM;AACN,KAAI,CAAC,MAAM,kBAAkB,MAAM,SACjC;CAEF,MAAM,OAAO,MAAM,iBAAiB,KAAK;CACzC,MAAM,aAAa,KAAK,gBAAgB,KAAK;CAC7C,MAAM,aAAa,MAAM,cAAc;AAEvC,6BAA4B,OAAO,4BAA4B,YAD3C,KAAK,mBAAmB,KAAK,WACoC,CAAC"}

package/dist/src/session/parity/transcript-file-lock.d.ts

@@ -1,22 +0,0 @@
-/**
- * Cross-process (and re-entrant same-process) advisory lock for session transcript JSONL.
- * Aligns with the goal of safe concurrent gateway/CLI access; same idea as OpenClaw's
- * session write lock, but scoped to a single transcript path with a smaller surface area.
- */
-export type TranscriptFileLock = {
-    release: () => Promise<void>;
-};
-/**
- * Acquire an exclusive lock for mutations to `transcriptAbsPath`.
- * Re-entrant on the same path in the same process (nested `withTranscriptFileLock`).
- */
-export declare function acquireTranscriptFileLock(transcriptAbsPath: string, opts?: {
-    timeoutMs?: number;
-    staleMs?: number;
-}): Promise<TranscriptFileLock>;
-export declare function withTranscriptFileLock<T>(transcriptAbsPath: string, fn: () => Promise<T>, opts?: {
-    timeoutMs?: number;
-    staleMs?: number;
-}): Promise<T>;
-/** Best-effort: remove a stale lock without acquiring (e.g. doctor tooling). */
-export declare function tryRemoveStaleTranscriptLock(transcriptAbsPath: string, staleMs?: number): Promise<boolean>;

package/dist/src/session/parity/transcript-file-lock.js

@@ -1,142 +0,0 @@
-import path from "node:path";
-import { existsSync } from "node:fs";
-import { createHash } from "node:crypto";
-import { mkdir, open, readFile, rm, stat } from "node:fs/promises";
-//#region src/session/parity/transcript-file-lock.ts
-/**
-* Cross-process (and re-entrant same-process) advisory lock for session transcript JSONL.
-* Aligns with the goal of safe concurrent gateway/CLI access; same idea as OpenClaw's
-* session write lock, but scoped to a single transcript path with a smaller surface area.
-*/
-const DEFAULT_TIMEOUT_MS = 6e4;
-const DEFAULT_STALE_MS = 1800 * 1e3;
-const heldLocks = /* @__PURE__ */ new Map();
-/** Same-process serialization for acquire; cross-process exclusion uses the lock file. */
-const acquireChains = /* @__PURE__ */ new Map();
-function chainPerTranscript(normalized, fn) {
-	const run = (acquireChains.get(normalized) ?? Promise.resolve()).then(() => fn());
-	acquireChains.set(normalized, run.then(() => void 0).catch(() => void 0));
-	return run;
-}
-function normalizeTranscriptPath(transcriptAbsPath) {
-	return path.resolve(transcriptAbsPath);
-}
-function lockPathFor(transcriptAbsPath) {
-	const dir = path.dirname(transcriptAbsPath);
-	const base = path.basename(transcriptAbsPath);
-	const hash = createHash("sha256").update(transcriptAbsPath).digest("hex").slice(0, 16);
-	return path.join(dir, `.${base}.${hash}.xopc-transcript.lock`);
-}
-function isPidAlive(pid) {
-	if (!Number.isFinite(pid) || pid <= 0) return false;
-	try {
-		process.kill(pid, 0);
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function readPayload(lockFile) {
-	try {
-		const raw = await readFile(lockFile, "utf8");
-		return JSON.parse(raw);
-	} catch {
-		return null;
-	}
-}
-async function isStaleLock(lockFile, staleMs) {
-	let st;
-	try {
-		st = await stat(lockFile);
-	} catch {
-		return true;
-	}
-	if (Date.now() - st.mtimeMs > staleMs) return true;
-	const payload = await readPayload(lockFile);
-	const pid = typeof payload?.pid === "number" ? payload.pid : void 0;
-	if (pid != null && pid !== process.pid && !isPidAlive(pid)) return true;
-	return false;
-}
-async function releaseHeldLock(normalized, held) {
-	held.refcount -= 1;
-	if (held.refcount > 0) return;
-	heldLocks.delete(normalized);
-	try {
-		await held.handle.close();
-	} catch {}
-	try {
-		await rm(held.lockFile, { force: true });
-	} catch {}
-}
-/**
-* Acquire an exclusive lock for mutations to `transcriptAbsPath`.
-* Re-entrant on the same path in the same process (nested `withTranscriptFileLock`).
-*/
-async function acquireTranscriptFileLock(transcriptAbsPath, opts) {
-	const normalized = normalizeTranscriptPath(transcriptAbsPath);
-	return chainPerTranscript(normalized, () => acquireTranscriptFileLockBody(normalized, opts));
-}
-async function acquireTranscriptFileLockBody(normalized, opts) {
-	const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-	const staleMs = opts?.staleMs ?? DEFAULT_STALE_MS;
-	const existing = heldLocks.get(normalized);
-	if (existing) {
-		existing.refcount += 1;
-		return { release: async () => {
-			await releaseHeldLock(normalized, existing);
-		} };
-	}
-	const lockFile = lockPathFor(normalized);
-	await mkdir(path.dirname(lockFile), { recursive: true });
-	const started = Date.now();
-	let handle = null;
-	while (Date.now() - started < timeoutMs) try {
-		handle = await open(lockFile, "wx", 384);
-		break;
-	} catch (err) {
-		if (err.code === "EEXIST") {
-			if (await isStaleLock(lockFile, staleMs)) {
-				await rm(lockFile, { force: true });
-				continue;
-			}
-			await new Promise((r) => setTimeout(r, 50 + Math.floor(Math.random() * 40)));
-			continue;
-		}
-		throw err;
-	}
-	if (!handle) throw new Error(`timeout acquiring transcript lock: ${lockFile}`);
-	const payload = {
-		pid: process.pid,
-		createdAt: (/* @__PURE__ */ new Date()).toISOString()
-	};
-	await handle.writeFile(JSON.stringify(payload, null, 2), "utf8");
-	const held = {
-		refcount: 1,
-		handle,
-		lockFile
-	};
-	heldLocks.set(normalized, held);
-	return { release: async () => {
-		await releaseHeldLock(normalized, held);
-	} };
-}
-async function withTranscriptFileLock(transcriptAbsPath, fn, opts) {
-	const lock = await acquireTranscriptFileLock(transcriptAbsPath, opts);
-	try {
-		return await fn();
-	} finally {
-		await lock.release();
-	}
-}
-/** Best-effort: remove a stale lock without acquiring (e.g. doctor tooling). */
-async function tryRemoveStaleTranscriptLock(transcriptAbsPath, staleMs = DEFAULT_STALE_MS) {
-	const lockFile = lockPathFor(normalizeTranscriptPath(transcriptAbsPath));
-	if (!existsSync(lockFile)) return false;
-	if (!await isStaleLock(lockFile, staleMs)) return false;
-	await rm(lockFile, { force: true });
-	return true;
-}
-//#endregion
-export { acquireTranscriptFileLock, tryRemoveStaleTranscriptLock, withTranscriptFileLock };
-
-//# sourceMappingURL=transcript-file-lock.js.map

package/dist/src/session/parity/transcript-file-lock.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transcript-file-lock.js","names":[],"sources":["../../../../src/session/parity/transcript-file-lock.ts"],"sourcesContent":["/**\n * Cross-process (and re-entrant same-process) advisory lock for session transcript JSONL.\n * Aligns with the goal of safe concurrent gateway/CLI access; same idea as OpenClaw's\n * session write lock, but scoped to a single transcript path with a smaller surface area.\n */\n\nimport { createHash } from 'node:crypto';\nimport type { FileHandle } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport { mkdir, open, readFile, rm, stat } from 'node:fs/promises';\nimport path from 'node:path';\n\nconst DEFAULT_TIMEOUT_MS = 60_000;\nconst DEFAULT_STALE_MS = 30 * 60 * 1000;\n\ntype LockPayload = { pid?: number; createdAt?: string };\n\ntype HeldTranscriptLock = {\n  refcount: number;\n  handle: FileHandle;\n  lockFile: string;\n};\n\nconst heldLocks = new Map<string, HeldTranscriptLock>();\n\n/** Same-process serialization for acquire; cross-process exclusion uses the lock file. */\nconst acquireChains = new Map<string, Promise<void>>();\n\nfunction chainPerTranscript<T>(normalized: string, fn: () => Promise<T>): Promise<T> {\n  const prev = acquireChains.get(normalized) ?? Promise.resolve();\n  const run = prev.then(() => fn());\n  acquireChains.set(\n    normalized,\n    run.then(() => undefined).catch(() => undefined),\n  );\n  return run;\n}\n\nfunction normalizeTranscriptPath(transcriptAbsPath: string): string {\n  return path.resolve(transcriptAbsPath);\n}\n\nfunction lockPathFor(transcriptAbsPath: string): string {\n  const dir = path.dirname(transcriptAbsPath);\n  const base = path.basename(transcriptAbsPath);\n  const hash = createHash('sha256').update(transcriptAbsPath).digest('hex').slice(0, 16);\n  return path.join(dir, `.${base}.${hash}.xopc-transcript.lock`);\n}\n\nfunction isPidAlive(pid: number): boolean {\n  if (!Number.isFinite(pid) || pid <= 0) {\n    return false;\n  }\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function readPayload(lockFile: string): Promise<LockPayload | null> {\n  try {\n    const raw = await readFile(lockFile, 'utf8');\n    return JSON.parse(raw) as LockPayload;\n  } catch {\n    return null;\n  }\n}\n\nasync function isStaleLock(lockFile: string, staleMs: number): Promise<boolean> {\n  let st;\n  try {\n    st = await stat(lockFile);\n  } catch {\n    return true;\n  }\n  const age = Date.now() - st.mtimeMs;\n  if (age > staleMs) {\n    return true;\n  }\n  const payload = await readPayload(lockFile);\n  const pid = typeof payload?.pid === 'number' ? payload.pid : undefined;\n  if (pid != null && pid !== process.pid && !isPidAlive(pid)) {\n    return true;\n  }\n  return false;\n}\n\nasync function releaseHeldLock(normalized: string, held: HeldTranscriptLock): Promise<void> {\n  held.refcount -= 1;\n  if (held.refcount > 0) {\n    return;\n  }\n  heldLocks.delete(normalized);\n  try {\n    await held.handle.close();\n  } catch {\n    /* ignore */\n  }\n  try {\n    await rm(held.lockFile, { force: true });\n  } catch {\n    /* ignore */\n  }\n}\n\nexport type TranscriptFileLock = { release: () => Promise<void> };\n\n/**\n * Acquire an exclusive lock for mutations to `transcriptAbsPath`.\n * Re-entrant on the same path in the same process (nested `withTranscriptFileLock`).\n */\nexport async function acquireTranscriptFileLock(\n  transcriptAbsPath: string,\n  opts?: { timeoutMs?: number; staleMs?: number },\n): Promise<TranscriptFileLock> {\n  const normalized = normalizeTranscriptPath(transcriptAbsPath);\n  return chainPerTranscript(normalized, () => acquireTranscriptFileLockBody(normalized, opts));\n}\n\nasync function acquireTranscriptFileLockBody(\n  normalized: string,\n  opts?: { timeoutMs?: number; staleMs?: number },\n): Promise<TranscriptFileLock> {\n  const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const staleMs = opts?.staleMs ?? DEFAULT_STALE_MS;\n\n  const existing = heldLocks.get(normalized);\n  if (existing) {\n    existing.refcount += 1;\n    return {\n      release: async () => {\n        await releaseHeldLock(normalized, existing);\n      },\n    };\n  }\n\n  const lockFile = lockPathFor(normalized);\n  await mkdir(path.dirname(lockFile), { recursive: true });\n\n  const started = Date.now();\n  let handle: FileHandle | null = null;\n\n  while (Date.now() - started < timeoutMs) {\n    try {\n      handle = await open(lockFile, 'wx', 0o600);\n      break;\n    } catch (err) {\n      const code = (err as NodeJS.ErrnoException).code;\n      if (code === 'EEXIST') {\n        if (await isStaleLock(lockFile, staleMs)) {\n          await rm(lockFile, { force: true });\n          continue;\n        }\n        await new Promise((r) => setTimeout(r, 50 + Math.floor(Math.random() * 40)));\n        continue;\n      }\n      throw err;\n    }\n  }\n\n  if (!handle) {\n    throw new Error(`timeout acquiring transcript lock: ${lockFile}`);\n  }\n\n  const payload: LockPayload = { pid: process.pid, createdAt: new Date().toISOString() };\n  await handle.writeFile(JSON.stringify(payload, null, 2), 'utf8');\n\n  const held: HeldTranscriptLock = { refcount: 1, handle, lockFile };\n  heldLocks.set(normalized, held);\n\n  return {\n    release: async () => {\n      await releaseHeldLock(normalized, held);\n    },\n  };\n}\n\nexport async function withTranscriptFileLock<T>(\n  transcriptAbsPath: string,\n  fn: () => Promise<T>,\n  opts?: { timeoutMs?: number; staleMs?: number },\n): Promise<T> {\n  const lock = await acquireTranscriptFileLock(transcriptAbsPath, opts);\n  try {\n    return await fn();\n  } finally {\n    await lock.release();\n  }\n}\n\n/** Best-effort: remove a stale lock without acquiring (e.g. doctor tooling). */\nexport async function tryRemoveStaleTranscriptLock(\n  transcriptAbsPath: string,\n  staleMs: number = DEFAULT_STALE_MS,\n): Promise<boolean> {\n  const lockFile = lockPathFor(normalizeTranscriptPath(transcriptAbsPath));\n  if (!existsSync(lockFile)) {\n    return false;\n  }\n  if (!(await isStaleLock(lockFile, staleMs))) {\n    return false;\n  }\n  await rm(lockFile, { force: true });\n  return true;\n}\n"],"mappings":"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"}

package/dist/src/session/parity/transcript-pagination.d.ts

@@ -1,29 +0,0 @@
-import type { AgentMessage } from '@earendil-works/pi-agent-core';
-import type { TranscriptStoredRow } from '../session-context-for-llm.js';
-export type TranscriptPageOptions = {
-    limit: number;
-    /** Exclusive end index into display message rows (default: total). */
-    beforeIndex?: number;
-    /** Tail offset (used when `beforeIndex` is omitted). */
-    offset?: number;
-};
-export type TranscriptPageResult = {
-    rows: TranscriptStoredRow[];
-    total: number;
-    startIndex: number;
-    endIndex: number;
-};
-/**
- * Count persisted pi `type: message` rows (excludes context custom rows).
- */
-export declare function countTranscriptMessageRows(absPath: string): Promise<number>;
-/**
- * Read a page of display messages from transcript tail (newest page when cursors omitted).
- */
-export declare function readDisplayMessagePageFromTranscriptFile(absPath: string, options: TranscriptPageOptions): Promise<TranscriptPageResult & {
-    messages: AgentMessage[];
-}>;
-/**
- * Read a page of transcript rows from the tail (newest page when `beforeIndex` omitted).
- */
-export declare function readTranscriptRowsPageFromFile(absPath: string, options: TranscriptPageOptions): Promise<TranscriptPageResult>;

package/dist/src/session/parity/transcript-pagination.js

@@ -1,132 +0,0 @@
-import "./jsonl-transcript-io.js";
-import { existsSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-//#region src/session/parity/transcript-pagination.ts
-function classifyLine(line) {
-	const trimmed = line.trim();
-	if (!trimmed) return "other";
-	if (trimmed.includes("\"type\":\"session\"") || trimmed.includes("\"type\": \"session\"")) return "session";
-	if (trimmed.includes("\"type\":\"message\"") || trimmed.includes("\"type\": \"message\"")) return "message";
-	if (trimmed.includes(`"xopc:transcript-row"`) || trimmed.includes("\"type\":\"custom\"")) return "context";
-	return "other";
-}
-function parseStoredRow(line, kind) {
-	try {
-		const parsed = JSON.parse(line);
-		if (kind === "message" && parsed.message) return parsed.message;
-		if (kind === "context" && parsed.type === "custom") {
-			const data = parsed.data;
-			if (!data || data.kind !== "context") return null;
-			return {
-				kind: "context",
-				id: typeof data.id === "string" ? data.id : void 0,
-				text: typeof data.text === "string" ? data.text : void 0,
-				data: data.data,
-				createdAt: typeof data.createdAt === "string" ? data.createdAt : void 0
-			};
-		}
-	} catch {
-		return null;
-	}
-	return null;
-}
-/**
-* Count persisted pi `type: message` rows (excludes context custom rows).
-*/
-async function countTranscriptMessageRows(absPath) {
-	if (!existsSync(absPath)) return 0;
-	const content = await readFile(absPath, "utf8");
-	let count = 0;
-	for (const line of content.split("\n")) if (classifyLine(line) === "message") count += 1;
-	return count;
-}
-function isCompactionSummaryLine(line) {
-	return line.includes("[Previous conversation summary]");
-}
-/**
-* Read a page of display messages from transcript tail (newest page when cursors omitted).
-*/
-async function readDisplayMessagePageFromTranscriptFile(absPath, options) {
-	if (!existsSync(absPath)) return {
-		rows: [],
-		messages: [],
-		total: 0,
-		startIndex: 0,
-		endIndex: 0
-	};
-	const limit = Math.max(1, Math.trunc(options.limit));
-	const content = await readFile(absPath, "utf8");
-	const displayLines = [];
-	for (const line of content.split("\n")) {
-		const kind = classifyLine(line);
-		if (kind !== "message") continue;
-		if (isCompactionSummaryLine(line)) continue;
-		displayLines.push({
-			line,
-			kind
-		});
-	}
-	const total = displayLines.length;
-	const offset = Math.max(0, Math.trunc(options.offset ?? 0));
-	const endExclusive = options.beforeIndex !== void 0 ? Math.min(total, Math.max(0, Math.trunc(options.beforeIndex))) : Math.max(0, total - offset);
-	const startInclusive = Math.max(0, endExclusive - limit);
-	const slice = displayLines.slice(startInclusive, endExclusive);
-	const rows = [];
-	const messages = [];
-	for (const item of slice) {
-		const row = parseStoredRow(item.line, item.kind);
-		if (row && typeof row.role === "string") {
-			rows.push(row);
-			messages.push(row);
-		}
-	}
-	return {
-		rows,
-		messages,
-		total,
-		startIndex: startInclusive,
-		endIndex: endExclusive
-	};
-}
-/**
-* Read a page of transcript rows from the tail (newest page when `beforeIndex` omitted).
-*/
-async function readTranscriptRowsPageFromFile(absPath, options) {
-	if (!existsSync(absPath)) return {
-		rows: [],
-		total: 0,
-		startIndex: 0,
-		endIndex: 0
-	};
-	const limit = Math.max(1, Math.trunc(options.limit));
-	const content = await readFile(absPath, "utf8");
-	const parsedLines = [];
-	for (const line of content.split("\n")) {
-		const kind = classifyLine(line);
-		if (kind === "session" || kind === "other") continue;
-		parsedLines.push({
-			line,
-			kind
-		});
-	}
-	const total = parsedLines.length;
-	const offset = Math.max(0, Math.trunc(options.offset ?? 0));
-	const endExclusive = options.beforeIndex !== void 0 ? Math.min(total, Math.max(0, Math.trunc(options.beforeIndex))) : Math.max(0, total - offset);
-	const startInclusive = Math.max(0, endExclusive - limit);
-	const slice = parsedLines.slice(startInclusive, endExclusive);
-	const rows = [];
-	for (const item of slice) {
-		const row = parseStoredRow(item.line, item.kind);
-		if (row) rows.push(row);
-	}
-	return {
-		rows,
-		total,
-		startIndex: startInclusive,
-		endIndex: endExclusive
-	};
-}
-//#endregion
-export { countTranscriptMessageRows, readDisplayMessagePageFromTranscriptFile, readTranscriptRowsPageFromFile };
-
-//# sourceMappingURL=transcript-pagination.js.map

package/dist/src/session/parity/transcript-pagination.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transcript-pagination.js","names":[],"sources":["../../../../src/session/parity/transcript-pagination.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { TranscriptStoredRow, XopcTranscriptContextEntry } from '../session-context-for-llm.js';\nimport { XOPC_CONTEXT_CUSTOM_TYPE } from './jsonl-transcript-io.js';\n\nexport type TranscriptPageOptions = {\n  limit: number;\n  /** Exclusive end index into display message rows (default: total). */\n  beforeIndex?: number;\n  /** Tail offset (used when `beforeIndex` is omitted). */\n  offset?: number;\n};\n\nexport type TranscriptPageResult = {\n  rows: TranscriptStoredRow[];\n  total: number;\n  startIndex: number;\n  endIndex: number;\n};\n\ntype ParsedLine = {\n  line: string;\n  kind: 'session' | 'message' | 'context' | 'other';\n};\n\nfunction classifyLine(line: string): ParsedLine['kind'] {\n  const trimmed = line.trim();\n  if (!trimmed) {\n    return 'other';\n  }\n  if (trimmed.includes('\"type\":\"session\"') || trimmed.includes('\"type\": \"session\"')) {\n    return 'session';\n  }\n  if (trimmed.includes('\"type\":\"message\"') || trimmed.includes('\"type\": \"message\"')) {\n    return 'message';\n  }\n  if (trimmed.includes(`\"${XOPC_CONTEXT_CUSTOM_TYPE}\"`) || trimmed.includes('\"type\":\"custom\"')) {\n    return 'context';\n  }\n  return 'other';\n}\n\nfunction parseStoredRow(line: string, kind: ParsedLine['kind']): TranscriptStoredRow | null {\n  try {\n    const parsed = JSON.parse(line) as Record<string, unknown>;\n    if (kind === 'message' && parsed.message) {\n      return parsed.message as AgentMessage;\n    }\n    if (kind === 'context' && parsed.type === 'custom') {\n      const data = parsed.data as Record<string, unknown> | undefined;\n      if (!data || data.kind !== 'context') {\n        return null;\n      }\n      return {\n        kind: 'context',\n        id: typeof data.id === 'string' ? data.id : undefined,\n        text: typeof data.text === 'string' ? data.text : undefined,\n        data: data.data as Record<string, unknown> | undefined,\n        createdAt: typeof data.createdAt === 'string' ? data.createdAt : undefined,\n      } satisfies XopcTranscriptContextEntry;\n    }\n  } catch {\n    return null;\n  }\n  return null;\n}\n\n/**\n * Count persisted pi `type: message` rows (excludes context custom rows).\n */\nexport async function countTranscriptMessageRows(absPath: string): Promise<number> {\n  if (!existsSync(absPath)) {\n    return 0;\n  }\n  const content = await readFile(absPath, 'utf8');\n  let count = 0;\n  for (const line of content.split('\\n')) {\n    const kind = classifyLine(line);\n    if (kind === 'message') {\n      count += 1;\n    }\n  }\n  return count;\n}\n\nfunction isCompactionSummaryLine(line: string): boolean {\n  return line.includes('[Previous conversation summary]');\n}\n\n/**\n * Read a page of display messages from transcript tail (newest page when cursors omitted).\n */\nexport async function readDisplayMessagePageFromTranscriptFile(\n  absPath: string,\n  options: TranscriptPageOptions,\n): Promise<TranscriptPageResult & { messages: AgentMessage[] }> {\n  if (!existsSync(absPath)) {\n    return { rows: [], messages: [], total: 0, startIndex: 0, endIndex: 0 };\n  }\n\n  const limit = Math.max(1, Math.trunc(options.limit));\n  const content = await readFile(absPath, 'utf8');\n  const displayLines: ParsedLine[] = [];\n  for (const line of content.split('\\n')) {\n    const kind = classifyLine(line);\n    if (kind !== 'message') {\n      continue;\n    }\n    if (isCompactionSummaryLine(line)) {\n      continue;\n    }\n    displayLines.push({ line, kind });\n  }\n\n  const total = displayLines.length;\n  const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n  const endExclusive =\n    options.beforeIndex !== undefined\n      ? Math.min(total, Math.max(0, Math.trunc(options.beforeIndex)))\n      : Math.max(0, total - offset);\n  const startInclusive = Math.max(0, endExclusive - limit);\n  const slice = displayLines.slice(startInclusive, endExclusive);\n  const rows: TranscriptStoredRow[] = [];\n  const messages: AgentMessage[] = [];\n  for (const item of slice) {\n    const row = parseStoredRow(item.line, item.kind);\n    if (row && typeof (row as AgentMessage).role === 'string') {\n      rows.push(row);\n      messages.push(row as AgentMessage);\n    }\n  }\n\n  return {\n    rows,\n    messages,\n    total,\n    startIndex: startInclusive,\n    endIndex: endExclusive,\n  };\n}\n\n/**\n * Read a page of transcript rows from the tail (newest page when `beforeIndex` omitted).\n */\nexport async function readTranscriptRowsPageFromFile(\n  absPath: string,\n  options: TranscriptPageOptions,\n): Promise<TranscriptPageResult> {\n  if (!existsSync(absPath)) {\n    return { rows: [], total: 0, startIndex: 0, endIndex: 0 };\n  }\n\n  const limit = Math.max(1, Math.trunc(options.limit));\n  const content = await readFile(absPath, 'utf8');\n  const parsedLines: ParsedLine[] = [];\n  for (const line of content.split('\\n')) {\n    const kind = classifyLine(line);\n    if (kind === 'session' || kind === 'other') {\n      continue;\n    }\n    parsedLines.push({ line, kind });\n  }\n\n  const total = parsedLines.length;\n  const offset = Math.max(0, Math.trunc(options.offset ?? 0));\n  const endExclusive =\n    options.beforeIndex !== undefined\n      ? Math.min(total, Math.max(0, Math.trunc(options.beforeIndex)))\n      : Math.max(0, total - offset);\n  const startInclusive = Math.max(0, endExclusive - limit);\n  const slice = parsedLines.slice(startInclusive, endExclusive);\n  const rows: TranscriptStoredRow[] = [];\n  for (const item of slice) {\n    const row = parseStoredRow(item.line, item.kind);\n    if (row) {\n      rows.push(row);\n    }\n  }\n\n  return {\n    rows,\n    total,\n    startIndex: startInclusive,\n    endIndex: endExclusive,\n  };\n}\n"],"mappings":"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"}