@greppleai/grip 0.0.0-stage → 0.1.3

package/dist/core/session/local-session-manager.js

@@ -0,0 +1,205 @@
+import { existsSync, lstatSync, readdirSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { CURRENT_SESSION_VERSION } from "./constants.js";
+import { createSessionId } from "./ids.js";
+import { createJsonlSessionDecodeError } from "./jsonl-errors.js";
+import { findMostRecentSession, getDefaultSessionDir, getDefaultSessionDirPath, loadEntriesFromFile, } from "./jsonl-helpers.js";
+import { LocalSession } from "./local-session.js";
+import { migrateToCurrentVersion } from "./migrations.js";
+import { ensureDir, forkSession as forkJsonlSession, getJsonlEntryLocations, getSessionDirForReference, getSessionsRoot, listAll as listAllJsonlSessions, list as listJsonlSessions, prepareSessionReference, publishJsonlAtomically, readSessionHeader, SessionAlreadyExistsError, SessionHeaderScanLimitError, validateCurrentSessionEntries, } from "./stores/jsonl-session-store.js";
+export class LocalSessionManager {
+    cwd;
+    sessionDir;
+    activePublicationDestinations = new Set();
+    firstPublicationCoordinator = {
+        publish: (filePath, entries, operation, options) => this.publishFirstSnapshot(filePath, entries, operation, options),
+    };
+    constructor(options) {
+        this.cwd = options.cwd;
+        this.sessionDir = options.sessionDir;
+    }
+    create(options) {
+        const dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);
+        const session = new LocalSession(this.cwd, dir, undefined, this, undefined, this.firstPublicationCoordinator);
+        if (options?.id || options?.parentSession) {
+            session.newSession(options);
+        }
+        return session;
+    }
+    openReference(reference, options) {
+        let header = null;
+        let preloadedFileEntries;
+        if (options?.cwdOverride === undefined && existsSync(reference)) {
+            try {
+                header = readSessionHeader(reference);
+            }
+            catch (error) {
+                if (!(error instanceof SessionHeaderScanLimitError))
+                    throw error;
+                // The bounded scan is only a discovery optimization. A full load remains
+                // authoritative for legacy files with very large headers or prefixes.
+                preloadedFileEntries = loadEntriesFromFile(reference);
+                const firstEntry = preloadedFileEntries[0];
+                header = firstEntry?.type === "session" ? firstEntry : null;
+            }
+        }
+        const storedCwd = typeof header?.cwd === "string" ? header.cwd : undefined;
+        const cwd = options?.cwdOverride ?? storedCwd ?? this.cwd;
+        const dir = this.sessionDir ?? getSessionDirForReference(reference);
+        return new LocalSession(cwd, dir, reference, this, preloadedFileEntries, this.firstPublicationCoordinator);
+    }
+    continueRecent() {
+        const dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);
+        const filterCwd = this.sessionDir !== undefined && dir !== getDefaultSessionDirPath(this.cwd);
+        const mostRecent = findMostRecentSession(dir, filterCwd ? this.cwd : undefined);
+        if (mostRecent) {
+            return new LocalSession(this.cwd, dir, mostRecent, this, undefined, this.firstPublicationCoordinator);
+        }
+        return new LocalSession(this.cwd, dir, undefined, this, undefined, this.firstPublicationCoordinator);
+    }
+    usesDefaultSessionDir() {
+        return (this.sessionDir ?? getDefaultSessionDir(this.cwd)) === getDefaultSessionDirPath(this.cwd);
+    }
+    forkFrom(reference) {
+        const sourceEntries = loadEntriesFromFile(reference, { repair: false, phase: "fork" });
+        if (sourceEntries.length === 0) {
+            throw createJsonlSessionDecodeError(reference, "fork", "schema", `Cannot fork empty session: ${reference}`);
+        }
+        migrateToCurrentVersion(sourceEntries);
+        validateCurrentSessionEntries(sourceEntries, reference, {
+            phase: "fork",
+            locations: getJsonlEntryLocations(sourceEntries),
+        });
+        const sourceHeader = sourceEntries[0];
+        if (sourceHeader?.type !== "session") {
+            throw new Error(`Cannot fork: source session has no header: ${reference}`);
+        }
+        const dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);
+        ensureDir(dir);
+        const newSessionId = createSessionId();
+        const timestamp = new Date().toISOString();
+        const newHeader = {
+            type: "session",
+            version: CURRENT_SESSION_VERSION,
+            id: newSessionId,
+            timestamp,
+            cwd: this.cwd,
+            parentSession: reference,
+        };
+        const expectedReference = prepareSessionReference(dir, newHeader.id, newHeader.timestamp);
+        const newSessionReference = this.claimFirstPublication(expectedReference, [newHeader, ...sourceEntries], () => forkJsonlSession(dir, newHeader, sourceEntries), { allowExistingEmptyFile: false, phase: "fork" });
+        return new LocalSession(this.cwd, dir, newSessionReference, this, undefined, this.firstPublicationCoordinator);
+    }
+    publishFirstSnapshot(filePath, entries, operation, options) {
+        this.claimFirstPublication(filePath, entries, operation, options);
+    }
+    claimFirstPublication(filePath, entries, operation, options = {
+        allowExistingEmptyFile: false,
+        phase: "create",
+    }) {
+        const header = entries.find((entry) => entry.type === "session");
+        if (!header)
+            throw new Error(`Cannot publish session without a header: ${filePath}`);
+        const key = `${this.canonicalCwd(header.cwd)}\0${header.id}`;
+        if (this.activePublicationDestinations.has(key)) {
+            throw new SessionAlreadyExistsError(filePath, header.id, options.phase);
+        }
+        this.activePublicationDestinations.add(key);
+        try {
+            this.rejectExistingSession(filePath, header, options);
+            return operation();
+        }
+        finally {
+            this.activePublicationDestinations.delete(key);
+        }
+    }
+    rejectConflictingPublicationCandidate(candidate, resolvedTarget, header, options) {
+        if (candidate === resolvedTarget) {
+            if (options.allowExistingEmptyFile && lstatSync(candidate).isFile() && lstatSync(candidate).size === 0)
+                return;
+            throw new SessionAlreadyExistsError(candidate, header.id, options.phase);
+        }
+        try {
+            const existing = readSessionHeader(candidate);
+            if (existing?.id === header.id &&
+                typeof existing.cwd === "string" &&
+                this.canonicalCwd(existing.cwd) === this.canonicalCwd(header.cwd)) {
+                throw new SessionAlreadyExistsError(candidate, header.id, options.phase);
+            }
+        }
+        catch (error) {
+            if (error instanceof SessionAlreadyExistsError)
+                throw error;
+            if (error instanceof SessionHeaderScanLimitError)
+                return;
+            throw error;
+        }
+    }
+    rejectExistingSession(filePath, header, options) {
+        const resolvedTarget = resolve(filePath);
+        for (const name of readdirSync(dirname(resolvedTarget))) {
+            if (!name.endsWith(".jsonl"))
+                continue;
+            const candidate = resolve(dirname(resolvedTarget), name);
+            this.rejectConflictingPublicationCandidate(candidate, resolvedTarget, header, options);
+        }
+    }
+    canonicalCwd(cwd) {
+        const canonical = resolve(cwd);
+        return process.platform === "win32"
+            ? canonical.replace(/^([A-Z]):/, (_, drive) => `${drive.toLowerCase()}:`)
+            : canonical;
+    }
+    forkSession(source, targetLeafId) {
+        const parentSession = source.getSessionReference();
+        if (!targetLeafId) {
+            const session = this.create();
+            session.newSession({ parentSession });
+            return session;
+        }
+        const branchSource = parentSession && existsSync(parentSession) ? this.openReference(parentSession) : source;
+        const target = this.create({ parentSession });
+        target.copyBranchFrom(branchSource, targetLeafId, parentSession);
+        return target;
+    }
+    importJsonl(inputPath, options) {
+        const resolvedPath = resolve(inputPath);
+        if (!existsSync(resolvedPath))
+            throw new Error(`File not found: ${resolvedPath}`);
+        const entries = loadEntriesFromFile(resolvedPath, { repair: false, phase: "import" });
+        if (entries.length === 0) {
+            throw createJsonlSessionDecodeError(resolvedPath, "import", "schema", `Cannot import empty session JSONL: ${resolvedPath}`);
+        }
+        migrateToCurrentVersion(entries);
+        validateCurrentSessionEntries(entries, resolvedPath, {
+            phase: "import",
+            locations: getJsonlEntryLocations(entries),
+        });
+        const dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);
+        ensureDir(dir);
+        const destinationPath = join(dir, basename(resolvedPath));
+        if (resolve(destinationPath) === resolvedPath)
+            return this.openReference(resolvedPath, options);
+        const header = entries[0];
+        if (header?.type !== "session")
+            throw new Error(`Cannot import session without a header: ${resolvedPath}`);
+        this.claimFirstPublication(destinationPath, entries, () => publishJsonlAtomically(destinationPath, entries, { phase: "import" }), { allowExistingEmptyFile: false, phase: "import" });
+        return this.openReference(destinationPath, options);
+    }
+    async list(onProgress) {
+        const dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);
+        const filterCwd = this.sessionDir !== undefined && dir !== getDefaultSessionDirPath(this.cwd);
+        const resolvedCwd = resolve(this.cwd);
+        const sessions = (await listJsonlSessions(dir, onProgress)).filter((session) => !filterCwd || (session.cwd !== undefined && resolve(session.cwd) === resolvedCwd));
+        sessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());
+        return sessions;
+    }
+    async listAll(onProgress) {
+        const sessions = this.sessionDir
+            ? await listJsonlSessions(this.sessionDir, onProgress)
+            : await listAllJsonlSessions(getSessionsRoot(), onProgress);
+        sessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());
+        return sessions;
+    }
+}
+//# sourceMappingURL=local-session-manager.js.map

package/dist/core/session/local-session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-session-manager.js","sourceRoot":"","sources":["../../../src/core/session/local-session-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, lstatSync, readdirSync } from \"node:fs\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { CURRENT_SESSION_VERSION } from \"./constants.ts\";\nimport { createSessionId } from \"./ids.ts\";\nimport { createJsonlSessionDecodeError } from \"./jsonl-errors.ts\";\nimport {\n\tfindMostRecentSession,\n\tgetDefaultSessionDir,\n\tgetDefaultSessionDirPath,\n\tloadEntriesFromFile,\n} from \"./jsonl-helpers.ts\";\nimport { LocalSession } from \"./local-session.ts\";\nimport { migrateToCurrentVersion } from \"./migrations.ts\";\nimport type { Session } from \"./session.ts\";\nimport type { OpenSessionOptions, SessionManager } from \"./session-manager.ts\";\nimport {\n\tensureDir,\n\tforkSession as forkJsonlSession,\n\tgetJsonlEntryLocations,\n\tgetSessionDirForReference,\n\tgetSessionsRoot,\n\ttype JsonlFirstPublicationCoordinator,\n\tlistAll as listAllJsonlSessions,\n\tlist as listJsonlSessions,\n\tprepareSessionReference,\n\tpublishJsonlAtomically,\n\treadSessionHeader,\n\tSessionAlreadyExistsError,\n\tSessionHeaderScanLimitError,\n\tvalidateCurrentSessionEntries,\n} from \"./stores/jsonl-session-store.ts\";\nimport type { FileEntry, NewSessionOptions, SessionHeader, SessionInfo, SessionListProgress } from \"./types.ts\";\n\nexport interface LocalSessionManagerOptions {\n\tcwd: string;\n\tsessionDir?: string;\n}\n\ntype SessionPublicationPhase = \"create\" | \"fork\" | \"import\";\n\ninterface SessionPublicationClaimOptions {\n\tallowExistingEmptyFile: boolean;\n\tphase: SessionPublicationPhase;\n}\n\nexport class LocalSessionManager implements SessionManager {\n\tprivate readonly cwd: string;\n\tprivate readonly sessionDir?: string;\n\tprivate readonly activePublicationDestinations = new Set<string>();\n\tprivate readonly firstPublicationCoordinator: JsonlFirstPublicationCoordinator = {\n\t\tpublish: (filePath, entries, operation, options) =>\n\t\t\tthis.publishFirstSnapshot(filePath, entries, operation, options),\n\t};\n\n\tconstructor(options: LocalSessionManagerOptions) {\n\t\tthis.cwd = options.cwd;\n\t\tthis.sessionDir = options.sessionDir;\n\t}\n\n\tcreate(options?: NewSessionOptions): LocalSession {\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tconst session = new LocalSession(this.cwd, dir, undefined, this, undefined, this.firstPublicationCoordinator);\n\t\tif (options?.id || options?.parentSession) {\n\t\t\tsession.newSession(options);\n\t\t}\n\t\treturn session;\n\t}\n\n\topenReference(reference: string, options?: OpenSessionOptions): LocalSession {\n\t\tlet header: SessionHeader | null = null;\n\t\tlet preloadedFileEntries: FileEntry[] | undefined;\n\t\tif (options?.cwdOverride === undefined && existsSync(reference)) {\n\t\t\ttry {\n\t\t\t\theader = readSessionHeader(reference);\n\t\t\t} catch (error) {\n\t\t\t\tif (!(error instanceof SessionHeaderScanLimitError)) throw error;\n\t\t\t\t// The bounded scan is only a discovery optimization. A full load remains\n\t\t\t\t// authoritative for legacy files with very large headers or prefixes.\n\t\t\t\tpreloadedFileEntries = loadEntriesFromFile(reference);\n\t\t\t\tconst firstEntry = preloadedFileEntries[0];\n\t\t\t\theader = firstEntry?.type === \"session\" ? firstEntry : null;\n\t\t\t}\n\t\t}\n\t\tconst storedCwd = typeof header?.cwd === \"string\" ? header.cwd : undefined;\n\t\tconst cwd = options?.cwdOverride ?? storedCwd ?? this.cwd;\n\t\tconst dir = this.sessionDir ?? getSessionDirForReference(reference);\n\t\treturn new LocalSession(cwd, dir, reference, this, preloadedFileEntries, this.firstPublicationCoordinator);\n\t}\n\n\tcontinueRecent(): LocalSession {\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tconst filterCwd = this.sessionDir !== undefined && dir !== getDefaultSessionDirPath(this.cwd);\n\t\tconst mostRecent = findMostRecentSession(dir, filterCwd ? this.cwd : undefined);\n\t\tif (mostRecent) {\n\t\t\treturn new LocalSession(this.cwd, dir, mostRecent, this, undefined, this.firstPublicationCoordinator);\n\t\t}\n\t\treturn new LocalSession(this.cwd, dir, undefined, this, undefined, this.firstPublicationCoordinator);\n\t}\n\n\tusesDefaultSessionDir(): boolean {\n\t\treturn (this.sessionDir ?? getDefaultSessionDir(this.cwd)) === getDefaultSessionDirPath(this.cwd);\n\t}\n\n\tforkFrom(reference: string): LocalSession {\n\t\tconst sourceEntries = loadEntriesFromFile(reference, { repair: false, phase: \"fork\" });\n\t\tif (sourceEntries.length === 0) {\n\t\t\tthrow createJsonlSessionDecodeError(reference, \"fork\", \"schema\", `Cannot fork empty session: ${reference}`);\n\t\t}\n\t\tmigrateToCurrentVersion(sourceEntries);\n\t\tvalidateCurrentSessionEntries(sourceEntries, reference, {\n\t\t\tphase: \"fork\",\n\t\t\tlocations: getJsonlEntryLocations(sourceEntries),\n\t\t});\n\t\tconst sourceHeader = sourceEntries[0];\n\t\tif (sourceHeader?.type !== \"session\") {\n\t\t\tthrow new Error(`Cannot fork: source session has no header: ${reference}`);\n\t\t}\n\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tensureDir(dir);\n\n\t\tconst newSessionId = createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst newHeader: SessionHeader = {\n\t\t\ttype: \"session\",\n\t\t\tversion: CURRENT_SESSION_VERSION,\n\t\t\tid: newSessionId,\n\t\t\ttimestamp,\n\t\t\tcwd: this.cwd,\n\t\t\tparentSession: reference,\n\t\t};\n\t\tconst expectedReference = prepareSessionReference(dir, newHeader.id, newHeader.timestamp);\n\t\tconst newSessionReference = this.claimFirstPublication(\n\t\t\texpectedReference,\n\t\t\t[newHeader, ...sourceEntries],\n\t\t\t() => forkJsonlSession(dir, newHeader, sourceEntries),\n\t\t\t{ allowExistingEmptyFile: false, phase: \"fork\" },\n\t\t);\n\n\t\treturn new LocalSession(this.cwd, dir, newSessionReference, this, undefined, this.firstPublicationCoordinator);\n\t}\n\n\tprivate publishFirstSnapshot(\n\t\tfilePath: string,\n\t\tentries: FileEntry[],\n\t\toperation: () => void,\n\t\toptions: SessionPublicationClaimOptions,\n\t): void {\n\t\tthis.claimFirstPublication(filePath, entries, operation, options);\n\t}\n\n\tprivate claimFirstPublication<T>(\n\t\tfilePath: string,\n\t\tentries: FileEntry[],\n\t\toperation: () => T,\n\t\toptions: SessionPublicationClaimOptions = {\n\t\t\tallowExistingEmptyFile: false,\n\t\t\tphase: \"create\",\n\t\t},\n\t): T {\n\t\tconst header = entries.find((entry): entry is SessionHeader => entry.type === \"session\");\n\t\tif (!header) throw new Error(`Cannot publish session without a header: ${filePath}`);\n\t\tconst key = `${this.canonicalCwd(header.cwd)}\\0${header.id}`;\n\t\tif (this.activePublicationDestinations.has(key)) {\n\t\t\tthrow new SessionAlreadyExistsError(filePath, header.id, options.phase);\n\t\t}\n\t\tthis.activePublicationDestinations.add(key);\n\t\ttry {\n\t\t\tthis.rejectExistingSession(filePath, header, options);\n\t\t\treturn operation();\n\t\t} finally {\n\t\t\tthis.activePublicationDestinations.delete(key);\n\t\t}\n\t}\n\n\tprivate rejectConflictingPublicationCandidate(\n\t\tcandidate: string,\n\t\tresolvedTarget: string,\n\t\theader: SessionHeader,\n\t\toptions: SessionPublicationClaimOptions,\n\t): void {\n\t\tif (candidate === resolvedTarget) {\n\t\t\tif (options.allowExistingEmptyFile && lstatSync(candidate).isFile() && lstatSync(candidate).size === 0) return;\n\t\t\tthrow new SessionAlreadyExistsError(candidate, header.id, options.phase);\n\t\t}\n\t\ttry {\n\t\t\tconst existing = readSessionHeader(candidate);\n\t\t\tif (\n\t\t\t\texisting?.id === header.id &&\n\t\t\t\ttypeof existing.cwd === \"string\" &&\n\t\t\t\tthis.canonicalCwd(existing.cwd) === this.canonicalCwd(header.cwd)\n\t\t\t) {\n\t\t\t\tthrow new SessionAlreadyExistsError(candidate, header.id, options.phase);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (error instanceof SessionAlreadyExistsError) throw error;\n\t\t\tif (error instanceof SessionHeaderScanLimitError) return;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprivate rejectExistingSession(\n\t\tfilePath: string,\n\t\theader: SessionHeader,\n\t\toptions: SessionPublicationClaimOptions,\n\t): void {\n\t\tconst resolvedTarget = resolve(filePath);\n\t\tfor (const name of readdirSync(dirname(resolvedTarget))) {\n\t\t\tif (!name.endsWith(\".jsonl\")) continue;\n\t\t\tconst candidate = resolve(dirname(resolvedTarget), name);\n\t\t\tthis.rejectConflictingPublicationCandidate(candidate, resolvedTarget, header, options);\n\t\t}\n\t}\n\n\tprivate canonicalCwd(cwd: string): string {\n\t\tconst canonical = resolve(cwd);\n\t\treturn process.platform === \"win32\"\n\t\t\t? canonical.replace(/^([A-Z]):/, (_, drive: string) => `${drive.toLowerCase()}:`)\n\t\t\t: canonical;\n\t}\n\n\tforkSession(source: Session, targetLeafId: string | null): LocalSession {\n\t\tconst parentSession = source.getSessionReference();\n\t\tif (!targetLeafId) {\n\t\t\tconst session = this.create();\n\t\t\tsession.newSession({ parentSession });\n\t\t\treturn session;\n\t\t}\n\n\t\tconst branchSource = parentSession && existsSync(parentSession) ? this.openReference(parentSession) : source;\n\t\tconst target = this.create({ parentSession });\n\t\ttarget.copyBranchFrom(branchSource, targetLeafId, parentSession);\n\t\treturn target;\n\t}\n\n\timportJsonl(inputPath: string, options?: OpenSessionOptions): LocalSession {\n\t\tconst resolvedPath = resolve(inputPath);\n\t\tif (!existsSync(resolvedPath)) throw new Error(`File not found: ${resolvedPath}`);\n\n\t\tconst entries = loadEntriesFromFile(resolvedPath, { repair: false, phase: \"import\" });\n\t\tif (entries.length === 0) {\n\t\t\tthrow createJsonlSessionDecodeError(\n\t\t\t\tresolvedPath,\n\t\t\t\t\"import\",\n\t\t\t\t\"schema\",\n\t\t\t\t`Cannot import empty session JSONL: ${resolvedPath}`,\n\t\t\t);\n\t\t}\n\t\tmigrateToCurrentVersion(entries);\n\t\tvalidateCurrentSessionEntries(entries, resolvedPath, {\n\t\t\tphase: \"import\",\n\t\t\tlocations: getJsonlEntryLocations(entries),\n\t\t});\n\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tensureDir(dir);\n\t\tconst destinationPath = join(dir, basename(resolvedPath));\n\t\tif (resolve(destinationPath) === resolvedPath) return this.openReference(resolvedPath, options);\n\n\t\tconst header = entries[0];\n\t\tif (header?.type !== \"session\") throw new Error(`Cannot import session without a header: ${resolvedPath}`);\n\t\tthis.claimFirstPublication(\n\t\t\tdestinationPath,\n\t\t\tentries,\n\t\t\t() => publishJsonlAtomically(destinationPath, entries, { phase: \"import\" }),\n\t\t\t{ allowExistingEmptyFile: false, phase: \"import\" },\n\t\t);\n\t\treturn this.openReference(destinationPath, options);\n\t}\n\n\tasync list(onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tconst filterCwd = this.sessionDir !== undefined && dir !== getDefaultSessionDirPath(this.cwd);\n\t\tconst resolvedCwd = resolve(this.cwd);\n\t\tconst sessions = (await listJsonlSessions(dir, onProgress)).filter(\n\t\t\t(session) => !filterCwd || (session.cwd !== undefined && resolve(session.cwd) === resolvedCwd),\n\t\t);\n\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\treturn sessions;\n\t}\n\n\tasync listAll(onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst sessions = this.sessionDir\n\t\t\t? await listJsonlSessions(this.sessionDir, onProgress)\n\t\t\t: await listAllJsonlSessions(getSessionsRoot(), onProgress);\n\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\treturn sessions;\n\t}\n}\n"]}

package/dist/core/session/local-session.d.ts

@@ -0,0 +1,9 @@
+import { Session } from "./session.ts";
+import type { SessionManager } from "./session-manager.ts";
+import { type JsonlFirstPublicationCoordinator } from "./stores/jsonl-session-store.ts";
+import type { FileEntry } from "./types.ts";
+export declare class LocalSession extends Session {
+    constructor(cwd: string, sessionDir: string, sessionReference: string | undefined, sessionManager?: SessionManager, preloadedFileEntries?: FileEntry[], firstPublicationCoordinator?: JsonlFirstPublicationCoordinator);
+    protected prepareNewSessionReference(sessionDir: string, sessionId: string, timestamp: string): string | undefined;
+}
+//# sourceMappingURL=local-session.d.ts.map

package/dist/core/session/local-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-session.d.ts","sourceRoot":"","sources":["../../../src/core/session/local-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,KAAK,gCAAgC,EAAqB,MAAM,iCAAiC,CAAC;AAC3G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,YAAa,SAAQ,OAAO;IACxC,YACC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,cAAc,CAAC,EAAE,cAAc,EAC/B,oBAAoB,CAAC,EAAE,SAAS,EAAE,EAClC,2BAA2B,CAAC,EAAE,gCAAgC,EAe9D;IAED,SAAS,CAAC,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGjH;CACD","sourcesContent":["import { join } from \"node:path\";\nimport { Session } from \"./session.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { type JsonlFirstPublicationCoordinator, JsonlSessionStore } from \"./stores/jsonl-session-store.ts\";\nimport type { FileEntry } from \"./types.ts\";\n\nexport class LocalSession extends Session {\n\tconstructor(\n\t\tcwd: string,\n\t\tsessionDir: string,\n\t\tsessionReference: string | undefined,\n\t\tsessionManager?: SessionManager,\n\t\tpreloadedFileEntries?: FileEntry[],\n\t\tfirstPublicationCoordinator?: JsonlFirstPublicationCoordinator,\n\t) {\n\t\tsuper(\n\t\t\tcwd,\n\t\t\tsessionDir,\n\t\t\tsessionReference,\n\t\t\tnew JsonlSessionStore(\n\t\t\t\tsessionReference && preloadedFileEntries\n\t\t\t\t\t? { reference: sessionReference, entries: preloadedFileEntries }\n\t\t\t\t\t: undefined,\n\t\t\t\tundefined,\n\t\t\t\tfirstPublicationCoordinator,\n\t\t\t),\n\t\t\tsessionManager,\n\t\t);\n\t}\n\n\tprotected prepareNewSessionReference(sessionDir: string, sessionId: string, timestamp: string): string | undefined {\n\t\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\t\treturn join(sessionDir, `${fileTimestamp}_${sessionId}.jsonl`);\n\t}\n}\n"]}

package/dist/core/session/local-session.js

@@ -0,0 +1,15 @@
+import { join } from "node:path";
+import { Session } from "./session.js";
+import { JsonlSessionStore } from "./stores/jsonl-session-store.js";
+export class LocalSession extends Session {
+    constructor(cwd, sessionDir, sessionReference, sessionManager, preloadedFileEntries, firstPublicationCoordinator) {
+        super(cwd, sessionDir, sessionReference, new JsonlSessionStore(sessionReference && preloadedFileEntries
+            ? { reference: sessionReference, entries: preloadedFileEntries }
+            : undefined, undefined, firstPublicationCoordinator), sessionManager);
+    }
+    prepareNewSessionReference(sessionDir, sessionId, timestamp) {
+        const fileTimestamp = timestamp.replace(/[:.]/g, "-");
+        return join(sessionDir, `${fileTimestamp}_${sessionId}.jsonl`);
+    }
+}
+//# sourceMappingURL=local-session.js.map

package/dist/core/session/local-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-session.js","sourceRoot":"","sources":["../../../src/core/session/local-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAyC,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAG3G,MAAM,OAAO,YAAa,SAAQ,OAAO;IACxC,YACC,GAAW,EACX,UAAkB,EAClB,gBAAoC,EACpC,cAA+B,EAC/B,oBAAkC,EAClC,2BAA8D,EAC7D;QACD,KAAK,CACJ,GAAG,EACH,UAAU,EACV,gBAAgB,EAChB,IAAI,iBAAiB,CACpB,gBAAgB,IAAI,oBAAoB;YACvC,CAAC,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,oBAAoB,EAAE;YAChE,CAAC,CAAC,SAAS,EACZ,SAAS,EACT,2BAA2B,CAC3B,EACD,cAAc,CACd,CAAC;IAAA,CACF;IAES,0BAA0B,CAAC,UAAkB,EAAE,SAAiB,EAAE,SAAiB,EAAsB;QAClH,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,UAAU,EAAE,GAAG,aAAa,IAAI,SAAS,QAAQ,CAAC,CAAC;IAAA,CAC/D;CACD","sourcesContent":["import { join } from \"node:path\";\nimport { Session } from \"./session.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { type JsonlFirstPublicationCoordinator, JsonlSessionStore } from \"./stores/jsonl-session-store.ts\";\nimport type { FileEntry } from \"./types.ts\";\n\nexport class LocalSession extends Session {\n\tconstructor(\n\t\tcwd: string,\n\t\tsessionDir: string,\n\t\tsessionReference: string | undefined,\n\t\tsessionManager?: SessionManager,\n\t\tpreloadedFileEntries?: FileEntry[],\n\t\tfirstPublicationCoordinator?: JsonlFirstPublicationCoordinator,\n\t) {\n\t\tsuper(\n\t\t\tcwd,\n\t\t\tsessionDir,\n\t\t\tsessionReference,\n\t\t\tnew JsonlSessionStore(\n\t\t\t\tsessionReference && preloadedFileEntries\n\t\t\t\t\t? { reference: sessionReference, entries: preloadedFileEntries }\n\t\t\t\t\t: undefined,\n\t\t\t\tundefined,\n\t\t\t\tfirstPublicationCoordinator,\n\t\t\t),\n\t\t\tsessionManager,\n\t\t);\n\t}\n\n\tprotected prepareNewSessionReference(sessionDir: string, sessionId: string, timestamp: string): string | undefined {\n\t\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\t\treturn join(sessionDir, `${fileTimestamp}_${sessionId}.jsonl`);\n\t}\n}\n"]}

package/dist/core/session/migrations.d.ts

@@ -0,0 +1,11 @@
+import type { FileEntry } from "./types.ts";
+/**
+ * Run all necessary migrations to bring entries to current version.
+ * Mutates entries in place. Returns true if any migration was applied.
+ */
+export declare function migrateToCurrentVersion(entries: FileEntry[]): boolean;
+/** Exported for testing. */
+export declare function migrateSessionEntries(entries: FileEntry[]): void;
+/** Exported for compaction tests. */
+export declare function parseSessionEntries(content: string): FileEntry[];
+//# sourceMappingURL=migrations.d.ts.map

package/dist/core/session/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../src/core/session/migrations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmB,SAAS,EAAsC,MAAM,YAAY,CAAC;AA+CjG;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAUrE;AAED,4BAA4B;AAC5B,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAEhE;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAehE","sourcesContent":["import { CURRENT_SESSION_VERSION } from \"./constants.ts\";\nimport { generateId } from \"./ids.ts\";\nimport type { CompactionEntry, FileEntry, SessionHeader, SessionMessageEntry } from \"./types.ts\";\n\n/** Migrate v1 → v2: add id/parentId tree structure. Mutates in place. */\nfunction migrateV1ToV2(entries: FileEntry[]): void {\n\tconst ids = new Set<string>();\n\tlet prevId: string | null = null;\n\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") {\n\t\t\tentry.version = 2;\n\t\t\tcontinue;\n\t\t}\n\n\t\tentry.id = generateId(ids);\n\t\tentry.parentId = prevId;\n\t\tprevId = entry.id;\n\n\t\tif (entry.type === \"compaction\") {\n\t\t\tconst comp = entry as CompactionEntry & { firstKeptEntryIndex?: number };\n\t\t\tif (typeof comp.firstKeptEntryIndex === \"number\") {\n\t\t\t\tconst targetEntry = entries[comp.firstKeptEntryIndex];\n\t\t\t\tif (targetEntry && targetEntry.type !== \"session\") {\n\t\t\t\t\tcomp.firstKeptEntryId = targetEntry.id;\n\t\t\t\t}\n\t\t\t\tdelete comp.firstKeptEntryIndex;\n\t\t\t}\n\t\t}\n\t}\n}\n\n/** Migrate v2 → v3: rename hookMessage role to custom. Mutates in place. */\nfunction migrateV2ToV3(entries: FileEntry[]): void {\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") {\n\t\t\tentry.version = 3;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (entry.type === \"message\") {\n\t\t\tconst msgEntry = entry as SessionMessageEntry;\n\t\t\tif (msgEntry.message && (msgEntry.message as { role: string }).role === \"hookMessage\") {\n\t\t\t\t(msgEntry.message as { role: string }).role = \"custom\";\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Run all necessary migrations to bring entries to current version.\n * Mutates entries in place. Returns true if any migration was applied.\n */\nexport function migrateToCurrentVersion(entries: FileEntry[]): boolean {\n\tconst header = entries.find((entry) => entry.type === \"session\") as SessionHeader | undefined;\n\tconst version = header?.version ?? 1;\n\n\tif (version >= CURRENT_SESSION_VERSION) return false;\n\n\tif (version < 2) migrateV1ToV2(entries);\n\tif (version < 3) migrateV2ToV3(entries);\n\n\treturn true;\n}\n\n/** Exported for testing. */\nexport function migrateSessionEntries(entries: FileEntry[]): void {\n\tmigrateToCurrentVersion(entries);\n}\n\n/** Exported for compaction tests. */\nexport function parseSessionEntries(content: string): FileEntry[] {\n\tconst entries: FileEntry[] = [];\n\tconst lines = content.trim().split(\"\\n\");\n\n\tfor (const line of lines) {\n\t\tif (!line.trim()) continue;\n\t\ttry {\n\t\t\tconst entry = JSON.parse(line) as FileEntry;\n\t\t\tentries.push(entry);\n\t\t} catch {\n\t\t\t// Skip malformed lines.\n\t\t}\n\t}\n\n\treturn entries;\n}\n"]}

package/dist/core/session/migrations.js

@@ -0,0 +1,78 @@
+import { CURRENT_SESSION_VERSION } from "./constants.js";
+import { generateId } from "./ids.js";
+/** Migrate v1 → v2: add id/parentId tree structure. Mutates in place. */
+function migrateV1ToV2(entries) {
+    const ids = new Set();
+    let prevId = null;
+    for (const entry of entries) {
+        if (entry.type === "session") {
+            entry.version = 2;
+            continue;
+        }
+        entry.id = generateId(ids);
+        entry.parentId = prevId;
+        prevId = entry.id;
+        if (entry.type === "compaction") {
+            const comp = entry;
+            if (typeof comp.firstKeptEntryIndex === "number") {
+                const targetEntry = entries[comp.firstKeptEntryIndex];
+                if (targetEntry && targetEntry.type !== "session") {
+                    comp.firstKeptEntryId = targetEntry.id;
+                }
+                delete comp.firstKeptEntryIndex;
+            }
+        }
+    }
+}
+/** Migrate v2 → v3: rename hookMessage role to custom. Mutates in place. */
+function migrateV2ToV3(entries) {
+    for (const entry of entries) {
+        if (entry.type === "session") {
+            entry.version = 3;
+            continue;
+        }
+        if (entry.type === "message") {
+            const msgEntry = entry;
+            if (msgEntry.message && msgEntry.message.role === "hookMessage") {
+                msgEntry.message.role = "custom";
+            }
+        }
+    }
+}
+/**
+ * Run all necessary migrations to bring entries to current version.
+ * Mutates entries in place. Returns true if any migration was applied.
+ */
+export function migrateToCurrentVersion(entries) {
+    const header = entries.find((entry) => entry.type === "session");
+    const version = header?.version ?? 1;
+    if (version >= CURRENT_SESSION_VERSION)
+        return false;
+    if (version < 2)
+        migrateV1ToV2(entries);
+    if (version < 3)
+        migrateV2ToV3(entries);
+    return true;
+}
+/** Exported for testing. */
+export function migrateSessionEntries(entries) {
+    migrateToCurrentVersion(entries);
+}
+/** Exported for compaction tests. */
+export function parseSessionEntries(content) {
+    const entries = [];
+    const lines = content.trim().split("\n");
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            entries.push(entry);
+        }
+        catch {
+            // Skip malformed lines.
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=migrations.js.map

package/dist/core/session/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../../src/core/session/migrations.ts"],"names":[],"mappings":"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","sourcesContent":["import { CURRENT_SESSION_VERSION } from \"./constants.ts\";\nimport { generateId } from \"./ids.ts\";\nimport type { CompactionEntry, FileEntry, SessionHeader, SessionMessageEntry } from \"./types.ts\";\n\n/** Migrate v1 → v2: add id/parentId tree structure. Mutates in place. */\nfunction migrateV1ToV2(entries: FileEntry[]): void {\n\tconst ids = new Set<string>();\n\tlet prevId: string | null = null;\n\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") {\n\t\t\tentry.version = 2;\n\t\t\tcontinue;\n\t\t}\n\n\t\tentry.id = generateId(ids);\n\t\tentry.parentId = prevId;\n\t\tprevId = entry.id;\n\n\t\tif (entry.type === \"compaction\") {\n\t\t\tconst comp = entry as CompactionEntry & { firstKeptEntryIndex?: number };\n\t\t\tif (typeof comp.firstKeptEntryIndex === \"number\") {\n\t\t\t\tconst targetEntry = entries[comp.firstKeptEntryIndex];\n\t\t\t\tif (targetEntry && targetEntry.type !== \"session\") {\n\t\t\t\t\tcomp.firstKeptEntryId = targetEntry.id;\n\t\t\t\t}\n\t\t\t\tdelete comp.firstKeptEntryIndex;\n\t\t\t}\n\t\t}\n\t}\n}\n\n/** Migrate v2 → v3: rename hookMessage role to custom. Mutates in place. */\nfunction migrateV2ToV3(entries: FileEntry[]): void {\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"session\") {\n\t\t\tentry.version = 3;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (entry.type === \"message\") {\n\t\t\tconst msgEntry = entry as SessionMessageEntry;\n\t\t\tif (msgEntry.message && (msgEntry.message as { role: string }).role === \"hookMessage\") {\n\t\t\t\t(msgEntry.message as { role: string }).role = \"custom\";\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Run all necessary migrations to bring entries to current version.\n * Mutates entries in place. Returns true if any migration was applied.\n */\nexport function migrateToCurrentVersion(entries: FileEntry[]): boolean {\n\tconst header = entries.find((entry) => entry.type === \"session\") as SessionHeader | undefined;\n\tconst version = header?.version ?? 1;\n\n\tif (version >= CURRENT_SESSION_VERSION) return false;\n\n\tif (version < 2) migrateV1ToV2(entries);\n\tif (version < 3) migrateV2ToV3(entries);\n\n\treturn true;\n}\n\n/** Exported for testing. */\nexport function migrateSessionEntries(entries: FileEntry[]): void {\n\tmigrateToCurrentVersion(entries);\n}\n\n/** Exported for compaction tests. */\nexport function parseSessionEntries(content: string): FileEntry[] {\n\tconst entries: FileEntry[] = [];\n\tconst lines = content.trim().split(\"\\n\");\n\n\tfor (const line of lines) {\n\t\tif (!line.trim()) continue;\n\t\ttry {\n\t\t\tconst entry = JSON.parse(line) as FileEntry;\n\t\t\tentries.push(entry);\n\t\t} catch {\n\t\t\t// Skip malformed lines.\n\t\t}\n\t}\n\n\treturn entries;\n}\n"]}

package/dist/core/session/remote-session-client.d.ts

@@ -0,0 +1,83 @@
+import type { FileEntry, SessionInfo } from "./types.ts";
+export type RemoteSessionInfo = Omit<SessionInfo, "path" | "created" | "modified"> & {
+    path?: string;
+    created: Date | string;
+    modified: Date | string;
+};
+export interface RemoteSessionClientOptions {
+    baseUrl: string;
+    token: string;
+    fetch?: typeof fetch;
+}
+export interface RemoteSessionSnapshot {
+    reference: string;
+    id: string;
+    version?: number;
+    entries: FileEntry[];
+    etag?: string;
+}
+export interface CreateRemoteSessionRequest {
+    id?: string;
+    cwd: string;
+    projectId?: string;
+    parentSession?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AppendRemoteSessionEntriesRequest {
+    baseEtag?: string;
+    entries: FileEntry[];
+}
+export interface AppendRemoteSessionEntriesResponse {
+    etag?: string;
+    accepted: number;
+}
+export interface ReplaceRemoteSessionSnapshotRequest {
+    baseEtag?: string;
+    entries: FileEntry[];
+}
+export interface ReplaceRemoteSessionSnapshotResponse {
+    etag?: string;
+}
+export interface ForkRemoteSessionRequest {
+    cwd: string;
+    projectId?: string;
+    leafId?: string;
+}
+export interface ImportRemoteSessionJsonlRequest {
+    cwd: string;
+    projectId?: string;
+    sourceName?: string;
+    entries: FileEntry[];
+    metadata?: Record<string, unknown>;
+}
+export interface ListRemoteSessionsResponse {
+    sessions: RemoteSessionInfo[];
+}
+export type RemoteSessionOperation = "create" | "open" | "recent" | "fork" | "import" | "list" | "append" | "replace";
+export declare class RemoteSessionClientError extends Error {
+    readonly status: number;
+    readonly responseText: string;
+    constructor(status: number, responseText: string);
+}
+export declare class RemoteSessionProtocolError extends Error {
+    readonly operation: RemoteSessionOperation;
+    constructor(operation: RemoteSessionOperation, message: string, cause?: unknown);
+}
+export declare class RemoteSessionClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly fetchImpl;
+    constructor(options: RemoteSessionClientOptions);
+    createSession(request: CreateRemoteSessionRequest): Promise<RemoteSessionSnapshot>;
+    openSession(sessionIdOrReference: string): Promise<RemoteSessionSnapshot>;
+    appendEntries(sessionIdOrReference: string, request: AppendRemoteSessionEntriesRequest): Promise<AppendRemoteSessionEntriesResponse>;
+    replaceSnapshot(sessionIdOrReference: string, request: ReplaceRemoteSessionSnapshotRequest): Promise<ReplaceRemoteSessionSnapshotResponse>;
+    listSessions(): Promise<ListRemoteSessionsResponse>;
+    getRecentSession(): Promise<RemoteSessionSnapshot>;
+    forkSession(sessionIdOrReference: string, request: ForkRemoteSessionRequest): Promise<RemoteSessionSnapshot>;
+    importJsonl(request: ImportRemoteSessionJsonlRequest): Promise<RemoteSessionSnapshot>;
+    private request;
+}
+export declare function parseRemoteSessionId(reference: string): string;
+export declare function formatRemoteSessionReference(sessionId: string): string;
+//# sourceMappingURL=remote-session-client.d.ts.map

package/dist/core/session/remote-session-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-session-client.d.ts","sourceRoot":"","sources":["../../../src/core/session/remote-session-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { validateSessionId } from \"./ids.ts\";\nimport type { FileEntry, SessionInfo } from \"./types.ts\";\n\nexport type RemoteSessionInfo = Omit<SessionInfo, \"path\" | \"created\" | \"modified\"> & {\n\tpath?: string;\n\tcreated: Date | string;\n\tmodified: Date | string;\n};\n\nexport interface RemoteSessionClientOptions {\n\tbaseUrl: string;\n\ttoken: string;\n\tfetch?: typeof fetch;\n}\n\nexport interface RemoteSessionSnapshot {\n\treference: string;\n\tid: string;\n\tversion?: number;\n\tentries: FileEntry[];\n\tetag?: string;\n}\n\nexport interface CreateRemoteSessionRequest {\n\tid?: string;\n\tcwd: string;\n\tprojectId?: string;\n\tparentSession?: string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface AppendRemoteSessionEntriesRequest {\n\tbaseEtag?: string;\n\tentries: FileEntry[];\n}\n\nexport interface AppendRemoteSessionEntriesResponse {\n\tetag?: string;\n\taccepted: number;\n}\n\n// grip-ignore noNearIdenticalDataStructures: Snapshot replacement atomically rewrites complete state, while append applies incremental entries; their endpoint validation and concurrency contracts evolve independently.\nexport interface ReplaceRemoteSessionSnapshotRequest {\n\tbaseEtag?: string;\n\tentries: FileEntry[];\n}\n\nexport interface ReplaceRemoteSessionSnapshotResponse {\n\tetag?: string;\n}\n\nexport interface ForkRemoteSessionRequest {\n\tcwd: string;\n\tprojectId?: string;\n\tleafId?: string;\n}\n\nexport interface ImportRemoteSessionJsonlRequest {\n\tcwd: string;\n\tprojectId?: string;\n\tsourceName?: string;\n\tentries: FileEntry[];\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface ListRemoteSessionsResponse {\n\tsessions: RemoteSessionInfo[];\n}\n\nexport type RemoteSessionOperation = \"create\" | \"open\" | \"recent\" | \"fork\" | \"import\" | \"list\" | \"append\" | \"replace\";\n\nexport class RemoteSessionClientError extends Error {\n\treadonly status: number;\n\treadonly responseText: string;\n\n\tconstructor(status: number, responseText: string) {\n\t\tsuper(`Remote session request failed with status ${status}: ${responseText}`);\n\t\tthis.name = \"RemoteSessionClientError\";\n\t\tthis.status = status;\n\t\tthis.responseText = responseText;\n\t}\n}\n\nexport class RemoteSessionProtocolError extends Error {\n\treadonly operation: RemoteSessionOperation;\n\n\tconstructor(operation: RemoteSessionOperation, message: string, cause?: unknown) {\n\t\tsuper(`Invalid remote session ${operation} response: ${message}`, { cause });\n\t\tthis.name = \"RemoteSessionProtocolError\";\n\t\tthis.operation = operation;\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction requiredString(record: Record<string, unknown>, key: string, operation: RemoteSessionOperation): string {\n\tconst value = record[key];\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a non-empty string`);\n\t}\n\treturn value;\n}\n\nfunction stringValue(record: Record<string, unknown>, key: string, operation: RemoteSessionOperation): string {\n\tconst value = record[key];\n\tif (typeof value !== \"string\") {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a string`);\n\t}\n\treturn value;\n}\n\nfunction requiredSessionId(record: Record<string, unknown>, operation: RemoteSessionOperation): string {\n\tconst id = requiredString(record, \"id\", operation);\n\ttry {\n\t\tvalidateSessionId(id);\n\t} catch (error) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"id is not a valid session id\", error);\n\t}\n\treturn id;\n}\n\nfunction optionalString(\n\trecord: Record<string, unknown>,\n\tkey: string,\n\toperation: RemoteSessionOperation,\n): string | undefined {\n\tconst value = record[key];\n\tif (value === undefined) return undefined;\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, `${key} must be a non-empty string when present`);\n\t}\n\treturn value;\n}\n\nfunction decodeSnapshot(value: unknown, operation: RemoteSessionOperation, expectedId?: string): RemoteSessionSnapshot {\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"snapshot must be an object\");\n\tconst id = requiredSessionId(value, operation);\n\tconst reference = requiredString(value, \"reference\", operation);\n\tif (parseRemoteSessionId(reference) !== id) {\n\t\tthrow new RemoteSessionProtocolError(operation, `reference ${reference} does not identify snapshot id ${id}`);\n\t}\n\tif (expectedId !== undefined && id !== expectedId) {\n\t\tthrow new RemoteSessionProtocolError(operation, `snapshot id ${id} does not match requested id ${expectedId}`);\n\t}\n\tif (!Array.isArray(value.entries) || value.entries.length === 0 || value.entries.some((entry) => !isRecord(entry))) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"entries must be a non-empty array of objects\");\n\t}\n\tconst header = value.entries[0];\n\tif (\n\t\t!isRecord(header) ||\n\t\theader.type !== \"session\" ||\n\t\theader.id !== id ||\n\t\ttypeof header.cwd !== \"string\" ||\n\t\ttypeof header.timestamp !== \"string\"\n\t) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"entries must begin with a matching session header\");\n\t}\n\tconst version = value.version;\n\tif (\n\t\tversion !== undefined &&\n\t\t(typeof version !== \"number\" || !Number.isInteger(version) || version < 1 || version !== header.version)\n\t) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"version must be a positive integer matching the session header\");\n\t}\n\treturn {\n\t\treference,\n\t\tid,\n\t\tversion: version as number | undefined,\n\t\tentries: value.entries as FileEntry[],\n\t\tetag: optionalString(value, \"etag\", operation),\n\t};\n}\n\nfunction decodeForkSnapshot(value: unknown, sourceId: string): RemoteSessionSnapshot {\n\tconst snapshot = decodeSnapshot(value, \"fork\");\n\tif (snapshot.id === sourceId) {\n\t\tthrow new RemoteSessionProtocolError(\"fork\", \"fork snapshot must have a new session id\");\n\t}\n\tconst header = snapshot.entries[0];\n\tif (header?.type !== \"session\" || !header.parentSession || parseRemoteSessionId(header.parentSession) !== sourceId) {\n\t\tthrow new RemoteSessionProtocolError(\"fork\", `fork header must reference source session ${sourceId}`);\n\t}\n\treturn snapshot;\n}\n\nfunction decodeAppendResponse(value: unknown): AppendRemoteSessionEntriesResponse {\n\tconst operation = \"append\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"response must be an object\");\n\tif (!Number.isInteger(value.accepted)) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"accepted must be an integer\");\n\t}\n\treturn { accepted: value.accepted as number, etag: optionalString(value, \"etag\", operation) };\n}\n\nfunction decodeReplaceResponse(value: unknown): ReplaceRemoteSessionSnapshotResponse {\n\tconst operation = \"replace\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"response must be an object\");\n\treturn { etag: optionalString(value, \"etag\", operation) };\n}\n\nfunction decodeSessionInfo(value: unknown): RemoteSessionInfo {\n\tconst operation = \"list\";\n\tif (!isRecord(value)) throw new RemoteSessionProtocolError(operation, \"each session must be an object\");\n\tconst id = requiredSessionId(value, operation);\n\tconst reference = optionalString(value, \"reference\", operation);\n\tconst path = optionalString(value, \"path\", operation);\n\tfor (const candidate of [reference, path]) {\n\t\tif (candidate !== undefined && parseRemoteSessionId(candidate) !== id) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, `reference ${candidate} does not identify session id ${id}`);\n\t\t}\n\t}\n\tconst created = requiredString(value, \"created\", operation);\n\tconst modified = requiredString(value, \"modified\", operation);\n\tif (!Number.isFinite(Date.parse(created)) || !Number.isFinite(Date.parse(modified))) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"created and modified must be valid date strings\");\n\t}\n\tif (!Number.isInteger(value.messageCount) || (value.messageCount as number) < 0) {\n\t\tthrow new RemoteSessionProtocolError(operation, \"messageCount must be a non-negative integer\");\n\t}\n\treturn {\n\t\treference,\n\t\tpath,\n\t\tid,\n\t\tcwd: stringValue(value, \"cwd\", operation),\n\t\tname: optionalString(value, \"name\", operation),\n\t\tparentSessionPath: optionalString(value, \"parentSessionPath\", operation),\n\t\tcreated,\n\t\tmodified,\n\t\tmessageCount: value.messageCount as number,\n\t\tfirstMessage: stringValue(value, \"firstMessage\", operation),\n\t\tallMessagesText: stringValue(value, \"allMessagesText\", operation),\n\t};\n}\n\nfunction decodeListResponse(value: unknown): ListRemoteSessionsResponse {\n\tif (!isRecord(value) || !Array.isArray(value.sessions)) {\n\t\tthrow new RemoteSessionProtocolError(\"list\", \"sessions must be an array\");\n\t}\n\treturn { sessions: value.sessions.map((session) => decodeSessionInfo(session)) };\n}\n\nexport class RemoteSessionClient {\n\tprivate readonly baseUrl: string;\n\tprivate readonly token: string;\n\tprivate readonly fetchImpl: typeof fetch;\n\n\tconstructor(options: RemoteSessionClientOptions) {\n\t\tthis.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n\t\tthis.token = options.token;\n\t\tthis.fetchImpl = options.fetch ?? fetch;\n\t}\n\n\tcreateSession(request: CreateRemoteSessionRequest): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"POST\", \"/v1/sessions\", request, \"create\", (value) =>\n\t\t\tdecodeSnapshot(value, \"create\", request.id),\n\t\t);\n\t}\n\n\topenSession(sessionIdOrReference: string): Promise<RemoteSessionSnapshot> {\n\t\tconst id = parseRemoteSessionId(sessionIdOrReference);\n\t\treturn this.request(\"GET\", `/v1/sessions/${encodeURIComponent(id)}`, undefined, \"open\", (value) =>\n\t\t\tdecodeSnapshot(value, \"open\", id),\n\t\t);\n\t}\n\n\tappendEntries(\n\t\tsessionIdOrReference: string,\n\t\trequest: AppendRemoteSessionEntriesRequest,\n\t): Promise<AppendRemoteSessionEntriesResponse> {\n\t\treturn this.request(\n\t\t\t\"POST\",\n\t\t\t`/v1/sessions/${encodeURIComponent(parseRemoteSessionId(sessionIdOrReference))}/entries`,\n\t\t\trequest,\n\t\t\t\"append\",\n\t\t\tdecodeAppendResponse,\n\t\t);\n\t}\n\n\treplaceSnapshot(\n\t\tsessionIdOrReference: string,\n\t\trequest: ReplaceRemoteSessionSnapshotRequest,\n\t): Promise<ReplaceRemoteSessionSnapshotResponse> {\n\t\treturn this.request(\n\t\t\t\"PUT\",\n\t\t\t`/v1/sessions/${encodeURIComponent(parseRemoteSessionId(sessionIdOrReference))}/snapshot`,\n\t\t\trequest,\n\t\t\t\"replace\",\n\t\t\tdecodeReplaceResponse,\n\t\t);\n\t}\n\n\tlistSessions(): Promise<ListRemoteSessionsResponse> {\n\t\treturn this.request(\"GET\", \"/v1/sessions\", undefined, \"list\", decodeListResponse);\n\t}\n\n\tgetRecentSession(): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"GET\", \"/v1/sessions/recent\", undefined, \"recent\", (value) =>\n\t\t\tdecodeSnapshot(value, \"recent\"),\n\t\t);\n\t}\n\n\tforkSession(sessionIdOrReference: string, request: ForkRemoteSessionRequest): Promise<RemoteSessionSnapshot> {\n\t\tconst sourceId = parseRemoteSessionId(sessionIdOrReference);\n\t\treturn this.request(\"POST\", `/v1/sessions/${encodeURIComponent(sourceId)}/fork`, request, \"fork\", (value) =>\n\t\t\tdecodeForkSnapshot(value, sourceId),\n\t\t);\n\t}\n\n\timportJsonl(request: ImportRemoteSessionJsonlRequest): Promise<RemoteSessionSnapshot> {\n\t\treturn this.request(\"POST\", \"/v1/sessions/import-jsonl\", request, \"import\", (value) =>\n\t\t\tdecodeSnapshot(value, \"import\"),\n\t\t);\n\t}\n\n\tprivate async request<T>(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tbody: unknown,\n\t\toperation: RemoteSessionOperation,\n\t\tdecode: (value: unknown) => T,\n\t): Promise<T> {\n\t\tconst response = await this.fetchImpl(`${this.baseUrl}${path}`, {\n\t\t\tmethod,\n\t\t\theaders: {\n\t\t\t\tAuthorization: `Bearer ${this.token}`,\n\t\t\t\tAccept: \"application/json\",\n\t\t\t\t...(body === undefined ? {} : { \"Content-Type\": \"application/json\" }),\n\t\t\t},\n\t\t\tbody: body === undefined ? undefined : JSON.stringify(body),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow new RemoteSessionClientError(response.status, await response.text());\n\t\t}\n\t\tif (response.status === 204) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, \"response body is required\");\n\t\t}\n\n\t\tlet value: unknown;\n\t\ttry {\n\t\t\tvalue = await response.json();\n\t\t} catch (error) {\n\t\t\tthrow new RemoteSessionProtocolError(operation, \"body is not valid JSON\", error);\n\t\t}\n\t\treturn decode(value);\n\t}\n}\n\nexport function parseRemoteSessionId(reference: string): string {\n\treturn reference.startsWith(\"remote:\") ? reference.slice(\"remote:\".length) : reference;\n}\n\nexport function formatRemoteSessionReference(sessionId: string): string {\n\treturn sessionId.startsWith(\"remote:\") ? sessionId : `remote:${sessionId}`;\n}\n"]}