@claude-sessions/core 0.4.7 → 0.4.8

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as Project, M as MessagePayload$1, a as Message, S as SummaryInfo, b as SessionTodos, c as MoveSessionResult, A as AgentInfo, d as SessionSortOptions, e as ProjectTreeData, C as CompressSessionOptions, f as SummarizeSessionOptions, g as ConversationLine, h as SearchResult, F as FileChange, i as SessionsIndex, j as SessionIndexEntry } from './types-BMQErZZE.js';
-export { p as CleanupPreview, o as ClearSessionsResult, v as CompressSessionResult, k as ContentItem, D as DeleteSessionResult, w as ProjectKnowledge, R as RenameSessionResult, r as ResumeSessionOptions, s as ResumeSessionResult, u as SessionAnalysis, m as SessionFilesSummary, l as SessionMeta, y as SessionSortField, z as SessionSortOrder, q as SessionTreeData, n as SplitSessionResult, x as SummarizeSessionResult, T as TodoItem, t as ToolUsageStats } from './types-BMQErZZE.js';
+import { P as Project, M as MessagePayload$1, a as Message, T as TitleDisplayMode, S as SummaryInfo, b as SessionSortField, c as SessionTodos, d as MoveSessionResult, A as AgentInfo, e as SessionSortOptions, f as ProjectTreeData, C as CompressSessionOptions, g as SummarizeSessionOptions, h as ConversationLine, i as SearchResult, F as FileChange, j as SessionsIndex, k as SessionIndexEntry } from './types-AvikAHId.js';
+export { r as CleanupPreview, q as ClearSessionsResult, x as CompressSessionResult, l as ContentItem, D as DeleteSessionResult, y as ProjectKnowledge, R as RenameSessionResult, t as ResumeSessionOptions, u as ResumeSessionResult, w as SessionAnalysis, o as SessionFilesSummary, m as SessionMeta, B as SessionSortOrder, s as SessionTreeData, p as SplitSessionResult, z as SummarizeSessionResult, n as TodoItem, v as ToolUsageStats } from './types-AvikAHId.js';
 import * as effect_Cause from 'effect/Cause';
 import { Effect } from 'effect';
 
@@ -94,25 +94,60 @@ declare const parseCommandMessage: (content?: string) => {
 declare const extractTitle: (input: MessagePayload$1 | string | undefined) => string;
 declare const isInvalidApiKeyMessage: (msg: Message) => boolean;
 declare const isContinuationSummary: (msg: Message) => boolean;
+/**
+ * Options for getDisplayTitle when using the options-based signature
+ */
+interface DisplayTitleOptions {
+    customTitle?: string;
+    currentSummary?: string;
+    title?: string;
+    createdAt?: string;
+    maxLength?: number;
+    fallback?: string;
+    /** 'message' = first user message (default), 'datetime' = relative date/time */
+    mode?: TitleDisplayMode;
+    /** Locale for date formatting (e.g. 'de-DE', 'en-GB'). Defaults to system locale. */
+    locale?: string;
+}
 /**
  * Get display title with fallback logic
- * Priority: customTitle > currentSummary (truncated) > title > fallback
+ * Priority: customTitle > currentSummary (truncated) > title/datetime > fallback
  * Also handles slash command format in title
+ *
+ * Supports two call signatures:
+ * - Legacy: getDisplayTitle(customTitle, currentSummary, title, maxLength?, fallback?)
+ * - Options: getDisplayTitle(options)
  */
-declare const getDisplayTitle: (customTitle: string | undefined, currentSummary: string | undefined, title: string | undefined, maxLength?: number, fallback?: string) => string;
+declare function getDisplayTitle(options: DisplayTitleOptions): string;
+declare function getDisplayTitle(customTitle: string | undefined, currentSummary: string | undefined, title: string | undefined, maxLength?: number, fallback?: string): string;
 /**
  * Mask home directory path with ~
  * Only masks the specified homeDir, not other users' paths
  */
 declare const maskHomePath: (text: string, homeDir: string) => string;
 /**
- * Get sort timestamp for session (Unix timestamp ms)
- * Priority: summaries[0].timestamp > createdAt > 0
+ * Get summary-based sort timestamp for session (Unix timestamp ms)
+ * Used for 'summary' sort field. Priority: summaries[0].timestamp > createdAt > 0
  */
+declare const getSummarySortTimestamp: (session: {
+    summaries?: SummaryInfo[];
+    createdAt?: string;
+}) => number;
+/** @deprecated Use getSummarySortTimestamp instead */
 declare const getSessionSortTimestamp: (session: {
     summaries?: SummaryInfo[];
     createdAt?: string;
 }) => number;
+/**
+ * Get display-ready sort timestamp based on active sort field.
+ * Returns the timestamp matching what the user sees as the sort order.
+ */
+declare const getDisplaySortTimestamp: (session: {
+    summaries?: SummaryInfo[];
+    createdAt?: string;
+    updatedAt?: string;
+    fileMtime?: number;
+}, sortField: SessionSortField) => number;
 /**
  * Try to parse a single JSON line, returning null on failure with optional warning log
  * Use this when you want to skip invalid lines instead of throwing
@@ -139,7 +174,7 @@ declare const readJsonlFile: <T = Record<string, unknown>>(filePath: string, opt
  * @param timestamp - Unix timestamp (ms) or ISO date string
  * @returns Relative time string
  */
-declare const formatRelativeTime: (timestamp: number | string) => string;
+declare const formatRelativeTime: (timestamp: number | string, locale?: string) => string;
 /**
  * Calculate total todo count from session todos
  * Includes both session-level and agent-level todos
@@ -670,4 +705,4 @@ declare const getLogger: () => Logger;
  */
 declare const createLogger: (namespace: string) => Logger;
 
-export { AgentInfo, type ChainError, CompressSessionOptions, ConversationLine, FileChange, type GenericMessage, type Logger, Message, MessagePayload$1 as MessagePayload, MoveSessionResult, type ProgressError, Project, ProjectTreeData, SearchResult, SessionIndexEntry, SessionSortOptions, SessionTodos, SessionsIndex, SummarizeSessionOptions, SummaryInfo, TREE_ICONS, type ToolUseResultError, type TreeItemType, type ValidationResult, analyzeSession, autoRepairChain, canMoveSession, clearSessions, compressSession, createLogger, deleteLinkedTodos, deleteMessage, deleteMessageWithChainRepair, deleteOrphanAgents, deleteOrphanTodos, deleteSession, expandHomePath, extractProjectKnowledge, extractTextContent, extractTitle, findLinkedAgents, findLinkedTodos, findOrphanAgents, findOrphanTodos, findProjectByWorkspacePath, folderNameToDisplayPath, folderNameToPath, formatRelativeTime, generateTreeNodeId, getCachePath, getDisplayTitle, getIndexEntryDisplayTitle, getLogger, getRealPathFromSession, getSessionFiles, getSessionSortTimestamp, getSessionTooltip, getSessionsDir, getTodoIcon, getTodosDir, getTotalTodoCount, hasSessionsIndex, isContinuationSummary, isInvalidApiKeyMessage, listProjects, listSessions, loadAgentMessages, loadProjectTreeData, loadSessionTreeData, loadSessionsIndex, maskHomePath, moveSession, parseCommandMessage, parseJsonlLines, parseTreeNodeId, pathToFolderName, previewCleanup, readJsonlFile, readSession, renameSession, repairChain, repairParentUuidChain, restoreMessage, searchSessions, sessionHasSubItems, sessionHasTodos, setLogger, sortIndexEntriesByModified, sortProjects, splitSession, summarizeSession, tryParseJsonLine, updateSessionSummary, validateChain, validateProgressMessages, validateToolUseResult };
+export { AgentInfo, type ChainError, CompressSessionOptions, ConversationLine, type DisplayTitleOptions, FileChange, type GenericMessage, type Logger, Message, MessagePayload$1 as MessagePayload, MoveSessionResult, type ProgressError, Project, ProjectTreeData, SearchResult, SessionIndexEntry, SessionSortField, SessionSortOptions, SessionTodos, SessionsIndex, SummarizeSessionOptions, SummaryInfo, TREE_ICONS, TitleDisplayMode, type ToolUseResultError, type TreeItemType, type ValidationResult, analyzeSession, autoRepairChain, canMoveSession, clearSessions, compressSession, createLogger, deleteLinkedTodos, deleteMessage, deleteMessageWithChainRepair, deleteOrphanAgents, deleteOrphanTodos, deleteSession, expandHomePath, extractProjectKnowledge, extractTextContent, extractTitle, findLinkedAgents, findLinkedTodos, findOrphanAgents, findOrphanTodos, findProjectByWorkspacePath, folderNameToDisplayPath, folderNameToPath, formatRelativeTime, generateTreeNodeId, getCachePath, getDisplaySortTimestamp, getDisplayTitle, getIndexEntryDisplayTitle, getLogger, getRealPathFromSession, getSessionFiles, getSessionSortTimestamp, getSessionTooltip, getSessionsDir, getSummarySortTimestamp, getTodoIcon, getTodosDir, getTotalTodoCount, hasSessionsIndex, isContinuationSummary, isInvalidApiKeyMessage, listProjects, listSessions, loadAgentMessages, loadProjectTreeData, loadSessionTreeData, loadSessionsIndex, maskHomePath, moveSession, parseCommandMessage, parseJsonlLines, parseTreeNodeId, pathToFolderName, previewCleanup, readJsonlFile, readSession, renameSession, repairChain, repairParentUuidChain, restoreMessage, searchSessions, sessionHasSubItems, sessionHasTodos, setLogger, sortIndexEntriesByModified, sortProjects, splitSession, summarizeSession, tryParseJsonLine, updateSessionSummary, validateChain, validateProgressMessages, validateToolUseResult };

package/dist/index.js

@@ -95,11 +95,31 @@ var isContinuationSummary = (msg) => {
   const text = extractTextContent(msg.message);
   return text.startsWith("This session is being continued from");
 };
-var getDisplayTitle = (customTitle, currentSummary, title, maxLength = 60, fallback = "Untitled") => {
+function getDisplayTitle(customTitleOrOptions, currentSummary, title, maxLength = 60, fallback = "Untitled") {
+  let mode = "message";
+  let createdAt;
+  let customTitle;
+  let locale;
+  if (typeof customTitleOrOptions === "object" && customTitleOrOptions !== null) {
+    const opts = customTitleOrOptions;
+    customTitle = opts.customTitle;
+    currentSummary = opts.currentSummary;
+    title = opts.title;
+    createdAt = opts.createdAt;
+    maxLength = opts.maxLength ?? 60;
+    fallback = opts.fallback ?? "Untitled";
+    mode = opts.mode ?? "message";
+    locale = opts.locale;
+  } else {
+    customTitle = customTitleOrOptions;
+  }
   if (customTitle) return customTitle;
   if (currentSummary) {
     return currentSummary.length > maxLength ? currentSummary.slice(0, maxLength - 3) + "..." : currentSummary;
   }
+  if (mode === "datetime" && createdAt) {
+    return formatRelativeTime(createdAt, locale);
+  }
   if (title && title !== "Untitled") {
     const firstParagraph = title.includes("\n\n") ? title.split("\n\n")[0] : title;
     if (firstParagraph.includes("<command-name>")) {
@@ -109,7 +129,7 @@ var getDisplayTitle = (customTitle, currentSummary, title, maxLength = 60, fallb
     return firstParagraph;
   }
   return fallback;
-};
+}
 var replaceMessageContent = (msg, text) => ({
   ...msg,
   message: {
@@ -143,10 +163,27 @@ var maskHomePath = (text, homeDir) => {
   const regex = new RegExp(`${escapedHome}(?=[/\\\\]|$)`, "g");
   return text.replace(regex, "~");
 };
-var getSessionSortTimestamp = (session) => {
+var getSummarySortTimestamp = (session) => {
   const timestampStr = session.summaries?.[0]?.timestamp ?? session.createdAt;
   return timestampStr ? new Date(timestampStr).getTime() : 0;
 };
+var getSessionSortTimestamp = getSummarySortTimestamp;
+var getDisplaySortTimestamp = (session, sortField) => {
+  switch (sortField) {
+    case "updated": {
+      if (session.updatedAt) return new Date(session.updatedAt).getTime();
+      return getSummarySortTimestamp(session);
+    }
+    case "created": {
+      if (session.createdAt) return new Date(session.createdAt).getTime();
+      return getSummarySortTimestamp(session);
+    }
+    case "modified":
+      return session.fileMtime ?? getSummarySortTimestamp(session);
+    default:
+      return getSummarySortTimestamp(session);
+  }
+};
 var tryParseJsonLine = (line, lineNumber, filePath) => {
   try {
     return JSON.parse(line);
@@ -179,7 +216,7 @@ var readJsonlFile = (filePath, options) => Effect.gen(function* () {
   const lines = content.trim().split("\n").filter(Boolean);
   return parseJsonlLines(lines, filePath, options);
 });
-var formatRelativeTime = (timestamp) => {
+var formatRelativeTime = (timestamp, locale) => {
   const date = typeof timestamp === "string" ? new Date(timestamp) : new Date(timestamp);
   const now = /* @__PURE__ */ new Date();
   const diff = now.getTime() - date.getTime();
@@ -190,7 +227,7 @@ var formatRelativeTime = (timestamp) => {
   if (minutes < 60) return `${minutes}m ago`;
   if (hours < 24) return `${hours}h ago`;
   if (days < 7) return `${days}d ago`;
-  return date.toLocaleDateString();
+  return date.toLocaleDateString(locale, { day: "numeric", month: "short", year: "numeric" });
 };
 var getTotalTodoCount = (todos) => {
   return todos.sessionTodos.length + todos.agentTodos.reduce((sum, a) => sum + a.todos.length, 0);
@@ -1590,7 +1627,7 @@ var loadSessionTreeDataInternal = (projectName, sessionId, summariesByTargetSess
   }
   const todos = yield* findLinkedTodos(sessionId, linkedAgentIds);
   const createdAt = firstMessage?.timestamp ?? void 0;
-  const sortTimestamp = getSessionSortTimestamp({ summaries, createdAt });
+  const sortTimestamp = getSummarySortTimestamp({ summaries, createdAt });
   return {
     id: sessionId,
     projectName,
@@ -1689,12 +1726,16 @@ var buildProjectTreeResult = (project, sessions, sort) => {
     if (isErrorSessionTitle(s.currentSummary)) return false;
     return true;
   });
+  const displaySessions = filteredSessions.map((s) => ({
+    ...s,
+    sortTimestamp: getDisplaySortTimestamp(s, sort.field)
+  }));
   return {
     name: project.name,
     displayName: project.displayName,
     path: project.path,
-    sessionCount: filteredSessions.length,
-    sessions: filteredSessions
+    sessionCount: displaySessions.length,
+    sessions: displaySessions
   };
 };
 var buildTreeCache = (globalUuidMap, allSummaries, sessions, fileMtimes) => {
@@ -1721,7 +1762,7 @@ var updateSessionSummaries = (cached, summariesByTargetSession) => {
   const oldJson = JSON.stringify(cached.summaries);
   const newJson = JSON.stringify(newSummaries);
   if (oldJson === newJson) return cached;
-  const newSortTimestamp = getSessionSortTimestamp({
+  const newSortTimestamp = getSummarySortTimestamp({
     summaries: newSummaries,
     createdAt: cached.createdAt
   });
@@ -2575,6 +2616,7 @@ export {
   formatRelativeTime,
   generateTreeNodeId,
   getCachePath,
+  getDisplaySortTimestamp,
   getDisplayTitle,
   getIndexEntryDisplayTitle,
   getLogger,
@@ -2583,6 +2625,7 @@ export {
   getSessionSortTimestamp,
   getSessionTooltip,
   getSessionsDir,
+  getSummarySortTimestamp,
   getTodoIcon,
   getTodosDir,
   getTotalTodoCount,