@claude-sessions/core 0.4.7-beta.2 → 0.4.8-beta.0

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 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-CsXAWb1Q.js';
+export { q as CleanupPreview, p as ClearSessionsResult, w as CompressSessionResult, k as ContentItem, D as DeleteSessionResult, x as ProjectKnowledge, R as RenameSessionResult, s as ResumeSessionOptions, t as ResumeSessionResult, v as SessionAnalysis, n as SessionFilesSummary, l as SessionMeta, z as SessionSortField, B as SessionSortOrder, r as SessionTreeData, o as SplitSessionResult, y as SummarizeSessionResult, m as TodoItem, u as ToolUsageStats } from './types-CsXAWb1Q.js';
 import * as effect_Cause from 'effect/Cause';
 import { Effect } from 'effect';
 
@@ -94,12 +94,32 @@ 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
@@ -139,7 +159,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 +690,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, 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, 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 };

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: {
@@ -179,7 +199,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 +210,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);