import type { FileSystem, JsonlSessionCreateOptions, JsonlSessionListOptions, JsonlSessionMetadata, JsonlSessionRepoApi, Session, } from "../types.js"; import { getOrThrow } from "../types.js"; import { JsonlSessionStorage, loadJsonlSessionMetadata } from "./jsonl-storage.js"; import { createSessionId, createTimestamp, getEntriesToFork, toSession } from "./repo-utils.js"; type JsonlSessionRepoFileSystem = Pick< FileSystem, | "cwd" | "absolutePath" | "joinPath" | "readTextFile" | "writeFile" | "appendFile" | "listDir" | "exists" | "createDir" | "remove" >; function encodeCwd(cwd: string): string { return `--${cwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`; } export class JsonlSessionRepo implements JsonlSessionRepoApi { private readonly fs: JsonlSessionRepoFileSystem; private readonly sessionsRootInput: string; private sessionsRoot: string | undefined; constructor(options: { fs: JsonlSessionRepoFileSystem; sessionsRoot: string }) { this.fs = options.fs; this.sessionsRootInput = options.sessionsRoot; } private async getSessionsRoot(): Promise { if (!this.sessionsRoot) { this.sessionsRoot = getOrThrow(await this.fs.absolutePath(this.sessionsRootInput)); } return this.sessionsRoot; } private async getSessionDir(cwd: string): Promise { return getOrThrow(await this.fs.joinPath([await this.getSessionsRoot(), encodeCwd(cwd)])); } private async createSessionFilePath(cwd: string, sessionId: string, timestamp: string): Promise { return getOrThrow( await this.fs.joinPath([ await this.getSessionDir(cwd), `${timestamp.replace(/[:.]/g, "-")}_${sessionId}.jsonl`, ]), ); } async create(options: JsonlSessionCreateOptions): Promise> { const id = options.id ?? createSessionId(); const createdAt = createTimestamp(); const sessionDir = await this.getSessionDir(options.cwd); getOrThrow(await this.fs.createDir(sessionDir, { recursive: true })); const filePath = await this.createSessionFilePath(options.cwd, id, createdAt); const storage = await JsonlSessionStorage.create(this.fs, filePath, { cwd: options.cwd, sessionId: id, parentSessionPath: options.parentSessionPath, }); return toSession(storage); } async open(metadata: JsonlSessionMetadata): Promise> { if (!getOrThrow(await this.fs.exists(metadata.path))) { throw new Error(`Session not found: ${metadata.path}`); } const storage = await JsonlSessionStorage.open(this.fs, metadata.path); return toSession(storage); } async list(options: JsonlSessionListOptions = {}): Promise { const dirs = options.cwd ? [await this.getSessionDir(options.cwd)] : await this.listSessionDirs(); const sessions: JsonlSessionMetadata[] = []; for (const dir of dirs) { if (!getOrThrow(await this.fs.exists(dir))) continue; const files = getOrThrow(await this.fs.listDir(dir)).filter( (file) => file.kind !== "directory" && file.name.endsWith(".jsonl"), ); for (const file of files) { try { sessions.push(await loadJsonlSessionMetadata(this.fs, file.path)); } catch { // Ignore invalid session files when listing a directory. } } } sessions.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()); return sessions; } async delete(metadata: JsonlSessionMetadata): Promise { getOrThrow(await this.fs.remove(metadata.path, { force: true })); } async fork( sourceMetadata: JsonlSessionMetadata, options: JsonlSessionCreateOptions & { entryId?: string; position?: "before" | "at"; id?: string }, ): Promise> { const source = await this.open(sourceMetadata); const forkedEntries = await getEntriesToFork(source.getStorage(), options); const id = options.id ?? createSessionId(); const createdAt = createTimestamp(); const sessionDir = await this.getSessionDir(options.cwd); getOrThrow(await this.fs.createDir(sessionDir, { recursive: true })); const storage = await JsonlSessionStorage.create( this.fs, await this.createSessionFilePath(options.cwd, id, createdAt), { cwd: options.cwd, sessionId: id, parentSessionPath: options.parentSessionPath ?? sourceMetadata.path, }, ); for (const entry of forkedEntries) { await storage.appendEntry(entry); } return toSession(storage); } private async listSessionDirs(): Promise { const sessionsRoot = await this.getSessionsRoot(); if (!getOrThrow(await this.fs.exists(sessionsRoot))) return []; const entries = getOrThrow(await this.fs.listDir(sessionsRoot)); return entries.filter((entry) => entry.kind === "directory").map((entry) => entry.path); } }