@claude-sessions/core 0.3.7 → 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, C as CompressSessionOptions, S as SummarizeSessionOptions, b as ConversationLine, c as MoveSessionResult, d as SearchResult, e as SummaryInfo, A as AgentInfo } from './types-Cz8chaYQ.js';
-export { l as CleanupPreview, k as ClearSessionsResult, s as CompressSessionResult, f as ContentItem, D as DeleteSessionResult, t as ProjectKnowledge, n as ProjectTreeData, R as RenameSessionResult, o as ResumeSessionOptions, p as ResumeSessionResult, r as SessionAnalysis, i as SessionFilesSummary, g as SessionMeta, h as SessionTodos, m as SessionTreeData, j as SplitSessionResult, u as SummarizeSessionResult, q as ToolUsageStats } from './types-Cz8chaYQ.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';
 
@@ -76,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)
@@ -126,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;
@@ -169,40 +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 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 moveSession: (sourceProject: string, sessionId: string, targetProject: string) => Effect.Effect<MoveSessionResult, Error>;
 declare const splitSession: (projectName: string, sessionId: string, splitAtMessageUuid: string) => Effect.Effect<{
     success: false;
@@ -219,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;
@@ -268,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: {
@@ -281,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;
@@ -295,6 +244,7 @@ declare const loadProjectTreeData: (projectName: string) => Effect.Effect<{
         messageCount: number;
         createdAt: string;
         updatedAt: string;
+        fileMtime: number | undefined;
         summaries: SummaryInfo[];
         agents: AgentInfo[];
         todos: {
@@ -309,8 +259,34 @@ 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;
@@ -344,6 +320,78 @@ declare const summarizeSession: (projectName: string, sessionId: string, options
     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
  * Consumers can provide their own logger implementation
@@ -378,4 +426,4 @@ declare const getLogger: () => Logger;
  */
 declare const createLogger: (namespace: string) => Logger;
 
-export { AgentInfo, CompressSessionOptions, ConversationLine, FileChange, type Logger, Message, MessagePayload, MoveSessionResult, Project, SearchResult, SummarizeSessionOptions, SummaryInfo, TodoItem, analyzeSession, clearSessions, compressSession, createLogger, deleteLinkedTodos, deleteMessage, deleteOrphanAgents, deleteOrphanTodos, deleteSession, displayPathToFolderName, extractProjectKnowledge, 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, summarizeSession, 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 };