@bastani/atomic 0.8.31-alpha.5 → 0.9.0-alpha.1

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

@@ -0,0 +1,346 @@
+import { existsSync } from "fs";
+import { resolve } from "path";
+import { normalizePath, resolvePath } from "../utils/paths.js";
+import { createBackupSnapshot, createBranchedSessionState, forkSessionFromFile, } from "./session-manager-archive.js";
+import { createBranchSummaryEntry, createContextCompactionEntry, createContextWindowChangeEntry, createCustomEntry, createCustomMessageEntry, createLabelEntry, getEntriesWithoutHeader, createMessageEntry, createModelChangeEntry, createSessionFilePath, createSessionHeader, createSessionInfoEntry, createThinkingLevelChangeEntry, getLatestSessionName, } from "./session-manager-entries.js";
+import { buildSessionContext, buildSessionIndex, buildSessionTree, getBranchPath } from "./session-manager-history.js";
+import { listAllSessions, listProjectSessions } from "./session-manager-list.js";
+import { migrateToCurrentVersion } from "./session-manager-migrations.js";
+import { getDefaultSessionDir, getDefaultSessionDirPath } from "./session-manager-paths.js";
+import { appendSessionEntries, appendSessionEntry, ensureDirectory, findMostRecentSession, hasAssistantMessage, loadEntriesFromFile, writeSessionEntries, } from "./session-manager-storage.js";
+import { assertValidSessionId, createSessionId } from "./session-manager-validation.js";
+/**
+ * Manages conversation sessions as append-only trees stored in JSONL files.
+ *
+ * Each session entry has an id and parentId forming a tree structure. The "leaf"
+ * pointer tracks the current position. Appending creates a child of the current leaf.
+ * Branching moves the leaf to an earlier entry, allowing new branches without
+ * modifying history.
+ *
+ * Use buildSessionContext() to get the resolved message list for the LLM, which
+ * applies context-deletion filtering and follows the path from root to current leaf.
+ */
+export class SessionManager {
+    constructor(cwd, sessionDir, sessionFile, persist, newSessionOptions) {
+        this.sessionId = "";
+        this.flushed = false;
+        this.fileEntries = [];
+        this.byId = new Map();
+        this.labelsById = new Map();
+        this.labelTimestampsById = new Map();
+        this.leafId = null;
+        this.cwd = resolvePath(cwd);
+        this.sessionDir = normalizePath(sessionDir);
+        this.persist = persist;
+        if (persist && this.sessionDir) {
+            ensureDirectory(this.sessionDir);
+        }
+        if (sessionFile) {
+            this.setSessionFile(sessionFile);
+        }
+        else {
+            this.newSession(newSessionOptions);
+        }
+    }
+    /** Switch to a different session file (used for resume and branching) */
+    setSessionFile(sessionFile) {
+        this.sessionFile = resolvePath(sessionFile);
+        if (existsSync(this.sessionFile)) {
+            this.fileEntries = loadEntriesFromFile(this.sessionFile);
+            // If file was empty or corrupted (no valid header), truncate and start fresh
+            // to avoid appending messages without a session header (which breaks the session)
+            if (this.fileEntries.length === 0) {
+                const explicitPath = this.sessionFile;
+                this.newSession();
+                this.sessionFile = explicitPath;
+                this._rewriteFile();
+                this.flushed = true;
+                return;
+            }
+            const header = this.fileEntries.find((entry) => entry.type === "session");
+            this.sessionId = header?.id ?? createSessionId();
+            if (migrateToCurrentVersion(this.fileEntries)) {
+                this._rewriteFile();
+            }
+            this._buildIndex();
+            this.flushed = true;
+        }
+        else {
+            const explicitPath = this.sessionFile;
+            this.newSession();
+            this.sessionFile = explicitPath; // preserve explicit path from --session flag
+        }
+    }
+    newSession(options) {
+        if (options?.id !== undefined) {
+            assertValidSessionId(options.id);
+        }
+        this.sessionId = options?.id ?? createSessionId();
+        const timestamp = new Date().toISOString();
+        const header = createSessionHeader(this.sessionId, this.cwd, timestamp, options?.parentSession);
+        this.fileEntries = [header];
+        this.byId.clear();
+        this.labelsById.clear();
+        this.leafId = null;
+        this.flushed = false;
+        if (this.persist) {
+            this.sessionFile = createSessionFilePath(this.getSessionDir(), timestamp, this.sessionId);
+        }
+        return this.sessionFile;
+    }
+    _buildIndex() {
+        const index = buildSessionIndex(this.fileEntries);
+        this.byId = index.byId;
+        this.labelsById = index.labelsById;
+        this.labelTimestampsById = index.labelTimestampsById;
+        this.leafId = index.leafId;
+    }
+    _rewriteFile() {
+        if (!this.persist || !this.sessionFile)
+            return;
+        writeSessionEntries(this.sessionFile, this.fileEntries);
+    }
+    isPersisted() {
+        return this.persist;
+    }
+    getCwd() {
+        return this.cwd;
+    }
+    getSessionDir() {
+        return this.sessionDir;
+    }
+    usesDefaultSessionDir() {
+        return this.sessionDir === getDefaultSessionDirPath(this.cwd);
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+    getSessionFile() {
+        return this.sessionFile;
+    }
+    _persist(entry) {
+        if (!this.persist || !this.sessionFile)
+            return;
+        if (!hasAssistantMessage(this.fileEntries)) {
+            // Mark as not flushed so when assistant arrives, all entries get written
+            this.flushed = false;
+            return;
+        }
+        if (!this.flushed) {
+            appendSessionEntries(this.sessionFile, this.fileEntries);
+            this.flushed = true;
+        }
+        else {
+            appendSessionEntry(this.sessionFile, entry);
+        }
+    }
+    _appendEntry(entry) {
+        this.fileEntries.push(entry);
+        this.byId.set(entry.id, entry);
+        this.leafId = entry.id;
+        this._persist(entry);
+    }
+    /** Append a message as child of current leaf, then advance leaf. Returns entry id. */
+    appendMessage(message) {
+        const entry = createMessageEntry(message, this.byId, this.leafId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    /** Append a thinking level change as child of current leaf, then advance leaf. Returns entry id. */
+    appendThinkingLevelChange(thinkingLevel) {
+        const entry = createThinkingLevelChangeEntry(thinkingLevel, this.byId, this.leafId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    /** Append a context window change as child of current leaf, then advance leaf. Returns entry id. */
+    appendContextWindowChange(contextWindow) {
+        const entry = createContextWindowChangeEntry(contextWindow, this.byId, this.leafId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    /** Append a model change as child of current leaf, then advance leaf. Returns entry id. */
+    appendModelChange(provider, modelId) {
+        const entry = createModelChangeEntry(provider, modelId, this.byId, this.leafId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    /** Append logical deletion metadata for deletion-only context compaction. */
+    appendContextCompaction(deletedTargets, protectedEntryIds, stats, backupPath) {
+        const entry = createContextCompactionEntry(deletedTargets, protectedEntryIds, stats, backupPath, this.byId, this.leafId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    /** Write a recoverable snapshot of the current session entries without mutating the active JSONL. */
+    writeBackupSnapshot(label = "compact") {
+        if (!this.persist)
+            return undefined;
+        return createBackupSnapshot(this.sessionFile, this.fileEntries, label);
+    }
+    /** Append a custom entry (for extensions) as child of current leaf, then advance leaf. Returns entry id. */
+    appendCustomEntry(customType, data) {
+        const entry = createCustomEntry(customType, data, this.byId, this.leafId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    /** Append a session info entry (e.g., display name). Returns entry id. */
+    appendSessionInfo(name) {
+        const entry = createSessionInfoEntry(name, this.byId, this.leafId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    /** Get the current session name from the latest session_info entry, if any. */
+    getSessionName() {
+        return getLatestSessionName(this.getEntries());
+    }
+    /** Append a custom message entry (for extensions) that participates in LLM context unless excluded. */
+    appendCustomMessageEntry(customType, content, display, details, excludeFromContext) {
+        const entry = createCustomMessageEntry(customType, content, display, details, excludeFromContext, this.byId, this.leafId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    getLeafId() {
+        return this.leafId;
+    }
+    getLeafEntry() {
+        return this.leafId ? this.byId.get(this.leafId) : undefined;
+    }
+    getEntry(id) {
+        return this.byId.get(id);
+    }
+    /** Get all direct children of an entry. */
+    getChildren(parentId) {
+        const children = [];
+        for (const entry of this.byId.values()) {
+            if (entry.parentId === parentId) {
+                children.push(entry);
+            }
+        }
+        return children;
+    }
+    /** Get the label for an entry, if any. */
+    getLabel(id) {
+        return this.labelsById.get(id);
+    }
+    /** Set or clear a label on an entry. */
+    appendLabelChange(targetId, label) {
+        if (!this.byId.has(targetId)) {
+            throw new Error(`Entry ${targetId} not found`);
+        }
+        const entry = createLabelEntry(targetId, label, this.byId, this.leafId);
+        this._appendEntry(entry);
+        if (label) {
+            this.labelsById.set(targetId, label);
+            this.labelTimestampsById.set(targetId, entry.timestamp);
+        }
+        else {
+            this.labelsById.delete(targetId);
+            this.labelTimestampsById.delete(targetId);
+        }
+        return entry.id;
+    }
+    /** Walk from entry to root, returning all entries in path order. */
+    getBranch(fromId) {
+        return getBranchPath(fromId ?? this.leafId, this.byId);
+    }
+    /** Build the session context (what gets sent to the LLM). */
+    buildSessionContext() {
+        return buildSessionContext(this.getEntries(), this.leafId, this.byId);
+    }
+    /** Get session header. */
+    getHeader() {
+        const header = this.fileEntries.find((entry) => entry.type === "session");
+        return header ? header : null;
+    }
+    /** Get all session entries (excludes header). Returns a shallow copy. */
+    getEntries() {
+        return getEntriesWithoutHeader(this.fileEntries);
+    }
+    /** Get the session as a tree structure. Returns a shallow defensive copy of all entries. */
+    getTree() {
+        return buildSessionTree(this.getEntries(), this.labelsById, this.labelTimestampsById);
+    }
+    /** Start a new branch from an earlier entry. */
+    branch(branchFromId) {
+        if (!this.byId.has(branchFromId)) {
+            throw new Error(`Entry ${branchFromId} not found`);
+        }
+        this.leafId = branchFromId;
+    }
+    /** Reset the leaf pointer to null (before any entries). */
+    resetLeaf() {
+        this.leafId = null;
+    }
+    /** Start a new branch with a summary of the abandoned path. */
+    branchWithSummary(branchFromId, summary, details, fromHook) {
+        if (branchFromId !== null && !this.byId.has(branchFromId)) {
+            throw new Error(`Entry ${branchFromId} not found`);
+        }
+        this.leafId = branchFromId;
+        const entry = createBranchSummaryEntry(branchFromId, summary, details, fromHook, this.byId);
+        this._appendEntry(entry);
+        return entry.id;
+    }
+    /** Create a new session file containing only the path from root to the specified leaf. */
+    createBranchedSession(leafId) {
+        const result = createBranchedSessionState({
+            leafId,
+            persist: this.persist,
+            sessionDir: this.getSessionDir(),
+            cwd: this.cwd,
+            previousSessionFile: this.sessionFile,
+            path: this.getBranch(leafId),
+            labelsById: this.labelsById,
+            labelTimestampsById: this.labelTimestampsById,
+        });
+        this.fileEntries = result.fileEntries;
+        this.sessionId = result.sessionId;
+        if (result.sessionFile)
+            this.sessionFile = result.sessionFile;
+        this._buildIndex();
+        if (this.persist) {
+            if (result.shouldRewriteFile)
+                this._rewriteFile();
+            this.flushed = result.flushed ?? false;
+            return result.sessionFile;
+        }
+        return undefined;
+    }
+    /** Create a new session. */
+    static create(cwd, sessionDir, options) {
+        const dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);
+        return new SessionManager(cwd, dir, undefined, true, options);
+    }
+    /** Open a specific session file. */
+    static open(path, sessionDir, cwdOverride) {
+        const resolvedPath = resolvePath(path);
+        const entries = loadEntriesFromFile(resolvedPath);
+        const header = entries.find((entry) => entry.type === "session");
+        const cwd = cwdOverride ?? header?.cwd ?? process.cwd();
+        const dir = sessionDir ? normalizePath(sessionDir) : resolve(resolvedPath, "..");
+        return new SessionManager(cwd, dir, resolvedPath, true);
+    }
+    /** Continue the most recent session, or create new if none. */
+    static continueRecent(cwd, sessionDir) {
+        const dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);
+        const filterCwd = sessionDir !== undefined && dir !== getDefaultSessionDirPath(cwd);
+        const mostRecent = findMostRecentSession(dir, filterCwd ? cwd : undefined);
+        return new SessionManager(cwd, dir, mostRecent ?? undefined, true);
+    }
+    /** Create an in-memory session (no file persistence) */
+    static inMemory(cwd = process.cwd()) {
+        return new SessionManager(cwd, "", undefined, false);
+    }
+    /** Fork a session from another project directory into the current project. */
+    static forkFrom(sourcePath, targetCwd, sessionDir, options) {
+        const forked = forkSessionFromFile(sourcePath, targetCwd, sessionDir, options);
+        return new SessionManager(forked.cwd, forked.sessionDir, forked.sessionFile, true);
+    }
+    /** List all sessions for a directory. */
+    static async list(cwd, sessionDir, onProgress) {
+        return listProjectSessions(cwd, sessionDir, onProgress);
+    }
+    static async listAll(sessionDirOrOnProgress, onProgress) {
+        return listAllSessions(sessionDirOrOnProgress, onProgress);
+    }
+}
+//# sourceMappingURL=session-manager-core.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager-core.js","sourceRoot":"","sources":["../../src/core/session-manager-core.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ImageContent, Message, TextContent } from \"@earendil-works/pi-ai\";\nimport { existsSync } from \"fs\";\nimport { resolve } from \"path\";\nimport { normalizePath, resolvePath } from \"../utils/paths.ts\";\nimport type { BashExecutionMessage, CustomMessage } from \"./messages.ts\";\nimport {\n\tcreateBackupSnapshot,\n\tcreateBranchedSessionState,\n\tforkSessionFromFile,\n} from \"./session-manager-archive.ts\";\nimport {\n\tcreateBranchSummaryEntry,\n\tcreateContextCompactionEntry,\n\tcreateContextWindowChangeEntry,\n\tcreateCustomEntry,\n\tcreateCustomMessageEntry,\n\tcreateLabelEntry,\n\tgetEntriesWithoutHeader,\n\tcreateMessageEntry,\n\tcreateModelChangeEntry,\n\tcreateSessionFilePath,\n\tcreateSessionHeader,\n\tcreateSessionInfoEntry,\n\tcreateThinkingLevelChangeEntry,\n\tgetLatestSessionName,\n} from \"./session-manager-entries.ts\";\nimport { buildSessionContext, buildSessionIndex, buildSessionTree, getBranchPath } from \"./session-manager-history.ts\";\nimport { listAllSessions, listProjectSessions } from \"./session-manager-list.ts\";\nimport { migrateToCurrentVersion } from \"./session-manager-migrations.ts\";\nimport { getDefaultSessionDir, getDefaultSessionDirPath } from \"./session-manager-paths.ts\";\nimport {\n\tappendSessionEntries,\n\tappendSessionEntry,\n\tensureDirectory,\n\tfindMostRecentSession,\n\thasAssistantMessage,\n\tloadEntriesFromFile,\n\twriteSessionEntries,\n} from \"./session-manager-storage.ts\";\nimport type {\n\tBranchSummaryEntry,\n\tContextCompactionStats,\n\tContextDeletionTarget,\n\tFileEntry,\n\tNewSessionOptions,\n\tSessionContext,\n\tSessionEntry,\n\tSessionHeader,\n\tSessionInfo,\n\tSessionListProgress,\n\tSessionTreeNode,\n} from \"./session-manager-types.ts\";\nimport { assertValidSessionId, createSessionId } from \"./session-manager-validation.ts\";\n\n/**\n * Manages conversation sessions as append-only trees stored in JSONL files.\n *\n * Each session entry has an id and parentId forming a tree structure. The \"leaf\"\n * pointer tracks the current position. Appending creates a child of the current leaf.\n * Branching moves the leaf to an earlier entry, allowing new branches without\n * modifying history.\n *\n * Use buildSessionContext() to get the resolved message list for the LLM, which\n * applies context-deletion filtering and follows the path from root to current leaf.\n */\nexport class SessionManager {\n\tprivate sessionId: string = \"\";\n\tprivate sessionFile: string | undefined;\n\tprivate sessionDir: string;\n\tprivate cwd: string;\n\tprivate persist: boolean;\n\tprivate flushed: boolean = false;\n\tprivate fileEntries: FileEntry[] = [];\n\tprivate byId: Map<string, SessionEntry> = new Map();\n\tprivate labelsById: Map<string, string> = new Map();\n\tprivate labelTimestampsById: Map<string, string> = new Map();\n\tprivate leafId: string | null = null;\n\n\tprivate constructor(\n\t\tcwd: string,\n\t\tsessionDir: string,\n\t\tsessionFile: string | undefined,\n\t\tpersist: boolean,\n\t\tnewSessionOptions?: NewSessionOptions,\n\t) {\n\t\tthis.cwd = resolvePath(cwd);\n\t\tthis.sessionDir = normalizePath(sessionDir);\n\t\tthis.persist = persist;\n\t\tif (persist && this.sessionDir) {\n\t\t\tensureDirectory(this.sessionDir);\n\t\t}\n\n\t\tif (sessionFile) {\n\t\t\tthis.setSessionFile(sessionFile);\n\t\t} else {\n\t\t\tthis.newSession(newSessionOptions);\n\t\t}\n\t}\n\n\t/** Switch to a different session file (used for resume and branching) */\n\tsetSessionFile(sessionFile: string): void {\n\t\tthis.sessionFile = resolvePath(sessionFile);\n\t\tif (existsSync(this.sessionFile)) {\n\t\t\tthis.fileEntries = loadEntriesFromFile(this.sessionFile);\n\n\t\t\t// If file was empty or corrupted (no valid header), truncate and start fresh\n\t\t\t// to avoid appending messages without a session header (which breaks the session)\n\t\t\tif (this.fileEntries.length === 0) {\n\t\t\t\tconst explicitPath = this.sessionFile;\n\t\t\t\tthis.newSession();\n\t\t\t\tthis.sessionFile = explicitPath;\n\t\t\t\tthis._rewriteFile();\n\t\t\t\tthis.flushed = true;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst header = this.fileEntries.find((entry) => entry.type === \"session\") as SessionHeader | undefined;\n\t\t\tthis.sessionId = header?.id ?? createSessionId();\n\n\t\t\tif (migrateToCurrentVersion(this.fileEntries)) {\n\t\t\t\tthis._rewriteFile();\n\t\t\t}\n\n\t\t\tthis._buildIndex();\n\t\t\tthis.flushed = true;\n\t\t} else {\n\t\t\tconst explicitPath = this.sessionFile;\n\t\t\tthis.newSession();\n\t\t\tthis.sessionFile = explicitPath; // preserve explicit path from --session flag\n\t\t}\n\t}\n\n\tnewSession(options?: NewSessionOptions): string | undefined {\n\t\tif (options?.id !== undefined) {\n\t\t\tassertValidSessionId(options.id);\n\t\t}\n\t\tthis.sessionId = options?.id ?? createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst header = createSessionHeader(this.sessionId, this.cwd, timestamp, options?.parentSession);\n\t\tthis.fileEntries = [header];\n\t\tthis.byId.clear();\n\t\tthis.labelsById.clear();\n\t\tthis.leafId = null;\n\t\tthis.flushed = false;\n\n\t\tif (this.persist) {\n\t\t\tthis.sessionFile = createSessionFilePath(this.getSessionDir(), timestamp, this.sessionId);\n\t\t}\n\t\treturn this.sessionFile;\n\t}\n\n\tprivate _buildIndex(): void {\n\t\tconst index = buildSessionIndex(this.fileEntries);\n\t\tthis.byId = index.byId;\n\t\tthis.labelsById = index.labelsById;\n\t\tthis.labelTimestampsById = index.labelTimestampsById;\n\t\tthis.leafId = index.leafId;\n\t}\n\n\tprivate _rewriteFile(): void {\n\t\tif (!this.persist || !this.sessionFile) return;\n\t\twriteSessionEntries(this.sessionFile, this.fileEntries);\n\t}\n\n\tisPersisted(): boolean {\n\t\treturn this.persist;\n\t}\n\n\tgetCwd(): string {\n\t\treturn this.cwd;\n\t}\n\n\tgetSessionDir(): string {\n\t\treturn this.sessionDir;\n\t}\n\n\tusesDefaultSessionDir(): boolean {\n\t\treturn this.sessionDir === getDefaultSessionDirPath(this.cwd);\n\t}\n\n\tgetSessionId(): string {\n\t\treturn this.sessionId;\n\t}\n\n\tgetSessionFile(): string | undefined {\n\t\treturn this.sessionFile;\n\t}\n\n\t_persist(entry: SessionEntry): void {\n\t\tif (!this.persist || !this.sessionFile) return;\n\n\t\tif (!hasAssistantMessage(this.fileEntries)) {\n\t\t\t// Mark as not flushed so when assistant arrives, all entries get written\n\t\t\tthis.flushed = false;\n\t\t\treturn;\n\t\t}\n\n\t\tif (!this.flushed) {\n\t\t\tappendSessionEntries(this.sessionFile, this.fileEntries);\n\t\t\tthis.flushed = true;\n\t\t} else {\n\t\t\tappendSessionEntry(this.sessionFile, entry);\n\t\t}\n\t}\n\n\tprivate _appendEntry(entry: SessionEntry): void {\n\t\tthis.fileEntries.push(entry);\n\t\tthis.byId.set(entry.id, entry);\n\t\tthis.leafId = entry.id;\n\t\tthis._persist(entry);\n\t}\n\n\t/** Append a message as child of current leaf, then advance leaf. Returns entry id. */\n\tappendMessage(message: Message | CustomMessage | BashExecutionMessage): string {\n\t\tconst entry = createMessageEntry(message, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/** Append a thinking level change as child of current leaf, then advance leaf. Returns entry id. */\n\tappendThinkingLevelChange(thinkingLevel: string): string {\n\t\tconst entry = createThinkingLevelChangeEntry(thinkingLevel, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/** Append a context window change as child of current leaf, then advance leaf. Returns entry id. */\n\tappendContextWindowChange(contextWindow: number): string {\n\t\tconst entry = createContextWindowChangeEntry(contextWindow, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/** Append a model change as child of current leaf, then advance leaf. Returns entry id. */\n\tappendModelChange(provider: string, modelId: string): string {\n\t\tconst entry = createModelChangeEntry(provider, modelId, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/** Append logical deletion metadata for deletion-only context compaction. */\n\tappendContextCompaction(\n\t\tdeletedTargets: ContextDeletionTarget[],\n\t\tprotectedEntryIds: string[],\n\t\tstats: ContextCompactionStats,\n\t\tbackupPath?: string,\n\t): string {\n\t\tconst entry = createContextCompactionEntry(deletedTargets, protectedEntryIds, stats, backupPath, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/** Write a recoverable snapshot of the current session entries without mutating the active JSONL. */\n\twriteBackupSnapshot(label = \"compact\"): string | undefined {\n\t\tif (!this.persist) return undefined;\n\t\treturn createBackupSnapshot(this.sessionFile, this.fileEntries, label);\n\t}\n\n\t/** Append a custom entry (for extensions) as child of current leaf, then advance leaf. Returns entry id. */\n\tappendCustomEntry(customType: string, data?: unknown): string {\n\t\tconst entry = createCustomEntry(customType, data, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/** Append a session info entry (e.g., display name). Returns entry id. */\n\tappendSessionInfo(name: string): string {\n\t\tconst entry = createSessionInfoEntry(name, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/** Get the current session name from the latest session_info entry, if any. */\n\tgetSessionName(): string | undefined {\n\t\treturn getLatestSessionName(this.getEntries());\n\t}\n\n\t/** Append a custom message entry (for extensions) that participates in LLM context unless excluded. */\n\tappendCustomMessageEntry<T = unknown>(\n\t\tcustomType: string,\n\t\tcontent: string | (TextContent | ImageContent)[],\n\t\tdisplay: boolean,\n\t\tdetails?: T,\n\t\texcludeFromContext?: boolean,\n\t): string {\n\t\tconst entry = createCustomMessageEntry(customType, content, display, details, excludeFromContext, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\tgetLeafId(): string | null {\n\t\treturn this.leafId;\n\t}\n\n\tgetLeafEntry(): SessionEntry | undefined {\n\t\treturn this.leafId ? this.byId.get(this.leafId) : undefined;\n\t}\n\n\tgetEntry(id: string): SessionEntry | undefined {\n\t\treturn this.byId.get(id);\n\t}\n\n\t/** Get all direct children of an entry. */\n\tgetChildren(parentId: string): SessionEntry[] {\n\t\tconst children: SessionEntry[] = [];\n\t\tfor (const entry of this.byId.values()) {\n\t\t\tif (entry.parentId === parentId) {\n\t\t\t\tchildren.push(entry);\n\t\t\t}\n\t\t}\n\t\treturn children;\n\t}\n\n\t/** Get the label for an entry, if any. */\n\tgetLabel(id: string): string | undefined {\n\t\treturn this.labelsById.get(id);\n\t}\n\n\t/** Set or clear a label on an entry. */\n\tappendLabelChange(targetId: string, label: string | undefined): string {\n\t\tif (!this.byId.has(targetId)) {\n\t\t\tthrow new Error(`Entry ${targetId} not found`);\n\t\t}\n\t\tconst entry = createLabelEntry(targetId, label, this.byId, this.leafId);\n\t\tthis._appendEntry(entry);\n\t\tif (label) {\n\t\t\tthis.labelsById.set(targetId, label);\n\t\t\tthis.labelTimestampsById.set(targetId, entry.timestamp);\n\t\t} else {\n\t\t\tthis.labelsById.delete(targetId);\n\t\t\tthis.labelTimestampsById.delete(targetId);\n\t\t}\n\t\treturn entry.id;\n\t}\n\n\t/** Walk from entry to root, returning all entries in path order. */\n\tgetBranch(fromId?: string): SessionEntry[] {\n\t\treturn getBranchPath(fromId ?? this.leafId, this.byId);\n\t}\n\n\t/** Build the session context (what gets sent to the LLM). */\n\tbuildSessionContext(): SessionContext {\n\t\treturn buildSessionContext(this.getEntries(), this.leafId, this.byId);\n\t}\n\n\t/** Get session header. */\n\tgetHeader(): SessionHeader | null {\n\t\tconst header = this.fileEntries.find((entry) => entry.type === \"session\");\n\t\treturn header ? (header as SessionHeader) : null;\n\t}\n\n\t/** Get all session entries (excludes header). Returns a shallow copy. */\n\tgetEntries(): SessionEntry[] {\n\t\treturn getEntriesWithoutHeader(this.fileEntries);\n\t}\n\n\t/** Get the session as a tree structure. Returns a shallow defensive copy of all entries. */\n\tgetTree(): SessionTreeNode[] {\n\t\treturn buildSessionTree(this.getEntries(), this.labelsById, this.labelTimestampsById);\n\t}\n\n\t/** Start a new branch from an earlier entry. */\n\tbranch(branchFromId: string): void {\n\t\tif (!this.byId.has(branchFromId)) {\n\t\t\tthrow new Error(`Entry ${branchFromId} not found`);\n\t\t}\n\t\tthis.leafId = branchFromId;\n\t}\n\n\t/** Reset the leaf pointer to null (before any entries). */\n\tresetLeaf(): void {\n\t\tthis.leafId = null;\n\t}\n\n\t/** Start a new branch with a summary of the abandoned path. */\n\tbranchWithSummary(branchFromId: string | null, summary: string, details?: unknown, fromHook?: boolean): string {\n\t\tif (branchFromId !== null && !this.byId.has(branchFromId)) {\n\t\t\tthrow new Error(`Entry ${branchFromId} not found`);\n\t\t}\n\t\tthis.leafId = branchFromId;\n\t\tconst entry: BranchSummaryEntry = createBranchSummaryEntry(branchFromId, summary, details, fromHook, this.byId);\n\t\tthis._appendEntry(entry);\n\t\treturn entry.id;\n\t}\n\n\t/** Create a new session file containing only the path from root to the specified leaf. */\n\tcreateBranchedSession(leafId: string): string | undefined {\n\t\tconst result = createBranchedSessionState({\n\t\t\tleafId,\n\t\t\tpersist: this.persist,\n\t\t\tsessionDir: this.getSessionDir(),\n\t\t\tcwd: this.cwd,\n\t\t\tpreviousSessionFile: this.sessionFile,\n\t\t\tpath: this.getBranch(leafId),\n\t\t\tlabelsById: this.labelsById,\n\t\t\tlabelTimestampsById: this.labelTimestampsById,\n\t\t});\n\t\tthis.fileEntries = result.fileEntries;\n\t\tthis.sessionId = result.sessionId;\n\t\tif (result.sessionFile) this.sessionFile = result.sessionFile;\n\t\tthis._buildIndex();\n\n\t\tif (this.persist) {\n\t\t\tif (result.shouldRewriteFile) this._rewriteFile();\n\t\t\tthis.flushed = result.flushed ?? false;\n\t\t\treturn result.sessionFile;\n\t\t}\n\t\treturn undefined;\n\t}\n\n\t/** Create a new session. */\n\tstatic create(cwd: string, sessionDir?: string, options?: NewSessionOptions): SessionManager {\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);\n\t\treturn new SessionManager(cwd, dir, undefined, true, options);\n\t}\n\n\t/** Open a specific session file. */\n\tstatic open(path: string, sessionDir?: string, cwdOverride?: string): SessionManager {\n\t\tconst resolvedPath = resolvePath(path);\n\t\tconst entries = loadEntriesFromFile(resolvedPath);\n\t\tconst header = entries.find((entry) => entry.type === \"session\") as SessionHeader | undefined;\n\t\tconst cwd = cwdOverride ?? header?.cwd ?? process.cwd();\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : resolve(resolvedPath, \"..\");\n\t\treturn new SessionManager(cwd, dir, resolvedPath, true);\n\t}\n\n\t/** Continue the most recent session, or create new if none. */\n\tstatic continueRecent(cwd: string, sessionDir?: string): SessionManager {\n\t\tconst dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);\n\t\tconst filterCwd = sessionDir !== undefined && dir !== getDefaultSessionDirPath(cwd);\n\t\tconst mostRecent = findMostRecentSession(dir, filterCwd ? cwd : undefined);\n\t\treturn new SessionManager(cwd, dir, mostRecent ?? undefined, true);\n\t}\n\n\t/** Create an in-memory session (no file persistence) */\n\tstatic inMemory(cwd: string = process.cwd()): SessionManager {\n\t\treturn new SessionManager(cwd, \"\", undefined, false);\n\t}\n\n\t/** Fork a session from another project directory into the current project. */\n\tstatic forkFrom(\n\t\tsourcePath: string,\n\t\ttargetCwd: string,\n\t\tsessionDir?: string,\n\t\toptions?: NewSessionOptions,\n\t): SessionManager {\n\t\tconst forked = forkSessionFromFile(sourcePath, targetCwd, sessionDir, options);\n\t\treturn new SessionManager(forked.cwd, forked.sessionDir, forked.sessionFile, true);\n\t}\n\n\t/** List all sessions for a directory. */\n\tstatic async list(cwd: string, sessionDir?: string, onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\treturn listProjectSessions(cwd, sessionDir, onProgress);\n\t}\n\n\t/** List all sessions across all project directories. */\n\tstatic async listAll(onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tstatic async listAll(sessionDir?: string, onProgress?: SessionListProgress): Promise<SessionInfo[]>;\n\tstatic async listAll(\n\t\tsessionDirOrOnProgress?: string | SessionListProgress,\n\t\tonProgress?: SessionListProgress,\n\t): Promise<SessionInfo[]> {\n\t\treturn listAllSessions(sessionDirOrOnProgress, onProgress);\n\t}\n}\n"]}

package/dist/core/session-manager-entries.d.ts

@@ -0,0 +1,38 @@
+import type { ImageContent, Message, TextContent } from "@earendil-works/pi-ai";
+import type { BashExecutionMessage, CustomMessage } from "./messages.ts";
+import { type BranchSummaryEntry, type ContextCompactionEntry, type ContextCompactionStats, type ContextDeletionTarget, type ContextWindowChangeEntry, type CustomEntry, type CustomMessageEntry, type FileEntry, type LabelEntry, type ModelChangeEntry, type SessionEntry, type SessionHeader, type SessionInfoEntry, type SessionMessageEntry, type ThinkingLevelChangeEntry } from "./session-manager-types.ts";
+export declare function createSessionHeader(id: string, cwd: string, timestamp?: string, parentSession?: string): SessionHeader;
+export declare function createSessionFilePath(sessionDir: string, timestamp: string, sessionId: string): string;
+export declare function createMessageEntry(message: Message | CustomMessage | BashExecutionMessage, byId: {
+    has(id: string): boolean;
+}, parentId: string | null): SessionMessageEntry;
+export declare function createThinkingLevelChangeEntry(thinkingLevel: string, byId: {
+    has(id: string): boolean;
+}, parentId: string | null): ThinkingLevelChangeEntry;
+export declare function createContextWindowChangeEntry(contextWindow: number, byId: {
+    has(id: string): boolean;
+}, parentId: string | null): ContextWindowChangeEntry;
+export declare function createModelChangeEntry(provider: string, modelId: string, byId: {
+    has(id: string): boolean;
+}, parentId: string | null): ModelChangeEntry;
+export declare function createContextCompactionEntry(deletedTargets: ContextDeletionTarget[], protectedEntryIds: string[], stats: ContextCompactionStats, backupPath: string | undefined, byId: {
+    has(id: string): boolean;
+}, parentId: string | null): ContextCompactionEntry;
+export declare function createCustomEntry(customType: string, data: unknown, byId: {
+    has(id: string): boolean;
+}, parentId: string | null): CustomEntry;
+export declare function createSessionInfoEntry(name: string, byId: {
+    has(id: string): boolean;
+}, parentId: string | null): SessionInfoEntry;
+export declare function getLatestSessionName(entries: SessionEntry[]): string | undefined;
+export declare function createCustomMessageEntry<T = unknown>(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: T | undefined, excludeFromContext: boolean | undefined, byId: {
+    has(id: string): boolean;
+}, parentId: string | null): CustomMessageEntry<T>;
+export declare function createLabelEntry(targetId: string, label: string | undefined, byId: {
+    has(id: string): boolean;
+}, parentId: string | null, timestamp?: string): LabelEntry;
+export declare function createBranchSummaryEntry(branchFromId: string | null, summary: string, details: unknown, fromHook: boolean | undefined, byId: {
+    has(id: string): boolean;
+}): BranchSummaryEntry;
+export declare function getEntriesWithoutHeader(fileEntries: FileEntry[]): SessionEntry[];
+//# sourceMappingURL=session-manager-entries.d.ts.map

package/dist/core/session-manager-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager-entries.d.ts","sourceRoot":"","sources":["../../src/core/session-manager-entries.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ImageContent, Message, TextContent } from \"@earendil-works/pi-ai\";\nimport { join } from \"path\";\nimport type { BashExecutionMessage, CustomMessage } from \"./messages.ts\";\nimport {\n\tCURRENT_SESSION_VERSION,\n\ttype BranchSummaryEntry,\n\ttype ContextCompactionEntry,\n\ttype ContextCompactionStats,\n\ttype ContextDeletionTarget,\n\ttype ContextWindowChangeEntry,\n\ttype CustomEntry,\n\ttype CustomMessageEntry,\n\ttype FileEntry,\n\ttype LabelEntry,\n\ttype ModelChangeEntry,\n\ttype SessionEntry,\n\ttype SessionEntryBase,\n\ttype SessionHeader,\n\ttype SessionInfoEntry,\n\ttype SessionMessageEntry,\n\ttype ThinkingLevelChangeEntry,\n} from \"./session-manager-types.ts\";\nimport { generateId } from \"./session-manager-validation.ts\";\n\nfunction entryBase(byId: { has(id: string): boolean }, parentId: string | null): Pick<SessionEntryBase, \"id\" | \"parentId\" | \"timestamp\"> {\n\treturn {\n\t\tid: generateId(byId),\n\t\tparentId,\n\t\ttimestamp: new Date().toISOString(),\n\t};\n}\n\nexport function createSessionHeader(\n\tid: string,\n\tcwd: string,\n\ttimestamp: string = new Date().toISOString(),\n\tparentSession?: string,\n): SessionHeader {\n\treturn {\n\t\ttype: \"session\",\n\t\tversion: CURRENT_SESSION_VERSION,\n\t\tid,\n\t\ttimestamp,\n\t\tcwd,\n\t\tparentSession,\n\t};\n}\n\nexport function createSessionFilePath(sessionDir: string, timestamp: string, sessionId: string): string {\n\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\treturn join(sessionDir, `${fileTimestamp}_${sessionId}.jsonl`);\n}\n\nexport function createMessageEntry(\n\tmessage: Message | CustomMessage | BashExecutionMessage,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): SessionMessageEntry {\n\treturn {\n\t\ttype: \"message\",\n\t\t...entryBase(byId, parentId),\n\t\tmessage,\n\t};\n}\n\nexport function createThinkingLevelChangeEntry(\n\tthinkingLevel: string,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): ThinkingLevelChangeEntry {\n\treturn {\n\t\ttype: \"thinking_level_change\",\n\t\t...entryBase(byId, parentId),\n\t\tthinkingLevel,\n\t};\n}\n\nexport function createContextWindowChangeEntry(\n\tcontextWindow: number,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): ContextWindowChangeEntry {\n\treturn {\n\t\ttype: \"context_window_change\",\n\t\t...entryBase(byId, parentId),\n\t\tcontextWindow,\n\t};\n}\n\nexport function createModelChangeEntry(\n\tprovider: string,\n\tmodelId: string,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): ModelChangeEntry {\n\treturn {\n\t\ttype: \"model_change\",\n\t\t...entryBase(byId, parentId),\n\t\tprovider,\n\t\tmodelId,\n\t};\n}\n\nexport function createContextCompactionEntry(\n\tdeletedTargets: ContextDeletionTarget[],\n\tprotectedEntryIds: string[],\n\tstats: ContextCompactionStats,\n\tbackupPath: string | undefined,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): ContextCompactionEntry {\n\treturn {\n\t\ttype: \"context_compaction\",\n\t\t...entryBase(byId, parentId),\n\t\tpromptVersion: 1,\n\t\tdeletedTargets,\n\t\tprotectedEntryIds,\n\t\tstats,\n\t\tbackupPath,\n\t};\n}\n\nexport function createCustomEntry(\n\tcustomType: string,\n\tdata: unknown,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): CustomEntry {\n\treturn {\n\t\ttype: \"custom\",\n\t\tcustomType,\n\t\tdata,\n\t\t...entryBase(byId, parentId),\n\t};\n}\n\nexport function createSessionInfoEntry(\n\tname: string,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): SessionInfoEntry {\n\treturn {\n\t\ttype: \"session_info\",\n\t\t...entryBase(byId, parentId),\n\t\tname: name.trim(),\n\t};\n}\n\nexport function getLatestSessionName(entries: SessionEntry[]): string | undefined {\n\t// Walk entries in reverse to find the latest session_info entry.\n\t// Empty names explicitly clear the session title.\n\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\tconst entry = entries[i];\n\t\tif (entry.type === \"session_info\") {\n\t\t\treturn entry.name?.trim() || undefined;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nexport function createCustomMessageEntry<T = unknown>(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: T | undefined,\n\texcludeFromContext: boolean | undefined,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): CustomMessageEntry<T> {\n\treturn {\n\t\ttype: \"custom_message\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\t...(excludeFromContext === true ? { excludeFromContext: true } : {}),\n\t\t...entryBase(byId, parentId),\n\t};\n}\n\nexport function createLabelEntry(\n\ttargetId: string,\n\tlabel: string | undefined,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n\ttimestamp?: string,\n): LabelEntry {\n\treturn {\n\t\ttype: \"label\",\n\t\t...entryBase(byId, parentId),\n\t\t...(timestamp !== undefined ? { timestamp } : {}),\n\t\ttargetId,\n\t\tlabel,\n\t};\n}\n\nexport function createBranchSummaryEntry(\n\tbranchFromId: string | null,\n\tsummary: string,\n\tdetails: unknown,\n\tfromHook: boolean | undefined,\n\tbyId: { has(id: string): boolean },\n): BranchSummaryEntry {\n\treturn {\n\t\ttype: \"branch_summary\",\n\t\t...entryBase(byId, branchFromId),\n\t\tfromId: branchFromId ?? \"root\",\n\t\tsummary,\n\t\tdetails,\n\t\tfromHook,\n\t};\n}\n\nexport function getEntriesWithoutHeader(fileEntries: FileEntry[]): SessionEntry[] {\n\treturn fileEntries.filter((entry): entry is SessionEntry => entry.type !== \"session\");\n}\n"]}

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

@@ -0,0 +1,124 @@
+import { join } from "path";
+import { CURRENT_SESSION_VERSION, } from "./session-manager-types.js";
+import { generateId } from "./session-manager-validation.js";
+function entryBase(byId, parentId) {
+    return {
+        id: generateId(byId),
+        parentId,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function createSessionHeader(id, cwd, timestamp = new Date().toISOString(), parentSession) {
+    return {
+        type: "session",
+        version: CURRENT_SESSION_VERSION,
+        id,
+        timestamp,
+        cwd,
+        parentSession,
+    };
+}
+export function createSessionFilePath(sessionDir, timestamp, sessionId) {
+    const fileTimestamp = timestamp.replace(/[:.]/g, "-");
+    return join(sessionDir, `${fileTimestamp}_${sessionId}.jsonl`);
+}
+export function createMessageEntry(message, byId, parentId) {
+    return {
+        type: "message",
+        ...entryBase(byId, parentId),
+        message,
+    };
+}
+export function createThinkingLevelChangeEntry(thinkingLevel, byId, parentId) {
+    return {
+        type: "thinking_level_change",
+        ...entryBase(byId, parentId),
+        thinkingLevel,
+    };
+}
+export function createContextWindowChangeEntry(contextWindow, byId, parentId) {
+    return {
+        type: "context_window_change",
+        ...entryBase(byId, parentId),
+        contextWindow,
+    };
+}
+export function createModelChangeEntry(provider, modelId, byId, parentId) {
+    return {
+        type: "model_change",
+        ...entryBase(byId, parentId),
+        provider,
+        modelId,
+    };
+}
+export function createContextCompactionEntry(deletedTargets, protectedEntryIds, stats, backupPath, byId, parentId) {
+    return {
+        type: "context_compaction",
+        ...entryBase(byId, parentId),
+        promptVersion: 1,
+        deletedTargets,
+        protectedEntryIds,
+        stats,
+        backupPath,
+    };
+}
+export function createCustomEntry(customType, data, byId, parentId) {
+    return {
+        type: "custom",
+        customType,
+        data,
+        ...entryBase(byId, parentId),
+    };
+}
+export function createSessionInfoEntry(name, byId, parentId) {
+    return {
+        type: "session_info",
+        ...entryBase(byId, parentId),
+        name: name.trim(),
+    };
+}
+export function getLatestSessionName(entries) {
+    // Walk entries in reverse to find the latest session_info entry.
+    // Empty names explicitly clear the session title.
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (entry.type === "session_info") {
+            return entry.name?.trim() || undefined;
+        }
+    }
+    return undefined;
+}
+export function createCustomMessageEntry(customType, content, display, details, excludeFromContext, byId, parentId) {
+    return {
+        type: "custom_message",
+        customType,
+        content,
+        display,
+        details,
+        ...(excludeFromContext === true ? { excludeFromContext: true } : {}),
+        ...entryBase(byId, parentId),
+    };
+}
+export function createLabelEntry(targetId, label, byId, parentId, timestamp) {
+    return {
+        type: "label",
+        ...entryBase(byId, parentId),
+        ...(timestamp !== undefined ? { timestamp } : {}),
+        targetId,
+        label,
+    };
+}
+export function createBranchSummaryEntry(branchFromId, summary, details, fromHook, byId) {
+    return {
+        type: "branch_summary",
+        ...entryBase(byId, branchFromId),
+        fromId: branchFromId ?? "root",
+        summary,
+        details,
+        fromHook,
+    };
+}
+export function getEntriesWithoutHeader(fileEntries) {
+    return fileEntries.filter((entry) => entry.type !== "session");
+}
+//# sourceMappingURL=session-manager-entries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager-entries.js","sourceRoot":"","sources":["../../src/core/session-manager-entries.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ImageContent, Message, TextContent } from \"@earendil-works/pi-ai\";\nimport { join } from \"path\";\nimport type { BashExecutionMessage, CustomMessage } from \"./messages.ts\";\nimport {\n\tCURRENT_SESSION_VERSION,\n\ttype BranchSummaryEntry,\n\ttype ContextCompactionEntry,\n\ttype ContextCompactionStats,\n\ttype ContextDeletionTarget,\n\ttype ContextWindowChangeEntry,\n\ttype CustomEntry,\n\ttype CustomMessageEntry,\n\ttype FileEntry,\n\ttype LabelEntry,\n\ttype ModelChangeEntry,\n\ttype SessionEntry,\n\ttype SessionEntryBase,\n\ttype SessionHeader,\n\ttype SessionInfoEntry,\n\ttype SessionMessageEntry,\n\ttype ThinkingLevelChangeEntry,\n} from \"./session-manager-types.ts\";\nimport { generateId } from \"./session-manager-validation.ts\";\n\nfunction entryBase(byId: { has(id: string): boolean }, parentId: string | null): Pick<SessionEntryBase, \"id\" | \"parentId\" | \"timestamp\"> {\n\treturn {\n\t\tid: generateId(byId),\n\t\tparentId,\n\t\ttimestamp: new Date().toISOString(),\n\t};\n}\n\nexport function createSessionHeader(\n\tid: string,\n\tcwd: string,\n\ttimestamp: string = new Date().toISOString(),\n\tparentSession?: string,\n): SessionHeader {\n\treturn {\n\t\ttype: \"session\",\n\t\tversion: CURRENT_SESSION_VERSION,\n\t\tid,\n\t\ttimestamp,\n\t\tcwd,\n\t\tparentSession,\n\t};\n}\n\nexport function createSessionFilePath(sessionDir: string, timestamp: string, sessionId: string): string {\n\tconst fileTimestamp = timestamp.replace(/[:.]/g, \"-\");\n\treturn join(sessionDir, `${fileTimestamp}_${sessionId}.jsonl`);\n}\n\nexport function createMessageEntry(\n\tmessage: Message | CustomMessage | BashExecutionMessage,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): SessionMessageEntry {\n\treturn {\n\t\ttype: \"message\",\n\t\t...entryBase(byId, parentId),\n\t\tmessage,\n\t};\n}\n\nexport function createThinkingLevelChangeEntry(\n\tthinkingLevel: string,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): ThinkingLevelChangeEntry {\n\treturn {\n\t\ttype: \"thinking_level_change\",\n\t\t...entryBase(byId, parentId),\n\t\tthinkingLevel,\n\t};\n}\n\nexport function createContextWindowChangeEntry(\n\tcontextWindow: number,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): ContextWindowChangeEntry {\n\treturn {\n\t\ttype: \"context_window_change\",\n\t\t...entryBase(byId, parentId),\n\t\tcontextWindow,\n\t};\n}\n\nexport function createModelChangeEntry(\n\tprovider: string,\n\tmodelId: string,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): ModelChangeEntry {\n\treturn {\n\t\ttype: \"model_change\",\n\t\t...entryBase(byId, parentId),\n\t\tprovider,\n\t\tmodelId,\n\t};\n}\n\nexport function createContextCompactionEntry(\n\tdeletedTargets: ContextDeletionTarget[],\n\tprotectedEntryIds: string[],\n\tstats: ContextCompactionStats,\n\tbackupPath: string | undefined,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): ContextCompactionEntry {\n\treturn {\n\t\ttype: \"context_compaction\",\n\t\t...entryBase(byId, parentId),\n\t\tpromptVersion: 1,\n\t\tdeletedTargets,\n\t\tprotectedEntryIds,\n\t\tstats,\n\t\tbackupPath,\n\t};\n}\n\nexport function createCustomEntry(\n\tcustomType: string,\n\tdata: unknown,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): CustomEntry {\n\treturn {\n\t\ttype: \"custom\",\n\t\tcustomType,\n\t\tdata,\n\t\t...entryBase(byId, parentId),\n\t};\n}\n\nexport function createSessionInfoEntry(\n\tname: string,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): SessionInfoEntry {\n\treturn {\n\t\ttype: \"session_info\",\n\t\t...entryBase(byId, parentId),\n\t\tname: name.trim(),\n\t};\n}\n\nexport function getLatestSessionName(entries: SessionEntry[]): string | undefined {\n\t// Walk entries in reverse to find the latest session_info entry.\n\t// Empty names explicitly clear the session title.\n\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\tconst entry = entries[i];\n\t\tif (entry.type === \"session_info\") {\n\t\t\treturn entry.name?.trim() || undefined;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nexport function createCustomMessageEntry<T = unknown>(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: T | undefined,\n\texcludeFromContext: boolean | undefined,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n): CustomMessageEntry<T> {\n\treturn {\n\t\ttype: \"custom_message\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\t...(excludeFromContext === true ? { excludeFromContext: true } : {}),\n\t\t...entryBase(byId, parentId),\n\t};\n}\n\nexport function createLabelEntry(\n\ttargetId: string,\n\tlabel: string | undefined,\n\tbyId: { has(id: string): boolean },\n\tparentId: string | null,\n\ttimestamp?: string,\n): LabelEntry {\n\treturn {\n\t\ttype: \"label\",\n\t\t...entryBase(byId, parentId),\n\t\t...(timestamp !== undefined ? { timestamp } : {}),\n\t\ttargetId,\n\t\tlabel,\n\t};\n}\n\nexport function createBranchSummaryEntry(\n\tbranchFromId: string | null,\n\tsummary: string,\n\tdetails: unknown,\n\tfromHook: boolean | undefined,\n\tbyId: { has(id: string): boolean },\n): BranchSummaryEntry {\n\treturn {\n\t\ttype: \"branch_summary\",\n\t\t...entryBase(byId, branchFromId),\n\t\tfromId: branchFromId ?? \"root\",\n\t\tsummary,\n\t\tdetails,\n\t\tfromHook,\n\t};\n}\n\nexport function getEntriesWithoutHeader(fileEntries: FileEntry[]): SessionEntry[] {\n\treturn fileEntries.filter((entry): entry is SessionEntry => entry.type !== \"session\");\n}\n"]}

package/dist/core/session-manager-history.d.ts

@@ -0,0 +1,38 @@
+import type { ContextCompactionEntry, ContextDeletionFilters, FileEntry, SessionContext, SessionEntry, SessionTreeNode } from "./session-manager-types.ts";
+export declare function getLatestCompactionBoundaryEntry(entries: SessionEntry[]): ContextCompactionEntry | null;
+/**
+ * Build raw deletion filters from persisted context_compaction entries.
+ *
+ * These raw filters do not apply replay-safety repair for latest assistant
+ * thinking/redacted_thinking blocks or their paired tool results. Production
+ * context rebuild paths should prefer `buildEffectiveContextDeletionFilters`
+ * or `buildContextDeletionFilteredPath(path)` unless they intentionally need
+ * the un-repaired historical deletion plan for diagnostics.
+ */
+export declare function buildContextDeletionFilters(path: SessionEntry[]): ContextDeletionFilters;
+export declare function buildEffectiveContextDeletionFilters(path: SessionEntry[]): ContextDeletionFilters;
+/**
+ * Return the active branch path after applying logical context-deletion entries.
+ * Whole-entry deletions remove the entry from the path. Content-block deletions
+ * clone only affected message/custom-message entries so retained blocks stay verbatim.
+ * The optional filters parameter is for callers that already computed effective
+ * filters with `buildEffectiveContextDeletionFilters(path)` and want to avoid
+ * repeating the repair pass.
+ */
+export declare function buildContextDeletionFilteredPath(path: SessionEntry[], effectiveFilters?: ContextDeletionFilters): SessionEntry[];
+/**
+ * Build the session context from entries using tree traversal.
+ * If leafId is provided, walks from that entry to root.
+ * Applies context-deletion filtering and includes branch summaries along the path.
+ */
+export declare function buildSessionContext(entries: SessionEntry[], leafId?: string | null, byId?: Map<string, SessionEntry>): SessionContext;
+export interface SessionIndex {
+    byId: Map<string, SessionEntry>;
+    labelsById: Map<string, string>;
+    labelTimestampsById: Map<string, string>;
+    leafId: string | null;
+}
+export declare function buildSessionIndex(fileEntries: FileEntry[]): SessionIndex;
+export declare function getBranchPath(fromId: string | null | undefined, byId: Map<string, SessionEntry>): SessionEntry[];
+export declare function buildSessionTree(entries: SessionEntry[], labelsById: ReadonlyMap<string, string>, labelTimestampsById: ReadonlyMap<string, string>): SessionTreeNode[];
+//# sourceMappingURL=session-manager-history.d.ts.map