@librechat/agents 3.2.31 → 3.2.33

package/dist/cjs/session/JsonlSessionStore.cjs

@@ -1,425 +1,342 @@
-'use strict';
-
-var os = require('os');
-var crypto = require('crypto');
-var messages = require('@langchain/core/messages');
-var path = require('path');
-var promises = require('fs/promises');
-var messageSerialization = require('./messageSerialization.cjs');
-var ids = require('./ids.cjs');
-
+const require_messageSerialization = require("./messageSerialization.cjs");
+const require_ids = require("./ids.cjs");
+let _langchain_core_messages = require("@langchain/core/messages");
+let path = require("path");
+let os = require("os");
+let crypto = require("crypto");
+let fs_promises = require("fs/promises");
+//#region src/session/JsonlSessionStore.ts
 const SESSION_VERSION = 1;
-const DEFAULT_SESSION_ROOT = path.join(os.homedir(), '.librechat', 'agents', 'sessions');
+const DEFAULT_SESSION_ROOT = (0, path.join)((0, os.homedir)(), ".librechat", "agents", "sessions");
 function sanitizeCwd(cwd) {
-    const normalized = path.resolve(cwd);
-    return crypto.createHash('sha256').update(normalized).digest('hex');
+	const normalized = (0, path.resolve)(cwd);
+	return (0, crypto.createHash)("sha256").update(normalized).digest("hex");
 }
 function createSessionPath(options) {
-    const sessionId = options.sessionId ?? ids.createSessionId();
-    const fileName = `${new Date().toISOString().replace(/[:.]/g, '-')}_${sessionId}.jsonl`;
-    return path.join(DEFAULT_SESSION_ROOT, sanitizeCwd(options.cwd), fileName);
+	const sessionId = options.sessionId ?? require_ids.createSessionId();
+	const fileName = `${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}_${sessionId}.jsonl`;
+	return (0, path.join)(DEFAULT_SESSION_ROOT, sanitizeCwd(options.cwd), fileName);
 }
-async function pathExists(path) {
-    try {
-        await promises.access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
+async function pathExists(path$1) {
+	try {
+		await (0, fs_promises.access)(path$1);
+		return true;
+	} catch {
+		return false;
+	}
 }
 function parseLine(line) {
-    if (line.trim() === '') {
-        return undefined;
-    }
-    try {
-        const parsed = JSON.parse(line);
-        if (parsed.type === 'session') {
-            return parsed;
-        }
-        if ('id' in parsed && 'parentId' in parsed && 'data' in parsed) {
-            return parsed;
-        }
-        return undefined;
-    }
-    catch {
-        return undefined;
-    }
+	if (line.trim() === "") return;
+	try {
+		const parsed = JSON.parse(line);
+		if (parsed.type === "session") return parsed;
+		if ("id" in parsed && "parentId" in parsed && "data" in parsed) return parsed;
+		return;
+	} catch {
+		return;
+	}
 }
 function createHeader(options) {
-    return {
-        type: 'session',
-        version: SESSION_VERSION,
-        id: options.sessionId ?? ids.createSessionId(),
-        timestamp: ids.createTimestamp(),
-        cwd: path.resolve(options.cwd),
-        ...(options.name != null && options.name !== ''
-            ? { name: options.name }
-            : {}),
-        ...(options.parentSession != null && options.parentSession !== ''
-            ? { parentSession: options.parentSession }
-            : {}),
-    };
+	return {
+		type: "session",
+		version: SESSION_VERSION,
+		id: options.sessionId ?? require_ids.createSessionId(),
+		timestamp: require_ids.createTimestamp(),
+		cwd: (0, path.resolve)(options.cwd),
+		...options.name != null && options.name !== "" ? { name: options.name } : {},
+		...options.parentSession != null && options.parentSession !== "" ? { parentSession: options.parentSession } : {}
+	};
 }
 function sortEntries(entries) {
-    return [...entries].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
-}
-class JsonlSessionStore {
-    path;
-    header;
-    entries;
-    constructor(params) {
-        this.path = params.path;
-        this.header = params.header;
-        this.entries = sortEntries(params.entries);
-    }
-    static getDefaultRoot() {
-        return DEFAULT_SESSION_ROOT;
-    }
-    static async create(options) {
-        const sessionId = options.sessionId ?? ids.createSessionId();
-        const path$1 = options.path != null && options.path !== ''
-            ? path.resolve(options.path)
-            : createSessionPath({ ...options, sessionId });
-        const header = createHeader({ ...options, sessionId });
-        await promises.mkdir(path.dirname(path$1), { recursive: true });
-        await promises.writeFile(path$1, `${JSON.stringify(header)}\n`, {
-            encoding: 'utf8',
-            flag: 'wx',
-        });
-        return new JsonlSessionStore({ path: path$1, header, entries: [] });
-    }
-    static async open(pathOrId) {
-        const path = await JsonlSessionStore.resolvePath(pathOrId);
-        return JsonlSessionStore.openPath(path);
-    }
-    static async openPath(path$1) {
-        const resolved = path.resolve(path$1);
-        const raw = await promises.readFile(resolved, 'utf8');
-        const parsed = raw
-            .split('\n')
-            .map((line) => parseLine(line))
-            .filter((line) => line != null);
-        const header = parsed.find((line) => line.type === 'session');
-        if (!header) {
-            throw new Error(`Invalid session file: ${resolved}`);
-        }
-        const entries = parsed.filter((line) => line.type !== 'session');
-        return new JsonlSessionStore({ path: resolved, header, entries });
-    }
-    static async resolvePath(pathOrId) {
-        const candidate = path.isAbsolute(pathOrId) ? pathOrId : path.resolve(pathOrId);
-        if (await pathExists(candidate)) {
-            return candidate;
-        }
-        const sessions = await JsonlSessionStore.listAll();
-        const matches = sessions.filter((item) => item.id.startsWith(pathOrId) || path.basename(item.path).includes(pathOrId));
-        if (matches.length === 1) {
-            return matches[0].path;
-        }
-        if (matches.length > 1) {
-            throw new Error(`Session id "${pathOrId}" is ambiguous`);
-        }
-        throw new Error(`Session not found: ${pathOrId}`);
-    }
-    static async list(cwd) {
-        const dir = path.join(DEFAULT_SESSION_ROOT, sanitizeCwd(cwd));
-        return JsonlSessionStore.listDirectory(dir);
-    }
-    static async listAll(root = DEFAULT_SESSION_ROOT) {
-        if (!(await pathExists(root))) {
-            return [];
-        }
-        const dirs = await promises.readdir(root, { withFileTypes: true });
-        const lists = await Promise.all(dirs
-            .filter((entry) => entry.isDirectory())
-            .map((entry) => JsonlSessionStore.listDirectory(path.join(root, entry.name))));
-        return lists.flat().sort((a, b) => b.timestamp.localeCompare(a.timestamp));
-    }
-    static async listDirectory(dir) {
-        if (!(await pathExists(dir))) {
-            return [];
-        }
-        const files = await promises.readdir(dir, { withFileTypes: true });
-        const candidates = files
-            .filter((entry) => entry.isFile() && entry.name.endsWith('.jsonl'))
-            .map((entry) => path.join(dir, entry.name));
-        const items = await Promise.all(candidates.map(async (path) => {
-            try {
-                const store = await JsonlSessionStore.open(path);
-                return {
-                    id: store.header.id,
-                    path,
-                    cwd: store.header.cwd,
-                    timestamp: store.header.timestamp,
-                    name: store.header.name,
-                    leafId: store.getLeafEntry()?.id ?? null,
-                };
-            }
-            catch {
-                return undefined;
-            }
-        }));
-        return items
-            .filter((item) => item != null)
-            .sort((a, b) => b.timestamp.localeCompare(a.timestamp));
-    }
-    getEntries() {
-        return [...this.entries];
-    }
-    getEntry(id) {
-        return this.entries.find((entry) => entry.id === id);
-    }
-    getChildren(id) {
-        return this.entries.filter((entry) => entry.parentId === id);
-    }
-    getTree() {
-        const byParent = new Map();
-        for (const entry of this.entries) {
-            const siblings = byParent.get(entry.parentId) ?? [];
-            siblings.push(entry);
-            byParent.set(entry.parentId, siblings);
-        }
-        const build = (parentId) => (byParent.get(parentId) ?? []).map((entry) => ({
-            entry,
-            children: build(entry.id),
-        }));
-        return build(null);
-    }
-    getLeafEntry() {
-        const state = [...this.entries]
-            .reverse()
-            .find((entry) => entry.type === 'session_state');
-        if (state) {
-            return state.data.leafId == null
-                ? undefined
-                : this.getEntry(state.data.leafId);
-        }
-        return [...this.entries]
-            .reverse()
-            .find((entry) => entry.type === 'message' || entry.type === 'summary');
-    }
-    getPath(entryId = this.getLeafEntry()?.id) {
-        if (entryId == null || entryId === '') {
-            return [];
-        }
-        const byId = new Map(this.entries.map((entry) => [entry.id, entry]));
-        const path = [];
-        let current = byId.get(entryId);
-        while (current) {
-            path.push(current);
-            current =
-                current.parentId == null ? undefined : byId.get(current.parentId);
-        }
-        return path.reverse();
-    }
-    getMessages(entryId) {
-        const messages$1 = [];
-        for (const entry of this.getPath(entryId)) {
-            if (entry.type === 'message') {
-                messages$1.push(messageSerialization.deserializeMessage(entry.data.message));
-            }
-            else if (entry.type === 'summary') {
-                messages$1.push(new messages.SystemMessage(entry.data.text));
-            }
-        }
-        return messages$1;
-    }
-    getForkPoints() {
-        return this.entries.filter((entry) => entry.type === 'message' && entry.data.role === 'user');
-    }
-    getLabel(entryId) {
-        return [...this.entries]
-            .reverse()
-            .find((entry) => entry.type === 'label' && entry.data.targetEntryId === entryId)?.data.label;
-    }
-    async setLabel(entryId, label) {
-        return this.appendEntry({
-            type: 'label',
-            parentId: this.getLeafEntry()?.id ?? null,
-            data: { targetEntryId: entryId, label },
-        });
-    }
-    async appendMessage(message, parentId = this.getLeafEntry()?.id ?? null) {
-        const entry = await this.appendEntry({
-            type: 'message',
-            parentId,
-            data: {
-                role: messageSerialization.getMessageRole(message),
-                message: messageSerialization.serializeMessage(message),
-            },
-        });
-        await this.setLeaf(entry.id);
-        return entry;
-    }
-    async appendRunEvent(event, payload, params) {
-        return this.appendEntry({
-            type: 'run_event',
-            parentId: this.getLeafEntry()?.id ?? null,
-            data: {
-                event,
-                ...(params?.runId != null && params.runId !== ''
-                    ? { runId: params.runId }
-                    : {}),
-                ...(params?.threadId != null && params.threadId !== ''
-                    ? { threadId: params.threadId }
-                    : {}),
-                ...(typeof payload !== 'undefined'
-                    ? { payload: messageSerialization.toJsonValue(payload) }
-                    : {}),
-            },
-        });
-    }
-    async setLeaf(leafId) {
-        return this.appendEntry({
-            type: 'session_state',
-            parentId: leafId,
-            data: { leafId },
-        });
-    }
-    async appendEntryForCompaction(params) {
-        const tokenCount = typeof params.tokenCount === 'number' &&
-            Number.isFinite(params.tokenCount) &&
-            params.tokenCount >= 0
-            ? params.tokenCount
-            : undefined;
-        const entry = await this.appendEntry({
-            type: 'summary',
-            parentId: 'parentId' in params
-                ? (params.parentId ?? null)
-                : (this.getLeafEntry()?.id ?? null),
-            data: {
-                text: params.text,
-                ...(tokenCount != null ? { tokenCount } : {}),
-                retainedEntryIds: params.retainedEntryIds,
-                summarizedEntryIds: params.summarizedEntryIds,
-                ...(params.instructions != null && params.instructions !== ''
-                    ? { instructions: params.instructions }
-                    : {}),
-            },
-        });
-        await this.setLeaf(entry.id);
-        return entry;
-    }
-    async appendCompactionEntry(params) {
-        return this.appendEntry({
-            type: 'compaction',
-            parentId: this.getLeafEntry()?.id ?? null,
-            data: {
-                summaryEntryId: params.summaryEntryId,
-                retainedEntryIds: params.retainedEntryIds,
-                summarizedEntryIds: params.summarizedEntryIds,
-            },
-        });
-    }
-    async appendCheckpoint(params) {
-        return this.appendEntry({
-            type: 'checkpoint',
-            parentId: this.getLeafEntry()?.id ?? null,
-            data: {
-                provider: 'langgraph',
-                source: params.source,
-                threadId: params.threadId,
-                ...(params.runId != null && params.runId !== ''
-                    ? { runId: params.runId }
-                    : {}),
-                ...(params.checkpointId != null && params.checkpointId !== ''
-                    ? { checkpointId: params.checkpointId }
-                    : {}),
-                ...(params.checkpointNs != null
-                    ? { checkpointNs: params.checkpointNs }
-                    : {}),
-                ...(params.parentCheckpointId != null &&
-                    params.parentCheckpointId !== ''
-                    ? { parentCheckpointId: params.parentCheckpointId }
-                    : {}),
-                ...(params.reason != null && params.reason !== ''
-                    ? { reason: params.reason }
-                    : {}),
-            },
-        });
-    }
-    getCheckpoints(threadId) {
-        return this.entries.filter((entry) => entry.type === 'checkpoint' &&
-            (threadId == null || entry.data.threadId === threadId));
-    }
-    getLatestCheckpoint(threadId) {
-        const checkpoints = this.getCheckpoints(threadId);
-        for (let i = checkpoints.length - 1; i >= 0; i--) {
-            const checkpoint = checkpoints[i];
-            if (checkpoint.data.source === 'reset') {
-                return undefined;
-            }
-            return checkpoint;
-        }
-        return undefined;
-    }
-    async branch(entryId, options = {}) {
-        const target = this.getBranchTarget(entryId, options.position ?? 'at');
-        await this.setLeaf(target?.id ?? null);
-        return target;
-    }
-    async createBranchedSession(entryId = this.getLeafEntry()?.id, options = {}) {
-        const target = entryId != null && entryId !== ''
-            ? this.getBranchTarget(entryId, options.position ?? 'at')
-            : this.getLeafEntry();
-        const newStore = await JsonlSessionStore.create({
-            cwd: options.cwd ?? this.header.cwd,
-            name: options.name ?? this.header.name,
-            parentSession: this.path,
-        });
-        const pathEntries = target ? this.getPath(target.id) : [];
-        for (const entry of pathEntries) {
-            await newStore.appendExistingEntry(entry);
-        }
-        await newStore.setLeaf(target?.id ?? null);
-        return newStore;
-    }
-    async clone(options = {}) {
-        return this.createBranchedSession(this.getLeafEntry()?.id, {
-            ...options,
-            position: 'at',
-        });
-    }
-    async fork(entryId, options = {}) {
-        return this.createBranchedSession(entryId, {
-            ...options,
-            position: options.position ?? 'before',
-        });
-    }
-    getBranchTarget(entryId, position) {
-        const entry = this.getEntry(entryId);
-        if (!entry) {
-            throw new Error(`Entry not found: ${entryId}`);
-        }
-        if (position === 'at') {
-            return entry;
-        }
-        return entry.parentId == null ? undefined : this.getEntry(entry.parentId);
-    }
-    async appendExistingEntry(entry) {
-        this.entries.push(entry);
-        await promises.appendFile(this.path, `${JSON.stringify(entry)}\n`, 'utf8');
-    }
-    async appendEntry(params) {
-        const entry = {
-            type: params.type,
-            id: ids.createEntryId(),
-            parentId: params.parentId,
-            timestamp: ids.createTimestamp(),
-            data: params.data,
-        };
-        this.entries.push(entry);
-        await promises.appendFile(this.path, `${JSON.stringify(entry)}\n`, 'utf8');
-        return entry;
-    }
-    async existsOnDisk() {
-        const fileStat = await promises.stat(this.path).catch(() => undefined);
-        return fileStat?.isFile() === true;
-    }
+	return [...entries].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
 }
+var JsonlSessionStore = class JsonlSessionStore {
+	path;
+	header;
+	entries;
+	constructor(params) {
+		this.path = params.path;
+		this.header = params.header;
+		this.entries = sortEntries(params.entries);
+	}
+	static getDefaultRoot() {
+		return DEFAULT_SESSION_ROOT;
+	}
+	static async create(options) {
+		const sessionId = options.sessionId ?? require_ids.createSessionId();
+		const path$2 = options.path != null && options.path !== "" ? (0, path.resolve)(options.path) : createSessionPath({
+			...options,
+			sessionId
+		});
+		const header = createHeader({
+			...options,
+			sessionId
+		});
+		await (0, fs_promises.mkdir)((0, path.dirname)(path$2), { recursive: true });
+		await (0, fs_promises.writeFile)(path$2, `${JSON.stringify(header)}\n`, {
+			encoding: "utf8",
+			flag: "wx"
+		});
+		return new JsonlSessionStore({
+			path: path$2,
+			header,
+			entries: []
+		});
+	}
+	static async open(pathOrId) {
+		const path$3 = await JsonlSessionStore.resolvePath(pathOrId);
+		return JsonlSessionStore.openPath(path$3);
+	}
+	static async openPath(path$4) {
+		const resolved = (0, path.resolve)(path$4);
+		const parsed = (await (0, fs_promises.readFile)(resolved, "utf8")).split("\n").map((line) => parseLine(line)).filter((line) => line != null);
+		const header = parsed.find((line) => line.type === "session");
+		if (!header) throw new Error(`Invalid session file: ${resolved}`);
+		return new JsonlSessionStore({
+			path: resolved,
+			header,
+			entries: parsed.filter((line) => line.type !== "session")
+		});
+	}
+	static async resolvePath(pathOrId) {
+		const candidate = (0, path.isAbsolute)(pathOrId) ? pathOrId : (0, path.resolve)(pathOrId);
+		if (await pathExists(candidate)) return candidate;
+		const matches = (await JsonlSessionStore.listAll()).filter((item) => item.id.startsWith(pathOrId) || (0, path.basename)(item.path).includes(pathOrId));
+		if (matches.length === 1) return matches[0].path;
+		if (matches.length > 1) throw new Error(`Session id "${pathOrId}" is ambiguous`);
+		throw new Error(`Session not found: ${pathOrId}`);
+	}
+	static async list(cwd) {
+		const dir = (0, path.join)(DEFAULT_SESSION_ROOT, sanitizeCwd(cwd));
+		return JsonlSessionStore.listDirectory(dir);
+	}
+	static async listAll(root = DEFAULT_SESSION_ROOT) {
+		if (!await pathExists(root)) return [];
+		const dirs = await (0, fs_promises.readdir)(root, { withFileTypes: true });
+		return (await Promise.all(dirs.filter((entry) => entry.isDirectory()).map((entry) => JsonlSessionStore.listDirectory((0, path.join)(root, entry.name))))).flat().sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+	}
+	static async listDirectory(dir) {
+		if (!await pathExists(dir)) return [];
+		const candidates = (await (0, fs_promises.readdir)(dir, { withFileTypes: true })).filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl")).map((entry) => (0, path.join)(dir, entry.name));
+		return (await Promise.all(candidates.map(async (path$5) => {
+			try {
+				const store = await JsonlSessionStore.open(path$5);
+				return {
+					id: store.header.id,
+					path: path$5,
+					cwd: store.header.cwd,
+					timestamp: store.header.timestamp,
+					name: store.header.name,
+					leafId: store.getLeafEntry()?.id ?? null
+				};
+			} catch {
+				return;
+			}
+		}))).filter((item) => item != null).sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+	}
+	getEntries() {
+		return [...this.entries];
+	}
+	getEntry(id) {
+		return this.entries.find((entry) => entry.id === id);
+	}
+	getChildren(id) {
+		return this.entries.filter((entry) => entry.parentId === id);
+	}
+	getTree() {
+		const byParent = /* @__PURE__ */ new Map();
+		for (const entry of this.entries) {
+			const siblings = byParent.get(entry.parentId) ?? [];
+			siblings.push(entry);
+			byParent.set(entry.parentId, siblings);
+		}
+		const build = (parentId) => (byParent.get(parentId) ?? []).map((entry) => ({
+			entry,
+			children: build(entry.id)
+		}));
+		return build(null);
+	}
+	getLeafEntry() {
+		const state = [...this.entries].reverse().find((entry) => entry.type === "session_state");
+		if (state) return state.data.leafId == null ? void 0 : this.getEntry(state.data.leafId);
+		return [...this.entries].reverse().find((entry) => entry.type === "message" || entry.type === "summary");
+	}
+	getPath(entryId = this.getLeafEntry()?.id) {
+		if (entryId == null || entryId === "") return [];
+		const byId = new Map(this.entries.map((entry) => [entry.id, entry]));
+		const path$6 = [];
+		let current = byId.get(entryId);
+		while (current) {
+			path$6.push(current);
+			current = current.parentId == null ? void 0 : byId.get(current.parentId);
+		}
+		return path$6.reverse();
+	}
+	getMessages(entryId) {
+		const messages = [];
+		for (const entry of this.getPath(entryId)) if (entry.type === "message") messages.push(require_messageSerialization.deserializeMessage(entry.data.message));
+		else if (entry.type === "summary") messages.push(new _langchain_core_messages.SystemMessage(entry.data.text));
+		return messages;
+	}
+	getForkPoints() {
+		return this.entries.filter((entry) => entry.type === "message" && entry.data.role === "user");
+	}
+	getLabel(entryId) {
+		return [...this.entries].reverse().find((entry) => entry.type === "label" && entry.data.targetEntryId === entryId)?.data.label;
+	}
+	async setLabel(entryId, label) {
+		return this.appendEntry({
+			type: "label",
+			parentId: this.getLeafEntry()?.id ?? null,
+			data: {
+				targetEntryId: entryId,
+				label
+			}
+		});
+	}
+	async appendMessage(message, parentId = this.getLeafEntry()?.id ?? null) {
+		const entry = await this.appendEntry({
+			type: "message",
+			parentId,
+			data: {
+				role: require_messageSerialization.getMessageRole(message),
+				message: require_messageSerialization.serializeMessage(message)
+			}
+		});
+		await this.setLeaf(entry.id);
+		return entry;
+	}
+	async appendRunEvent(event, payload, params) {
+		return this.appendEntry({
+			type: "run_event",
+			parentId: this.getLeafEntry()?.id ?? null,
+			data: {
+				event,
+				...params?.runId != null && params.runId !== "" ? { runId: params.runId } : {},
+				...params?.threadId != null && params.threadId !== "" ? { threadId: params.threadId } : {},
+				...typeof payload !== "undefined" ? { payload: require_messageSerialization.toJsonValue(payload) } : {}
+			}
+		});
+	}
+	async setLeaf(leafId) {
+		return this.appendEntry({
+			type: "session_state",
+			parentId: leafId,
+			data: { leafId }
+		});
+	}
+	async appendEntryForCompaction(params) {
+		const tokenCount = typeof params.tokenCount === "number" && Number.isFinite(params.tokenCount) && params.tokenCount >= 0 ? params.tokenCount : void 0;
+		const entry = await this.appendEntry({
+			type: "summary",
+			parentId: "parentId" in params ? params.parentId ?? null : this.getLeafEntry()?.id ?? null,
+			data: {
+				text: params.text,
+				...tokenCount != null ? { tokenCount } : {},
+				retainedEntryIds: params.retainedEntryIds,
+				summarizedEntryIds: params.summarizedEntryIds,
+				...params.instructions != null && params.instructions !== "" ? { instructions: params.instructions } : {}
+			}
+		});
+		await this.setLeaf(entry.id);
+		return entry;
+	}
+	async appendCompactionEntry(params) {
+		return this.appendEntry({
+			type: "compaction",
+			parentId: this.getLeafEntry()?.id ?? null,
+			data: {
+				summaryEntryId: params.summaryEntryId,
+				retainedEntryIds: params.retainedEntryIds,
+				summarizedEntryIds: params.summarizedEntryIds
+			}
+		});
+	}
+	async appendCheckpoint(params) {
+		return this.appendEntry({
+			type: "checkpoint",
+			parentId: this.getLeafEntry()?.id ?? null,
+			data: {
+				provider: "langgraph",
+				source: params.source,
+				threadId: params.threadId,
+				...params.runId != null && params.runId !== "" ? { runId: params.runId } : {},
+				...params.checkpointId != null && params.checkpointId !== "" ? { checkpointId: params.checkpointId } : {},
+				...params.checkpointNs != null ? { checkpointNs: params.checkpointNs } : {},
+				...params.parentCheckpointId != null && params.parentCheckpointId !== "" ? { parentCheckpointId: params.parentCheckpointId } : {},
+				...params.reason != null && params.reason !== "" ? { reason: params.reason } : {}
+			}
+		});
+	}
+	getCheckpoints(threadId) {
+		return this.entries.filter((entry) => entry.type === "checkpoint" && (threadId == null || entry.data.threadId === threadId));
+	}
+	getLatestCheckpoint(threadId) {
+		const checkpoints = this.getCheckpoints(threadId);
+		for (let i = checkpoints.length - 1; i >= 0; i--) {
+			const checkpoint = checkpoints[i];
+			if (checkpoint.data.source === "reset") return;
+			return checkpoint;
+		}
+	}
+	async branch(entryId, options = {}) {
+		const target = this.getBranchTarget(entryId, options.position ?? "at");
+		await this.setLeaf(target?.id ?? null);
+		return target;
+	}
+	async createBranchedSession(entryId = this.getLeafEntry()?.id, options = {}) {
+		const target = entryId != null && entryId !== "" ? this.getBranchTarget(entryId, options.position ?? "at") : this.getLeafEntry();
+		const newStore = await JsonlSessionStore.create({
+			cwd: options.cwd ?? this.header.cwd,
+			name: options.name ?? this.header.name,
+			parentSession: this.path
+		});
+		const pathEntries = target ? this.getPath(target.id) : [];
+		for (const entry of pathEntries) await newStore.appendExistingEntry(entry);
+		await newStore.setLeaf(target?.id ?? null);
+		return newStore;
+	}
+	async clone(options = {}) {
+		return this.createBranchedSession(this.getLeafEntry()?.id, {
+			...options,
+			position: "at"
+		});
+	}
+	async fork(entryId, options = {}) {
+		return this.createBranchedSession(entryId, {
+			...options,
+			position: options.position ?? "before"
+		});
+	}
+	getBranchTarget(entryId, position) {
+		const entry = this.getEntry(entryId);
+		if (!entry) throw new Error(`Entry not found: ${entryId}`);
+		if (position === "at") return entry;
+		return entry.parentId == null ? void 0 : this.getEntry(entry.parentId);
+	}
+	async appendExistingEntry(entry) {
+		this.entries.push(entry);
+		await (0, fs_promises.appendFile)(this.path, `${JSON.stringify(entry)}\n`, "utf8");
+	}
+	async appendEntry(params) {
+		const entry = {
+			type: params.type,
+			id: require_ids.createEntryId(),
+			parentId: params.parentId,
+			timestamp: require_ids.createTimestamp(),
+			data: params.data
+		};
+		this.entries.push(entry);
+		await (0, fs_promises.appendFile)(this.path, `${JSON.stringify(entry)}\n`, "utf8");
+		return entry;
+	}
+	async existsOnDisk() {
+		return (await (0, fs_promises.stat)(this.path).catch(() => void 0))?.isFile() === true;
+	}
+};
 const SessionManager = JsonlSessionStore;
-
+//#endregion
 exports.JsonlSessionStore = JsonlSessionStore;
 exports.SessionManager = SessionManager;
-//# sourceMappingURL=JsonlSessionStore.cjs.map
+
+//# sourceMappingURL=JsonlSessionStore.cjs.map