@claude-sessions/core 0.3.1 → 0.3.3

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+import { l as ResumeSessionOptions, m as ResumeSessionResult } from './types-C2fzbmg9.js';
+
+/**
+ * Resume a session using claude CLI
+ * On macOS: opens Terminal.app with claude --resume command
+ * On other platforms: spawns a detached process with appropriate terminal
+ */
+declare const resumeSession: (options: ResumeSessionOptions) => ResumeSessionResult;
+
+export { ResumeSessionOptions, ResumeSessionResult, resumeSession };

package/dist/server.js

@@ -0,0 +1,66 @@
+// src/resume.ts
+import { spawn } from "child_process";
+var resumeSession = (options) => {
+  const { sessionId, cwd, fork = false, args = [] } = options;
+  try {
+    const claudeArgs = ["--resume", sessionId];
+    if (fork) {
+      claudeArgs.push("--fork-session");
+    }
+    claudeArgs.push(...args);
+    const claudeCommand = `claude ${claudeArgs.join(" ")}`;
+    const workingDir = cwd ?? process.cwd();
+    if (process.platform === "darwin") {
+      const escapedDir = workingDir.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+      const escapedCmd = claudeCommand.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+      const script = `
+tell application "Terminal"
+  activate
+  set newWindow to do script "cd \\"${escapedDir}\\" && ${escapedCmd}"
+  set frontmost of newWindow to true
+end tell
+tell application "System Events"
+  set frontmost of process "Terminal" to true
+end tell
+`;
+      const child = spawn("osascript", ["-e", script], {
+        detached: true,
+        stdio: "ignore"
+      });
+      child.unref();
+      return { success: true, pid: child.pid };
+    }
+    if (process.platform === "win32") {
+      const child = spawn("cmd", ["/c", "start", "cmd", "/k", claudeCommand], {
+        cwd: workingDir,
+        detached: true,
+        stdio: "ignore"
+      });
+      child.unref();
+      return { success: true, pid: child.pid };
+    }
+    const terminals = ["gnome-terminal", "konsole", "xterm"];
+    for (const term of terminals) {
+      try {
+        const child = spawn(term, ["--", "bash", "-c", `cd "${workingDir}" && ${claudeCommand}`], {
+          detached: true,
+          stdio: "ignore"
+        });
+        child.unref();
+        return { success: true, pid: child.pid };
+      } catch {
+        continue;
+      }
+    }
+    return { success: false, error: "No supported terminal emulator found" };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+};
+export {
+  resumeSession
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resume.ts"],"sourcesContent":["/**\n * Resume session functionality - Server-side only\n * This module uses child_process and should NOT be imported in browser environments\n */\nimport { spawn } from 'node:child_process'\nimport type { ResumeSessionOptions, ResumeSessionResult } from './types.js'\n\n/**\n * Resume a session using claude CLI\n * On macOS: opens Terminal.app with claude --resume command\n * On other platforms: spawns a detached process with appropriate terminal\n */\nexport const resumeSession = (options: ResumeSessionOptions): ResumeSessionResult => {\n  const { sessionId, cwd, fork = false, args = [] } = options\n\n  try {\n    const claudeArgs = ['--resume', sessionId]\n    if (fork) {\n      claudeArgs.push('--fork-session')\n    }\n    claudeArgs.push(...args)\n\n    const claudeCommand = `claude ${claudeArgs.join(' ')}`\n    const workingDir = cwd ?? process.cwd()\n\n    // macOS: use osascript to open Terminal.app and run command\n    if (process.platform === 'darwin') {\n      // AppleScript to open new Terminal window, cd to directory, and run command\n      const escapedDir = workingDir.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')\n      const escapedCmd = claudeCommand.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')\n      const script = `\ntell application \"Terminal\"\n  activate\n  set newWindow to do script \"cd \\\\\"${escapedDir}\\\\\" && ${escapedCmd}\"\n  set frontmost of newWindow to true\nend tell\ntell application \"System Events\"\n  set frontmost of process \"Terminal\" to true\nend tell\n`\n      const child = spawn('osascript', ['-e', script], {\n        detached: true,\n        stdio: 'ignore',\n      })\n      child.unref()\n\n      return { success: true, pid: child.pid }\n    }\n\n    // Windows: use start cmd\n    if (process.platform === 'win32') {\n      const child = spawn('cmd', ['/c', 'start', 'cmd', '/k', claudeCommand], {\n        cwd: workingDir,\n        detached: true,\n        stdio: 'ignore',\n      })\n      child.unref()\n\n      return { success: true, pid: child.pid }\n    }\n\n    // Linux: try common terminal emulators\n    const terminals = ['gnome-terminal', 'konsole', 'xterm']\n    for (const term of terminals) {\n      try {\n        const child = spawn(term, ['--', 'bash', '-c', `cd \"${workingDir}\" && ${claudeCommand}`], {\n          detached: true,\n          stdio: 'ignore',\n        })\n        child.unref()\n        return { success: true, pid: child.pid }\n      } catch {\n        continue\n      }\n    }\n\n    return { success: false, error: 'No supported terminal emulator found' }\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n    }\n  }\n}\n"],"mappings":";AAIA,SAAS,aAAa;AAQf,IAAM,gBAAgB,CAAC,YAAuD;AACnF,QAAM,EAAE,WAAW,KAAK,OAAO,OAAO,OAAO,CAAC,EAAE,IAAI;AAEpD,MAAI;AACF,UAAM,aAAa,CAAC,YAAY,SAAS;AACzC,QAAI,MAAM;AACR,iBAAW,KAAK,gBAAgB;AAAA,IAClC;AACA,eAAW,KAAK,GAAG,IAAI;AAEvB,UAAM,gBAAgB,UAAU,WAAW,KAAK,GAAG,CAAC;AACpD,UAAM,aAAa,OAAO,QAAQ,IAAI;AAGtC,QAAI,QAAQ,aAAa,UAAU;AAEjC,YAAM,aAAa,WAAW,QAAQ,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAK;AACxE,YAAM,aAAa,cAAc,QAAQ,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAK;AAC3E,YAAM,SAAS;AAAA;AAAA;AAAA,sCAGiB,UAAU,UAAU,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAO9D,YAAM,QAAQ,MAAM,aAAa,CAAC,MAAM,MAAM,GAAG;AAAA,QAC/C,UAAU;AAAA,QACV,OAAO;AAAA,MACT,CAAC;AACD,YAAM,MAAM;AAEZ,aAAO,EAAE,SAAS,MAAM,KAAK,MAAM,IAAI;AAAA,IACzC;AAGA,QAAI,QAAQ,aAAa,SAAS;AAChC,YAAM,QAAQ,MAAM,OAAO,CAAC,MAAM,SAAS,OAAO,MAAM,aAAa,GAAG;AAAA,QACtE,KAAK;AAAA,QACL,UAAU;AAAA,QACV,OAAO;AAAA,MACT,CAAC;AACD,YAAM,MAAM;AAEZ,aAAO,EAAE,SAAS,MAAM,KAAK,MAAM,IAAI;AAAA,IACzC;AAGA,UAAM,YAAY,CAAC,kBAAkB,WAAW,OAAO;AACvD,eAAW,QAAQ,WAAW;AAC5B,UAAI;AACF,cAAM,QAAQ,MAAM,MAAM,CAAC,MAAM,QAAQ,MAAM,OAAO,UAAU,QAAQ,aAAa,EAAE,GAAG;AAAA,UACxF,UAAU;AAAA,UACV,OAAO;AAAA,QACT,CAAC;AACD,cAAM,MAAM;AACZ,eAAO,EAAE,SAAS,MAAM,KAAK,MAAM,IAAI;AAAA,MACzC,QAAQ;AACN;AAAA,MACF;AAAA,IACF;AAEA,WAAO,EAAE,SAAS,OAAO,OAAO,uCAAuC;AAAA,EACzE,SAAS,OAAO;AACd,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,IAC9D;AAAA,EACF;AACF;","names":[]}

package/dist/types-C2fzbmg9.d.ts

@@ -0,0 +1,264 @@
+/**
+ * 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;
+}
+/**
+ * AskUserQuestion tool response with questions and user answers.
+ */
+interface AskUserQuestionResult {
+    questions: Array<{
+        question: string;
+        header: string;
+        options: Array<{
+            label: string;
+            description: string;
+        }>;
+        multiSelect: boolean;
+    }>;
+    answers: Record<string, string>;
+}
+/**
+ * Tool use result - either a string (rejection reason) or AskUserQuestion response.
+ */
+type ToolUseResult = string | AskUserQuestionResult;
+/**
+ * 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 (string for rejections, AskUserQuestionResult for Q&A) */
+    toolUseResult?: ToolUseResult;
+}
+/** 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[];
+}
+/** Options for resuming a session */
+interface ResumeSessionOptions {
+    /** Session ID to resume */
+    sessionId: string;
+    /** Working directory for the claude process */
+    cwd?: string;
+    /** Whether to fork the session instead of continuing */
+    fork?: boolean;
+    /** Additional arguments to pass to claude */
+    args?: string[];
+}
+/** Result of spawning a resume session process */
+interface ResumeSessionResult {
+    success: boolean;
+    /** Process ID if spawned successfully */
+    pid?: number;
+    /** Error message if failed */
+    error?: string;
+}
+
+export type { AgentInfo as A, ContentItem as C, DeleteSessionResult as D, FileChange as F, MessagePayload as M, Project as P, RenameSessionResult as R, SearchResult as S, TodoItem as T, Message as a, MoveSessionResult as b, SummaryInfo as c, SessionMeta as d, SessionTodos as e, SessionFilesSummary as f, SplitSessionResult as g, ClearSessionsResult as h, CleanupPreview as i, SessionTreeData as j, ProjectTreeData as k, ResumeSessionOptions as l, ResumeSessionResult as m };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-sessions/core",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Core library for Claude Code session management",
   "type": "module",
   "license": "MIT",
@@ -14,6 +14,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
     }
   },
   "files": [