@claude-sessions/core 0.3.6 → 0.4.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MessagePayload, a as Message, P as Project, T as TodoItem, F as FileChange, b as MoveSessionResult, S as SearchResult, c as SummaryInfo, A as AgentInfo } from './types-C2fzbmg9.js';
-export { i as CleanupPreview, h as ClearSessionsResult, C as ContentItem, D as DeleteSessionResult, k as ProjectTreeData, R as RenameSessionResult, l as ResumeSessionOptions, m as ResumeSessionResult, f as SessionFilesSummary, d as SessionMeta, e as SessionTodos, j as SessionTreeData, g as SplitSessionResult } from './types-C2fzbmg9.js';
+import { M as MessagePayload, a as Message, P as Project, S as SummaryInfo, T as TodoItem, b as MoveSessionResult, A as AgentInfo, c as SessionSortOptions, C as CompressSessionOptions, d as SummarizeSessionOptions, e as ConversationLine, f as SearchResult, F as FileChange, g as SessionsIndex, h as SessionIndexEntry } from './types-BdPaAnP8.js';
+export { o as CleanupPreview, n as ClearSessionsResult, v as CompressSessionResult, i as ContentItem, D as DeleteSessionResult, w as ProjectKnowledge, q as ProjectTreeData, R as RenameSessionResult, r as ResumeSessionOptions, s as ResumeSessionResult, u as SessionAnalysis, l as SessionFilesSummary, j as SessionMeta, y as SessionSortField, z as SessionSortOrder, k as SessionTodos, p as SessionTreeData, m as SplitSessionResult, x as SummarizeSessionResult, t as ToolUsageStats } from './types-BdPaAnP8.js';
 import * as effect_Cause from 'effect/Cause';
 import { Effect } from 'effect';
 
@@ -11,7 +11,9 @@ interface FileSystem {
     readFileSync: (path: string, encoding: 'utf-8') => string;
     readdirSync: (path: string) => string[];
 }
-/** Get Claude sessions directory (~/.claude/projects) */
+/** Get Claude sessions directory (~/.claude/projects)
+ * Can be overridden with CLAUDE_SESSIONS_DIR environment variable for testing
+ */
 declare const getSessionsDir: () => string;
 /** Get Claude todos directory (~/.claude/todos) */
 declare const getTodosDir: () => string;
@@ -74,6 +76,21 @@ declare const getDisplayTitle: (customTitle: string | undefined, currentSummary:
  * Only masks the specified homeDir, not other users' paths
  */
 declare const maskHomePath: (text: string, homeDir: string) => string;
+/**
+ * Get session sort timestamp based on official Claude Code extension behavior
+ *
+ * CRITICAL ARCHITECTURE:
+ * - Summary records have `leafUuid` but NO timestamp in the summary record itself
+ * - `leafUuid` points to a message in ANOTHER session (cross-session reference)
+ * - The timestamp for sorting must come from the TARGET message's timestamp
+ * - Official extension uses leafUuid's target message timestamp for sorting/display
+ *
+ * Priority: summaries[0].timestamp (leafUuid-based) > createdAt
+ */
+declare const getSessionSortTimestamp: (session: {
+    summaries?: SummaryInfo[];
+    createdAt?: string;
+}) => string | undefined;
 /**
  * Sort projects with priority:
  * 1. Current project (if specified)
@@ -94,6 +111,11 @@ declare const findOrphanAgents: (projectName: string) => Effect.Effect<{
 declare const deleteOrphanAgents: (projectName: string) => Effect.Effect<{
     success: boolean;
     deletedAgents: string[];
+    backedUpAgents: string[];
+    cleanedFolders: string[];
+    deletedCount: number;
+    backedUpCount: number;
+    cleanedFolderCount: number;
     count: number;
 }, effect_Cause.UnknownException, never>;
 declare const loadAgentMessages: (projectName: string, _sessionId: string, // Reserved for future validation
@@ -119,10 +141,16 @@ declare const deleteOrphanTodos: () => Effect.Effect<{
 }, effect_Cause.UnknownException, never>;
 
 declare const listProjects: Effect.Effect<Project[], effect_Cause.UnknownException, never>;
+
+declare const updateSessionSummary: (projectName: string, sessionId: string, newSummary: string) => Effect.Effect<{
+    success: boolean;
+}, effect_Cause.UnknownException, never>;
 declare const listSessions: (projectName: string) => Effect.Effect<{
     id: string;
     projectName: string;
     title: string;
+    customTitle: string | undefined;
+    currentSummary: string | undefined;
     messageCount: number;
     createdAt: string | undefined;
     updatedAt: string | undefined;
@@ -162,12 +190,6 @@ declare const renameSession: (projectName: string, sessionId: string, newTitle:
     success: true;
     error?: undefined;
 }, effect_Cause.UnknownException, never>;
-declare const getSessionFiles: (projectName: string, sessionId: string) => Effect.Effect<{
-    sessionId: string;
-    projectName: string;
-    files: FileChange[];
-    totalChanges: number;
-}, effect_Cause.UnknownException, never>;
 declare const moveSession: (sourceProject: string, sessionId: string, targetProject: string) => Effect.Effect<MoveSessionResult, Error>;
 declare const splitSession: (projectName: string, sessionId: string, splitAtMessageUuid: string) => Effect.Effect<{
     success: false;
@@ -184,46 +206,7 @@ declare const splitSession: (projectName: string, sessionId: string, splitAtMess
     duplicatedSummary: boolean;
     error?: undefined;
 }, effect_Cause.UnknownException, never>;
-declare const previewCleanup: (projectName?: string) => Effect.Effect<{
-    project: string;
-    emptySessions: {
-        id: string;
-        projectName: string;
-        title: string;
-        messageCount: number;
-        createdAt: string | undefined;
-        updatedAt: string | undefined;
-    }[];
-    invalidSessions: {
-        id: string;
-        projectName: string;
-        title: string;
-        messageCount: number;
-        createdAt: string | undefined;
-        updatedAt: string | undefined;
-    }[];
-    emptyWithTodosCount: number;
-    orphanAgentCount: number;
-    orphanTodoCount: number;
-}[], effect_Cause.UnknownException, never>;
-declare const clearSessions: (options: {
-    projectName?: string;
-    clearEmpty?: boolean;
-    clearInvalid?: boolean;
-    skipWithTodos?: boolean;
-    clearOrphanAgents?: boolean;
-    clearOrphanTodos?: boolean;
-}) => Effect.Effect<{
-    success: true;
-    deletedCount: number;
-    removedMessageCount: number;
-    deletedOrphanAgentCount: number;
-    deletedOrphanTodoCount: number;
-}, effect_Cause.UnknownException, never>;
-declare const searchSessions: (query: string, options?: {
-    projectName?: string;
-    searchContent?: boolean;
-}) => Effect.Effect<SearchResult[], effect_Cause.UnknownException, never>;
+
 declare const loadSessionTreeData: (projectName: string, sessionId: string) => Effect.Effect<{
     id: string;
     projectName: string;
@@ -233,6 +216,7 @@ declare const loadSessionTreeData: (projectName: string, sessionId: string) => E
     messageCount: number;
     createdAt: string;
     updatedAt: string;
+    fileMtime: number | undefined;
     summaries: SummaryInfo[];
     agents: AgentInfo[];
     todos: {
@@ -246,7 +230,7 @@ declare const loadSessionTreeData: (projectName: string, sessionId: string) => E
     };
     lastCompactBoundaryUuid: string | undefined;
 }, effect_Cause.UnknownException, never>;
-declare const loadProjectTreeData: (projectName: string) => Effect.Effect<{
+declare const loadProjectTreeData: (projectName: string, sortOptions?: SessionSortOptions) => Effect.Effect<{
     name: string;
     displayName: string;
     path: string;
@@ -260,6 +244,7 @@ declare const loadProjectTreeData: (projectName: string) => Effect.Effect<{
         messageCount: number;
         createdAt: string;
         updatedAt: string;
+        fileMtime: number | undefined;
         summaries: SummaryInfo[];
         agents: AgentInfo[];
         todos: {
@@ -274,9 +259,138 @@ declare const loadProjectTreeData: (projectName: string) => Effect.Effect<{
         lastCompactBoundaryUuid: string | undefined;
     }[];
 } | null, effect_Cause.UnknownException, never>;
-declare const updateSessionSummary: (projectName: string, sessionId: string, newSummary: string) => Effect.Effect<{
-    success: boolean;
+
+declare const analyzeSession: (projectName: string, sessionId: string) => Effect.Effect<{
+    sessionId: string;
+    projectName: string;
+    durationMinutes: number;
+    stats: {
+        totalMessages: number;
+        userMessages: number;
+        assistantMessages: number;
+        summaryCount: number;
+        snapshotCount: number;
+    };
+    toolUsage: {
+        name: string;
+        count: number;
+        errorCount: number;
+    }[];
+    filesChanged: string[];
+    patterns: {
+        type: string;
+        description: string;
+        count: number;
+    }[];
+    milestones: {
+        timestamp?: string;
+        description: string;
+        messageUuid?: string;
+    }[];
+}, effect_Cause.UnknownException, never>;
+declare const compressSession: (projectName: string, sessionId: string, options?: CompressSessionOptions) => Effect.Effect<{
+    success: true;
+    originalSize: number;
+    compressedSize: number;
+    removedSnapshots: number;
+    truncatedOutputs: number;
 }, effect_Cause.UnknownException, never>;
+declare const extractProjectKnowledge: (projectName: string, sessionIds?: string[]) => Effect.Effect<{
+    projectName: string;
+    patterns: never[];
+    hotFiles: {
+        path: string;
+        modifyCount: number;
+        lastModified: string | undefined;
+    }[];
+    workflows: {
+        sequence: string[];
+        count: number;
+    }[];
+    decisions: {
+        context: string;
+        decision: string;
+        sessionId: string;
+    }[];
+}, effect_Cause.UnknownException, never>;
+declare const summarizeSession: (projectName: string, sessionId: string, options?: SummarizeSessionOptions) => Effect.Effect<{
+    sessionId: string;
+    projectName: string;
+    lines: ConversationLine[];
+    formatted: string;
+}, effect_Cause.UnknownException, never>;
+
+declare const previewCleanup: (projectName?: string) => Effect.Effect<{
+    project: string;
+    emptySessions: {
+        id: string;
+        projectName: string;
+        title: string;
+        customTitle: string | undefined;
+        currentSummary: string | undefined;
+        messageCount: number;
+        createdAt: string | undefined;
+        updatedAt: string | undefined;
+    }[];
+    invalidSessions: {
+        id: string;
+        projectName: string;
+        title: string;
+        customTitle: string | undefined;
+        currentSummary: string | undefined;
+        messageCount: number;
+        createdAt: string | undefined;
+        updatedAt: string | undefined;
+    }[];
+    emptyWithTodosCount: number;
+    orphanAgentCount: number;
+    orphanTodoCount: number;
+}[], effect_Cause.UnknownException, never>;
+declare const clearSessions: (options: {
+    projectName?: string;
+    clearEmpty?: boolean;
+    clearInvalid?: boolean;
+    skipWithTodos?: boolean;
+    clearOrphanAgents?: boolean;
+    clearOrphanTodos?: boolean;
+}) => Effect.Effect<{
+    success: true;
+    deletedCount: number;
+    removedMessageCount: number;
+    deletedOrphanAgentCount: number;
+    deletedOrphanTodoCount: number;
+}, effect_Cause.UnknownException, never>;
+
+declare const searchSessions: (query: string, options?: {
+    projectName?: string;
+    searchContent?: boolean;
+}) => Effect.Effect<SearchResult[], effect_Cause.UnknownException, never>;
+
+declare const getSessionFiles: (projectName: string, sessionId: string) => Effect.Effect<{
+    sessionId: string;
+    projectName: string;
+    files: FileChange[];
+    totalChanges: number;
+}, effect_Cause.UnknownException, never>;
+
+/**
+ * Load sessions-index.json for a project
+ * Returns null if the file doesn't exist
+ */
+declare const loadSessionsIndex: (projectName: string) => Effect.Effect<SessionsIndex | null, effect_Cause.UnknownException, never>;
+/**
+ * Get display title from index entry
+ * Priority: customTitle > summary > firstPrompt (cleaned)
+ */
+declare const getIndexEntryDisplayTitle: (entry: SessionIndexEntry) => string;
+/**
+ * Sort index entries by modified time (newest first)
+ */
+declare const sortIndexEntriesByModified: (entries: SessionIndexEntry[]) => SessionIndexEntry[];
+/**
+ * Check if sessions-index.json exists for a project
+ */
+declare const hasSessionsIndex: (projectName: string) => Effect.Effect<boolean, effect_Cause.UnknownException, never>;
 
 /**
  * Simple logger abstraction for Claude Sessions
@@ -312,4 +426,4 @@ declare const getLogger: () => Logger;
  */
 declare const createLogger: (namespace: string) => Logger;
 
-export { AgentInfo, FileChange, type Logger, Message, MessagePayload, MoveSessionResult, Project, SearchResult, SummaryInfo, TodoItem, clearSessions, createLogger, deleteLinkedTodos, deleteMessage, deleteOrphanAgents, deleteOrphanTodos, deleteSession, displayPathToFolderName, extractTextContent, extractTitle, findLinkedAgents, findLinkedTodos, findOrphanAgents, findOrphanTodos, findProjectByWorkspacePath, folderNameToDisplayPath, folderNameToPath, getDisplayTitle, getLogger, getRealPathFromSession, getSessionFiles, getSessionsDir, getTodosDir, isContinuationSummary, isInvalidApiKeyMessage, listProjects, listSessions, loadAgentMessages, loadProjectTreeData, loadSessionTreeData, maskHomePath, moveSession, pathToFolderName, previewCleanup, readSession, renameSession, restoreMessage, searchSessions, sessionHasTodos, setLogger, sortProjects, splitSession, updateSessionSummary };
+export { AgentInfo, CompressSessionOptions, ConversationLine, FileChange, type Logger, Message, MessagePayload, MoveSessionResult, Project, SearchResult, SessionIndexEntry, SessionSortOptions, SessionsIndex, SummarizeSessionOptions, SummaryInfo, TodoItem, analyzeSession, clearSessions, compressSession, createLogger, deleteLinkedTodos, deleteMessage, deleteOrphanAgents, deleteOrphanTodos, deleteSession, displayPathToFolderName, extractProjectKnowledge, extractTextContent, extractTitle, findLinkedAgents, findLinkedTodos, findOrphanAgents, findOrphanTodos, findProjectByWorkspacePath, folderNameToDisplayPath, folderNameToPath, getDisplayTitle, getIndexEntryDisplayTitle, getLogger, getRealPathFromSession, getSessionFiles, getSessionSortTimestamp, getSessionsDir, getTodosDir, hasSessionsIndex, isContinuationSummary, isInvalidApiKeyMessage, listProjects, listSessions, loadAgentMessages, loadProjectTreeData, loadSessionTreeData, loadSessionsIndex, maskHomePath, moveSession, pathToFolderName, previewCleanup, readSession, renameSession, restoreMessage, searchSessions, sessionHasTodos, setLogger, sortIndexEntriesByModified, sortProjects, splitSession, summarizeSession, updateSessionSummary };