@claude-sessions/core 0.3.2 → 0.3.4

package/dist/index.d.ts

@@ -1,231 +1,8 @@
+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 * as effect_Cause from 'effect/Cause';
 import { Effect } from 'effect';
 
-/**
- * Core types for Claude Code session management
- */
-/**
- * Base interface for objects with a type discriminator.
- * Used as a foundation for message and content types.
- */
-interface TypedObject {
-    type: string;
-}
-/**
- * Text content block in a message.
- * @see https://docs.anthropic.com/en/api/messages
- */
-interface TextContent {
-    type: 'text';
-    text: string;
-}
-/**
- * Tool result content returned after tool execution.
- * Contains the output from a tool_use request.
- */
-interface ToolResultContent {
-    type: 'tool_result';
-    tool_use_id: string;
-    content: string;
-    is_error?: boolean;
-}
-/**
- * Tool use request from the assistant.
- * Represents a function call with input parameters.
- */
-interface ToolUseContent {
-    type: 'tool_use';
-    id: string;
-    name: string;
-    input: unknown;
-}
-/**
- * Union type for all message content blocks.
- * Includes known types and a fallback for unknown content types.
- */
-type ContentItem = TextContent | ToolResultContent | ToolUseContent | {
-    type: string;
-    text?: string;
-    name?: string;
-    input?: unknown;
-    content?: string;
-};
-/**
- * Message payload containing role and content.
- * Matches Anthropic API message structure.
- */
-interface MessagePayload {
-    role?: string;
-    content?: ContentItem[] | string;
-    model?: string;
-}
-/**
- * A single message in a Claude Code session.
- * Stored as a line in a JSONL session file.
- */
-interface Message extends TypedObject {
-    /** Unique identifier for this message */
-    uuid: string;
-    /** Parent message UUID for conversation threading */
-    parentUuid?: string | null;
-    /** Session ID this message belongs to */
-    sessionId?: string;
-    /** Timestamp in ISO format */
-    timestamp?: string;
-    /** Message content (nested payload structure) */
-    message?: MessagePayload;
-    /** Direct content (alternative to message.content) */
-    content?: ContentItem[] | string;
-    /** User-defined custom title for this message */
-    customTitle?: string;
-    /** Summary text for summary-type messages */
-    summary?: string;
-    /** Flag indicating this is a context continuation summary */
-    isCompactSummary?: boolean;
-    /** Tool use result text (for tool_result messages) */
-    toolUseResult?: string;
-}
-/** Basic metadata for a session, used in listings and summaries */
-interface SessionMeta {
-    id: string;
-    projectName: string;
-    title?: string;
-    messageCount: number;
-    createdAt?: string;
-    updatedAt?: string;
-}
-/** Project directory information */
-interface Project {
-    name: string;
-    displayName: string;
-    path: string;
-    sessionCount: number;
-}
-/** A single todo item from TodoWrite tool */
-interface TodoItem {
-    content: string;
-    status: 'pending' | 'in_progress' | 'completed';
-    /** Active form text shown during execution */
-    activeForm?: string;
-}
-/** Aggregated todos for a session including agent todos */
-interface SessionTodos {
-    sessionId: string;
-    sessionTodos: TodoItem[];
-    agentTodos: {
-        agentId: string;
-        todos: TodoItem[];
-    }[];
-    hasTodos: boolean;
-}
-/** A file modification recorded during a session */
-interface FileChange {
-    path: string;
-    action: 'created' | 'modified' | 'deleted';
-    timestamp?: string;
-    messageUuid?: string;
-}
-/** Summary of all file changes in a session */
-interface SessionFilesSummary {
-    sessionId: string;
-    projectName: string;
-    files: FileChange[];
-    totalChanges: number;
-}
-/** Result of deleting a session */
-interface DeleteSessionResult {
-    success: boolean;
-    backupPath?: string;
-    deletedAgents: number;
-    deletedTodos?: number;
-}
-/** Result of renaming a session */
-interface RenameSessionResult {
-    success: boolean;
-    error?: string;
-}
-/** Result of splitting a session at a message */
-interface SplitSessionResult {
-    success: boolean;
-    newSessionId?: string;
-    newSessionPath?: string;
-    movedMessageCount?: number;
-    duplicatedSummary?: boolean;
-    error?: string;
-}
-/** Result of moving a session to another project */
-interface MoveSessionResult {
-    success: boolean;
-    error?: string;
-}
-/** Result of clearing empty/invalid sessions */
-interface ClearSessionsResult {
-    success: boolean;
-    deletedCount: number;
-    removedMessageCount?: number;
-    deletedOrphanAgentCount?: number;
-    deletedOrphanTodoCount?: number;
-}
-/** Preview of sessions that would be cleaned up */
-interface CleanupPreview {
-    project: string;
-    emptySessions: SessionMeta[];
-    invalidSessions: SessionMeta[];
-    emptyWithTodosCount?: number;
-    orphanAgentCount?: number;
-    orphanTodoCount?: number;
-}
-/** A search result matching a session or message */
-interface SearchResult {
-    sessionId: string;
-    projectName: string;
-    title: string;
-    matchType: 'title' | 'content';
-    snippet?: string;
-    messageUuid?: string;
-    timestamp?: string;
-}
-/** Summary extracted from a session for display */
-interface SummaryInfo {
-    summary: string;
-    leafUuid?: string;
-    timestamp?: string;
-}
-/** Agent information for tree display */
-interface AgentInfo {
-    id: string;
-    name?: string;
-    messageCount: number;
-}
-/** Full session data for tree view rendering */
-interface SessionTreeData {
-    id: string;
-    projectName: string;
-    /** First user message title */
-    title: string;
-    /** User-set custom title */
-    customTitle?: string;
-    /** Current (first) summary text for display/tooltip */
-    currentSummary?: string;
-    messageCount: number;
-    createdAt?: string;
-    updatedAt?: string;
-    /** All summaries in reverse order (newest first) */
-    summaries: SummaryInfo[];
-    agents: AgentInfo[];
-    todos: SessionTodos;
-    /** UUID of last compact_boundary message */
-    lastCompactBoundaryUuid?: string;
-}
-/** Project with all sessions for tree view */
-interface ProjectTreeData {
-    name: string;
-    displayName: string;
-    path: string;
-    sessionCount: number;
-    sessions: SessionTreeData[];
-}
-
 interface Logger$1 {
     debug: (msg: string) => void;
     warn: (msg: string) => void;
@@ -266,6 +43,18 @@ declare const getRealPathFromSession: (folderName: string, sessionsDir?: string,
  * If path is under home directory, show relative (~/...)
  */
 declare const folderNameToPath: (folderName: string) => string;
+/**
+ * Find project folder name that matches the given workspace path
+ * Searches through all projects and checks if any session's cwd matches
+ *
+ * @param workspacePath - Absolute path of current workspace
+ * @param projectNames - List of project folder names to search
+ * @param sessionsDir - Optional sessions directory for testing
+ * @param fileSystem - Optional FileSystem for testing
+ * @param logger - Optional Logger for testing
+ * @returns Matching project folder name or null
+ */
+declare const findProjectByWorkspacePath: (workspacePath: string, projectNames: string[], sessionsDir?: string, fileSystem?: FileSystem, logger?: Logger$1) => string | null;
 
 /**
  * Utility functions for message processing
@@ -280,6 +69,22 @@ declare const isContinuationSummary: (msg: Message) => boolean;
  * Priority: customTitle > currentSummary (truncated) > title > fallback
  */
 declare const 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;
+/**
+ * Sort projects with priority:
+ * 1. Current project (if specified)
+ * 2. Current user's home directory subpaths
+ * 3. Others (alphabetically by displayName)
+ */
+declare const sortProjects: (projects: Project[], options?: {
+    currentProjectName?: string | null;
+    homeDir?: string;
+    filterEmpty?: boolean;
+}) => Project[];
 
 declare const findLinkedAgents: (projectName: string, sessionId: string) => Effect.Effect<string[], effect_Cause.UnknownException, never>;
 declare const findOrphanAgents: (projectName: string) => Effect.Effect<{
@@ -507,4 +312,4 @@ declare const getLogger: () => Logger;
  */
 declare const createLogger: (namespace: string) => Logger;
 
-export { type AgentInfo, type CleanupPreview, type ClearSessionsResult, type ContentItem, type DeleteSessionResult, type FileChange, type Logger, type Message, type MessagePayload, type MoveSessionResult, type Project, type ProjectTreeData, type RenameSessionResult, type SearchResult, type SessionFilesSummary, type SessionMeta, type SessionTodos, type SessionTreeData, type SplitSessionResult, type SummaryInfo, type TodoItem, clearSessions, createLogger, deleteLinkedTodos, deleteMessage, deleteOrphanAgents, deleteOrphanTodos, deleteSession, displayPathToFolderName, extractTextContent, extractTitle, findLinkedAgents, findLinkedTodos, findOrphanAgents, findOrphanTodos, folderNameToDisplayPath, folderNameToPath, getDisplayTitle, getLogger, getRealPathFromSession, getSessionFiles, getSessionsDir, getTodosDir, isContinuationSummary, isInvalidApiKeyMessage, listProjects, listSessions, loadAgentMessages, loadProjectTreeData, loadSessionTreeData, moveSession, pathToFolderName, previewCleanup, readSession, renameSession, restoreMessage, searchSessions, sessionHasTodos, setLogger, splitSession, updateSessionSummary };
+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 };

package/dist/index.js

@@ -135,6 +135,30 @@ var folderNameToPath = (folderName) => {
   const absolutePath = folderNameToDisplayPath(folderName);
   return toRelativePath(absolutePath, homeDir);
 };
+var findProjectByWorkspacePath = (workspacePath, projectNames, sessionsDir = getSessionsDir(), fileSystem = fs, logger2 = log) => {
+  const directMatch = pathToFolderName(workspacePath);
+  if (projectNames.includes(directMatch)) {
+    return directMatch;
+  }
+  for (const projectName of projectNames) {
+    const projectDir = path.join(sessionsDir, projectName);
+    try {
+      const files = fileSystem.readdirSync(projectDir).filter(isSessionFile);
+      for (const f of files) {
+        const cwd = tryGetCwdFromFile(path.join(projectDir, f), fileSystem, logger2);
+        if (cwd === workspacePath) {
+          logger2.debug(
+            `findProjectByWorkspacePath: ${workspacePath} -> found in ${projectName} (moved session)`
+          );
+          return projectName;
+        }
+      }
+    } catch {
+    }
+  }
+  logger2.debug(`findProjectByWorkspacePath: ${workspacePath} -> no matching project found`);
+  return null;
+};
 
 // src/utils.ts
 var logger = createLogger("utils");
@@ -186,22 +210,56 @@ var getDisplayTitle = (customTitle, currentSummary, title, maxLength = 60, fallb
   if (title && title !== "Untitled") return title;
   return fallback;
 };
+var replaceMessageContent = (msg, text) => ({
+  ...msg,
+  message: {
+    ...msg.message,
+    content: [{ type: "text", text }]
+  },
+  toolUseResult: void 0
+});
 var cleanupSplitFirstMessage = (msg) => {
   const toolUseResult = msg.toolUseResult;
   if (!toolUseResult) return msg;
-  const rejectionMarker = "The user provided the following reason for the rejection:";
-  const rejectionIndex = toolUseResult.indexOf(rejectionMarker);
-  if (rejectionIndex === -1) return msg;
-  const text = toolUseResult.slice(rejectionIndex + rejectionMarker.length).trim();
-  if (!text) return msg;
-  return {
-    ...msg,
-    message: {
-      ...msg.message,
-      content: [{ type: "text", text }]
-    },
-    toolUseResult: void 0
-  };
+  if (typeof toolUseResult === "object" && "answers" in toolUseResult) {
+    const answers = toolUseResult.answers;
+    const qaText = Object.entries(answers).map(([q, a]) => `Q: ${q}
+A: ${a}`).join("\n\n");
+    return replaceMessageContent(msg, qaText);
+  }
+  if (typeof toolUseResult === "string") {
+    const rejectionMarker = "The user provided the following reason for the rejection:";
+    const rejectionIndex = toolUseResult.indexOf(rejectionMarker);
+    if (rejectionIndex === -1) return msg;
+    const text = toolUseResult.slice(rejectionIndex + rejectionMarker.length).trim();
+    if (!text) return msg;
+    return replaceMessageContent(msg, text);
+  }
+  return msg;
+};
+var maskHomePath = (text, homeDir) => {
+  if (!homeDir) return text;
+  const escapedHome = homeDir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const regex = new RegExp(`${escapedHome}(?=[/\\\\]|$)`, "g");
+  return text.replace(regex, "~");
+};
+var sortProjects = (projects, options = {}) => {
+  const { currentProjectName, homeDir, filterEmpty = true } = options;
+  const filtered = filterEmpty ? projects.filter((p) => p.sessionCount > 0) : projects;
+  const homeDirPrefix = homeDir ? pathToFolderName(homeDir) : null;
+  return filtered.sort((a, b) => {
+    if (currentProjectName) {
+      if (a.name === currentProjectName) return -1;
+      if (b.name === currentProjectName) return 1;
+    }
+    if (homeDirPrefix) {
+      const aIsUserHome = a.name.startsWith(homeDirPrefix);
+      const bIsUserHome = b.name.startsWith(homeDirPrefix);
+      if (aIsUserHome && !bIsUserHome) return -1;
+      if (!aIsUserHome && bIsUserHome) return 1;
+    }
+    return a.displayName.localeCompare(b.displayName);
+  });
 };
 
 // src/agents.ts
@@ -847,36 +905,40 @@ var splitSession = (projectName, sessionId, splitAtMessageUuid) => Effect3.gen(f
   const summaryMessage = summaryMessages.length > 0 ? summaryMessages[summaryMessages.length - 1] : null;
   const splitMessage = allMessages[splitIndex];
   const shouldDuplicate = isContinuationSummary(splitMessage);
-  let remainingMessages;
-  const movedMessages = allMessages.slice(splitIndex);
+  let keptMessages = allMessages.slice(splitIndex);
+  let movedMessages;
   if (shouldDuplicate) {
     const duplicatedMessage = {
       ...splitMessage,
       uuid: crypto.randomUUID(),
-      sessionId
-      // Keep original session ID
+      sessionId: newSessionId
     };
-    remainingMessages = [...allMessages.slice(0, splitIndex), duplicatedMessage];
+    movedMessages = [...allMessages.slice(0, splitIndex), duplicatedMessage];
   } else {
-    remainingMessages = allMessages.slice(0, splitIndex);
+    movedMessages = allMessages.slice(0, splitIndex);
   }
-  const updatedMovedMessages = movedMessages.map((msg, index) => {
-    let updated = { ...msg, sessionId: newSessionId };
+  keptMessages = keptMessages.map((msg, index) => {
+    let updated = { ...msg };
     if (index === 0) {
       updated.parentUuid = null;
       updated = cleanupSplitFirstMessage(updated);
     }
     return updated;
   });
+  const updatedMovedMessages = movedMessages.map((msg) => ({
+    ...msg,
+    sessionId: newSessionId
+  }));
   if (summaryMessage) {
     const clonedSummary = {
       ...summaryMessage,
+      sessionId: newSessionId,
       leafUuid: updatedMovedMessages[0]?.uuid ?? null
     };
     updatedMovedMessages.unshift(clonedSummary);
   }
-  const remainingContent = remainingMessages.map((m) => JSON.stringify(m)).join("\n") + "\n";
-  yield* Effect3.tryPromise(() => fs4.writeFile(filePath, remainingContent, "utf-8"));
+  const keptContent = keptMessages.map((m) => JSON.stringify(m)).join("\n") + "\n";
+  yield* Effect3.tryPromise(() => fs4.writeFile(filePath, keptContent, "utf-8"));
   const newFilePath = path4.join(projectPath, `${newSessionId}.jsonl`);
   const newContent = updatedMovedMessages.map((m) => JSON.stringify(m)).join("\n") + "\n";
   yield* Effect3.tryPromise(() => fs4.writeFile(newFilePath, newContent, "utf-8"));
@@ -1367,6 +1429,7 @@ export {
   findLinkedTodos,
   findOrphanAgents,
   findOrphanTodos,
+  findProjectByWorkspacePath,
   folderNameToDisplayPath,
   folderNameToPath,
   getDisplayTitle,
@@ -1382,6 +1445,7 @@ export {
   loadAgentMessages,
   loadProjectTreeData,
   loadSessionTreeData,
+  maskHomePath,
   moveSession,
   pathToFolderName,
   previewCleanup,
@@ -1391,6 +1455,7 @@ export {
   searchSessions,
   sessionHasTodos,
   setLogger,
+  sortProjects,
   splitSession,
   updateSessionSummary
 };