ccprofiles-core 0.5.1 → 0.7.0

package/dist/sessions.js

@@ -1,11 +1,54 @@
 import { readdir, readFile, stat, lstat } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
+const SAFE_SESSION_ID = /^[A-Za-z0-9_-]{1,160}$/;
+const MAX_ENTRY_CHARS = 100_000;
+const claudeSessionCache = new Map();
+const codexSessionCache = new Map();
+/** Per-file cap: a transcript above this size is summarized without reading its content. */
+const MAX_FILE_SCAN_BYTES = 10 * 1024 * 1024;
+/** Per-request cap: once this many bytes have been read from disk in one scanSessions() call,
+ *  remaining (uncached) files are summarized without reading their content either. */
+const MAX_TOTAL_SCAN_BYTES = 50 * 1024 * 1024;
+let scanCacheHits = 0;
+let scanCacheMisses = 0;
+/** Test/observability hook: cumulative cache hit/miss counts across all scanSessions() calls
+ *  in this process. Not reset automatically — callers that need deltas should diff two reads. */
+export function sessionScanCacheStats() {
+    return { hits: scanCacheHits, misses: scanCacheMisses };
+}
 /** Best-effort decode of Claude Code's project dir name (cwd from a record is preferred). */
 export function decodeProjectDir(name) {
     return name.replace(/^-/, '/').replace(/-/g, '/');
 }
-async function parseClaudeSession(file) {
+/**
+ * Shared mtime+size cache lookup for the two session-file formats. `parseFull` runs only on a
+ * cache miss with a fresh read; `makeTruncated` builds a summary-only result when the file is
+ * over the per-file cap or the per-request byte budget is exhausted. A size-cap truncation is
+ * deterministic (depends only on the file) and gets cached; a budget-cap truncation depends on
+ * request ordering, so it is *not* cached — a later request with a fresh budget may read it fully.
+ */
+async function cachedParse(file, cache, budget, parseFull, makeTruncated) {
+    let st;
+    try {
+        st = await stat(file);
+    }
+    catch {
+        return null;
+    }
+    const cached = cache.get(file);
+    if (cached && cached.mtimeMs === st.mtimeMs && cached.size === st.size) {
+        scanCacheHits++;
+        return cached.result;
+    }
+    scanCacheMisses++;
+    if (st.size > MAX_FILE_SCAN_BYTES) {
+        const result = makeTruncated(st);
+        cache.set(file, { mtimeMs: st.mtimeMs, size: st.size, result });
+        return result;
+    }
+    if (st.size > budget.bytesLeft)
+        return makeTruncated(st); // not cached — budget is per-request
     let raw;
     try {
         raw = await readFile(file, 'utf8');
@@ -13,36 +56,43 @@ async function parseClaudeSession(file) {
     catch {
         return null;
     }
-    const st = await stat(file);
-    const lines = raw.split('\n').filter(l => l.trim());
-    let firstPrompt = null, gitBranch = null, model = null, cwd = null;
-    for (const line of lines) {
-        let rec;
-        try {
-            rec = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        if (cwd === null && typeof rec.cwd === 'string')
-            cwd = rec.cwd;
-        if (gitBranch === null && typeof rec.gitBranch === 'string')
-            gitBranch = rec.gitBranch;
-        if (firstPrompt === null && rec.type === 'user') {
-            const c = rec.message?.content;
-            const text = typeof c === 'string' ? c : Array.isArray(c) ? c.find((x) => x?.type === 'text')?.text : null;
-            if (typeof text === 'string' && text.trim() && !text.trimStart().startsWith('<'))
-                firstPrompt = text.trim().slice(0, 200);
-        }
-        if (model === null && typeof rec.message?.model === 'string')
-            model = rec.message.model;
-        if (firstPrompt && model && gitBranch && cwd)
-            break;
-    }
+    budget.bytesLeft -= st.size;
+    const result = parseFull(raw, st);
+    cache.set(file, { mtimeMs: st.mtimeMs, size: st.size, result });
+    return result;
+}
+async function parseClaudeSession(file, budget) {
     const id = file.split(/[\\/]/).pop().replace(/\.jsonl$/, '');
-    return { meta: { id, mtime: st.mtimeMs, messageCount: lines.length, firstPrompt, gitBranch, model, sizeBytes: st.size }, cwd };
+    return cachedParse(file, claudeSessionCache, budget, (raw, st) => {
+        const lines = raw.split('\n').filter(l => l.trim());
+        let firstPrompt = null, gitBranch = null, model = null, cwd = null;
+        for (const line of lines) {
+            let rec;
+            try {
+                rec = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (cwd === null && typeof rec.cwd === 'string')
+                cwd = rec.cwd;
+            if (gitBranch === null && typeof rec.gitBranch === 'string')
+                gitBranch = rec.gitBranch;
+            if (firstPrompt === null && rec.type === 'user') {
+                const c = rec.message?.content;
+                const text = typeof c === 'string' ? c : Array.isArray(c) ? c.find((x) => x?.type === 'text')?.text : null;
+                if (typeof text === 'string' && text.trim() && !text.trimStart().startsWith('<'))
+                    firstPrompt = text.trim().slice(0, 200);
+            }
+            if (model === null && typeof rec.message?.model === 'string')
+                model = rec.message.model;
+            if (firstPrompt && model && gitBranch && cwd)
+                break;
+        }
+        return { meta: { id, mtime: st.mtimeMs, messageCount: lines.length, firstPrompt, gitBranch, model, sizeBytes: st.size }, cwd };
+    }, st => ({ meta: { id, mtime: st.mtimeMs, messageCount: 0, firstPrompt: null, gitBranch: null, model: null, sizeBytes: st.size, truncated: true }, cwd: null }));
 }
-async function scanProjectsDir(projectsDir, scope) {
+async function scanProjectsDir(projectsDir, scope, budget) {
     if (!existsSync(projectsDir))
         return [];
     const out = [];
@@ -69,7 +119,7 @@ async function scanProjectsDir(projectsDir, scope) {
         for (const f of files) {
             if (!f.endsWith('.jsonl'))
                 continue;
-            const parsed = await parseClaudeSession(join(pdir, f));
+            const parsed = await parseClaudeSession(join(pdir, f), budget);
             if (!parsed)
                 continue;
             sessions.push(parsed.meta);
@@ -88,10 +138,40 @@ function messageText(content) {
         return content;
     if (!Array.isArray(content))
         return null;
-    const item = content.find((x) => x?.type === 'input_text' || x?.type === 'text');
-    return typeof item?.text === 'string' ? item.text : null;
+    const texts = content
+        .filter((x) => x?.type === 'input_text' || x?.type === 'output_text' || x?.type === 'text')
+        .map((x) => x.text)
+        .filter((x) => typeof x === 'string');
+    return texts.length ? texts.join('\n\n') : null;
+}
+function limited(text) {
+    return text.length <= MAX_ENTRY_CHARS ? text : `${text.slice(0, MAX_ENTRY_CHARS)}\n\n[entry truncated for display]`;
+}
+function toolText(value) {
+    if (typeof value === 'string')
+        return value;
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+function pushEntry(messages, role, text, label, timestamp) {
+    const clean = text?.trim();
+    if (!clean)
+        return;
+    if (role === 'user' && /^<(system-reminder|local-command-caveat|command-name)>/i.test(clean))
+        return;
+    const previous = messages.at(-1);
+    if (previous?.role === role && previous.text === clean)
+        return;
+    messages.push({
+        id: String(messages.length + 1), role, text: limited(clean), label,
+        timestamp: typeof timestamp === 'string' ? timestamp : null,
+    });
 }
-async function parseCodexSession(file) {
+async function parseClaudeTranscript(file, scope) {
     let raw;
     try {
         raw = await readFile(file, 'utf8');
@@ -99,11 +179,12 @@ async function parseCodexSession(file) {
     catch {
         return null;
     }
-    const st = await stat(file);
-    const lines = raw.split('\n').filter(l => l.trim());
-    let id = null, firstPrompt = null, gitBranch = null;
-    let model = null, cwd = null, messageCount = 0;
-    for (const line of lines) {
+    const id = file.split(/[\\/]/).pop().replace(/\.jsonl$/, '');
+    const messages = [];
+    let project = '(unknown project)';
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
         let rec;
         try {
             rec = JSON.parse(line);
@@ -111,6 +192,51 @@ async function parseCodexSession(file) {
         catch {
             continue;
         }
+        if (project === '(unknown project)' && typeof rec.cwd === 'string')
+            project = rec.cwd;
+        const content = rec.message?.content;
+        if (rec.type === 'user') {
+            pushEntry(messages, 'user', messageText(content), null, rec.timestamp);
+            if (Array.isArray(content))
+                for (const block of content) {
+                    if (block?.type === 'tool_result')
+                        pushEntry(messages, 'tool', messageText(block.content) ?? toolText(block.content), 'Tool result', rec.timestamp);
+                }
+        }
+        else if (rec.type === 'assistant') {
+            pushEntry(messages, 'assistant', messageText(content), null, rec.timestamp);
+            if (Array.isArray(content))
+                for (const block of content) {
+                    if (block?.type === 'tool_use')
+                        pushEntry(messages, 'tool', toolText(block.input), typeof block.name === 'string' ? block.name : 'Tool call', rec.timestamp);
+                }
+        }
+    }
+    return { id, agent: 'claude', scope, project, messages };
+}
+async function parseCodexTranscript(file, scope) {
+    let raw;
+    try {
+        raw = await readFile(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const records = [];
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            records.push(JSON.parse(line));
+        }
+        catch { /* malformed line */ }
+    }
+    const filename = file.split(/[\\/]/).pop().replace(/\.jsonl$/, '');
+    let id = filename.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i)?.[0] ?? filename;
+    let project = '(unknown project)';
+    const hasResponseMessages = records.some(rec => rec?.type === 'response_item' && rec?.payload?.type === 'message');
+    const messages = [];
+    for (const rec of records) {
         const payload = rec?.payload;
         if (rec?.type === 'session_meta') {
             if (typeof payload?.id === 'string')
@@ -118,33 +244,77 @@ async function parseCodexSession(file) {
             else if (typeof payload?.session_id === 'string')
                 id = payload.session_id;
             if (typeof payload?.cwd === 'string')
-                cwd = payload.cwd;
-            if (typeof payload?.git?.branch === 'string')
-                gitBranch = payload.git.branch;
-        }
-        if (rec?.type === 'turn_context') {
-            if (cwd === null && typeof payload?.cwd === 'string')
-                cwd = payload.cwd;
-            if (model === null && typeof payload?.model === 'string')
-                model = payload.model;
-        }
-        if (rec?.type === 'response_item' && payload?.type === 'message'
-            && (payload?.role === 'user' || payload?.role === 'assistant')) {
-            messageCount++;
-            if (firstPrompt === null && payload.role === 'user') {
-                const text = messageText(payload.content);
-                if (text?.trim() && !text.trimStart().startsWith('<'))
-                    firstPrompt = text.trim().slice(0, 200);
-            }
+                project = payload.cwd;
+            continue;
+        }
+        if (project === '(unknown project)' && rec?.type === 'turn_context' && typeof payload?.cwd === 'string')
+            project = payload.cwd;
+        if (rec?.type === 'response_item') {
+            if (payload?.type === 'message' && (payload.role === 'user' || payload.role === 'assistant'))
+                pushEntry(messages, payload.role, messageText(payload.content), null, rec.timestamp);
+            else if (payload?.type === 'function_call' || payload?.type === 'custom_tool_call' || payload?.type === 'local_shell_call')
+                pushEntry(messages, 'tool', toolText(payload.arguments ?? payload.input ?? payload), payload.name ?? payload.type, rec.timestamp);
+            else if (payload?.type === 'function_call_output' || payload?.type === 'custom_tool_call_output')
+                pushEntry(messages, 'tool', toolText(payload.output), 'Tool result', rec.timestamp);
         }
-        if (firstPrompt === null && rec?.type === 'event_msg' && payload?.type === 'user_message'
-            && typeof payload?.message === 'string' && payload.message.trim()) {
-            firstPrompt = payload.message.trim().slice(0, 200);
+        else if (!hasResponseMessages && rec?.type === 'event_msg') {
+            if (payload?.type === 'user_message')
+                pushEntry(messages, 'user', payload.message, null, rec.timestamp);
+            else if (payload?.type === 'agent_message')
+                pushEntry(messages, 'assistant', payload.message, null, rec.timestamp);
         }
     }
+    return { id, agent: 'codex', scope, project, messages };
+}
+async function parseCodexSession(file, budget) {
     const filename = file.split(/[\\/]/).pop().replace(/\.jsonl$/, '');
-    id ??= filename.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i)?.[0] ?? filename;
-    return { meta: { id, mtime: st.mtimeMs, messageCount: messageCount || lines.length, firstPrompt, gitBranch, model, sizeBytes: st.size }, cwd };
+    const fallbackId = filename.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i)?.[0] ?? filename;
+    return cachedParse(file, codexSessionCache, budget, (raw, st) => {
+        const lines = raw.split('\n').filter(l => l.trim());
+        let id = null, firstPrompt = null, gitBranch = null;
+        let model = null, cwd = null, messageCount = 0;
+        for (const line of lines) {
+            let rec;
+            try {
+                rec = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            const payload = rec?.payload;
+            if (rec?.type === 'session_meta') {
+                if (typeof payload?.id === 'string')
+                    id = payload.id;
+                else if (typeof payload?.session_id === 'string')
+                    id = payload.session_id;
+                if (typeof payload?.cwd === 'string')
+                    cwd = payload.cwd;
+                if (typeof payload?.git?.branch === 'string')
+                    gitBranch = payload.git.branch;
+            }
+            if (rec?.type === 'turn_context') {
+                if (cwd === null && typeof payload?.cwd === 'string')
+                    cwd = payload.cwd;
+                if (model === null && typeof payload?.model === 'string')
+                    model = payload.model;
+            }
+            if (rec?.type === 'response_item' && payload?.type === 'message'
+                && (payload?.role === 'user' || payload?.role === 'assistant')) {
+                messageCount++;
+                if (firstPrompt === null && payload.role === 'user') {
+                    const text = messageText(payload.content);
+                    if (text?.trim() && !text.trimStart().startsWith('<'))
+                        firstPrompt = text.trim().slice(0, 200);
+                }
+            }
+            if (firstPrompt === null && rec?.type === 'event_msg' && payload?.type === 'user_message'
+                && typeof payload?.message === 'string' && payload.message.trim()) {
+                firstPrompt = payload.message.trim().slice(0, 200);
+            }
+        }
+        id ??= fallbackId;
+        return { meta: { id, mtime: st.mtimeMs, messageCount: messageCount || lines.length, firstPrompt, gitBranch, model, sizeBytes: st.size }, cwd };
+    }, st => ({ meta: { id: fallbackId, mtime: st.mtimeMs, messageCount: 0, firstPrompt: null, gitBranch: null, model: null, sizeBytes: st.size, truncated: true }, cwd: null }));
 }
 async function codexSessionFiles(dir) {
     let entries;
@@ -164,10 +334,30 @@ async function codexSessionFiles(dir) {
     }
     return out;
 }
-async function scanCodexSessionsDir(sessionsDir, scope) {
+async function claudeSessionFile(projectsDir, id) {
+    let projects;
+    try {
+        projects = await readdir(projectsDir, { withFileTypes: true });
+    }
+    catch {
+        return null;
+    }
+    for (const project of projects) {
+        if (!project.isDirectory())
+            continue;
+        const file = join(projectsDir, project.name, `${id}.jsonl`);
+        try {
+            if ((await stat(file)).isFile())
+                return file;
+        }
+        catch { /* keep looking */ }
+    }
+    return null;
+}
+async function scanCodexSessionsDir(sessionsDir, scope, budget) {
     const byProject = new Map();
     for (const file of await codexSessionFiles(sessionsDir)) {
-        const parsed = await parseCodexSession(file);
+        const parsed = await parseCodexSession(file, budget);
         if (!parsed)
             continue;
         const project = parsed.cwd ?? '(unknown project)';
@@ -181,9 +371,10 @@ async function scanCodexSessionsDir(sessionsDir, scope) {
     }));
 }
 export async function scanSessions(opts) {
+    const budget = { bytesLeft: MAX_TOTAL_SCAN_BYTES };
     const out = [];
-    out.push(...await scanProjectsDir(join(opts.sharedRoot, 'projects'), 'shared'));
-    out.push(...await scanCodexSessionsDir(join(opts.sharedRoot, 'sessions'), 'shared'));
+    out.push(...await scanProjectsDir(join(opts.sharedRoot, 'projects'), 'shared', budget));
+    out.push(...await scanCodexSessionsDir(join(opts.sharedRoot, 'sessions'), 'shared', budget));
     for (const p of opts.profiles) {
         const agent = p.agent ?? 'claude';
         const sessionDir = join(p.dir, agent === 'codex' ? 'sessions' : 'projects');
@@ -195,8 +386,41 @@ export async function scanSessions(opts) {
             continue;
         }
         out.push(...agent === 'codex'
-            ? await scanCodexSessionsDir(sessionDir, p.name)
-            : await scanProjectsDir(sessionDir, p.name));
+            ? await scanCodexSessionsDir(sessionDir, p.name, budget)
+            : await scanProjectsDir(sessionDir, p.name, budget));
     }
     return out;
 }
+/** Read visible conversation and tool activity for one known managed session. */
+export async function readSessionTranscript(opts) {
+    if (!SAFE_SESSION_ID.test(opts.id))
+        return null;
+    let root;
+    if (opts.scope === 'shared')
+        root = join(opts.sharedRoot, opts.agent === 'codex' ? 'sessions' : 'projects');
+    else {
+        const profile = opts.profiles.find(p => p.name === opts.scope && (p.agent ?? 'claude') === opts.agent);
+        if (!profile)
+            return null;
+        root = join(profile.dir, opts.agent === 'codex' ? 'sessions' : 'projects');
+        try {
+            if ((await lstat(root)).isSymbolicLink())
+                return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    if (opts.agent === 'claude') {
+        const file = await claudeSessionFile(root, opts.id);
+        return file ? parseClaudeTranscript(file, opts.scope) : null;
+    }
+    const files = await codexSessionFiles(root);
+    files.sort((a, b) => Number(!a.includes(opts.id)) - Number(!b.includes(opts.id)));
+    for (const file of files) {
+        const transcript = await parseCodexTranscript(file, opts.scope);
+        if (transcript?.id === opts.id)
+            return transcript;
+    }
+    return null;
+}

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "ccprofiles-core",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Core library for ccprofiles — discovery, manifest, secrets, apply, and LAN sync for Claude Code multi-account setups",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "license": "MIT",
   "funding": {
@@ -34,5 +41,8 @@
     "smol-toml": "^1.7.0",
     "yaml": "^2.5.0",
     "zod": "^3.23.0"
+  },
+  "scripts": {
+    "prepack": "cd ../.. && npm run build"
   }
 }