agentacta 1.1.4 → 1.1.5

package/README.md

@@ -108,7 +108,8 @@ On first run, AgentActa creates a config file with sensible defaults at `~/.conf
   "port": 4003,
   "storage": "reference",
   "sessionsPath": null,
-  "dbPath": "./agentacta.db"
+  "dbPath": "./agentacta.db",
+  "projectAliases": {}
 }
 ```
 
@@ -126,6 +127,7 @@ On first run, AgentActa creates a config file with sensible defaults at `~/.conf
 | `AGENTACTA_SESSIONS_PATH` | Auto-detected | Custom sessions directory |
 | `AGENTACTA_DB_PATH` | `./agentacta.db` | Database file location |
 | `AGENTACTA_STORAGE` | `reference` | Storage mode (`reference` or `archive`) |
+| `AGENTACTA_PROJECT_ALIASES_JSON` | unset | JSON object mapping inferred project names (e.g. `{"old-name":"new-name"}`) |
 
 ## API
 

package/config.js

@@ -18,7 +18,8 @@ const DEFAULTS = {
   port: 4003,
   storage: 'reference',
   sessionsPath: null,
-  dbPath: './agentacta.db'
+  dbPath: './agentacta.db',
+  projectAliases: {}
 };
 
 function loadConfig() {
@@ -45,9 +46,17 @@ function loadConfig() {
   if (process.env.AGENTACTA_STORAGE) config.storage = process.env.AGENTACTA_STORAGE;
   if (process.env.AGENTACTA_SESSIONS_PATH) config.sessionsPath = process.env.AGENTACTA_SESSIONS_PATH;
   if (process.env.AGENTACTA_DB_PATH) config.dbPath = process.env.AGENTACTA_DB_PATH;
+  if (process.env.AGENTACTA_PROJECT_ALIASES_JSON) {
+    try {
+      config.projectAliases = JSON.parse(process.env.AGENTACTA_PROJECT_ALIASES_JSON);
+    } catch (err) {
+      console.error('Warning: Could not parse AGENTACTA_PROJECT_ALIASES_JSON:', err.message);
+    }
+  }
 
   // Resolve dbPath relative to cwd
   config.dbPath = path.resolve(config.dbPath);
+  if (!config.projectAliases || typeof config.projectAliases !== 'object') config.projectAliases = {};
 
   return config;
 }

package/index.js

@@ -97,6 +97,31 @@ function getDbSize() {
   }
 }
 
+function normalizeAgentLabel(agent) {
+  if (!agent) return agent;
+  if (agent === 'main') return 'openclaw-main';
+  if (agent.startsWith('claude-') || agent.startsWith('claude--')) return 'claude-code';
+  return agent;
+}
+
+function looksLikeSessionId(q) {
+  const s = (q || '').trim();
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(s);
+}
+
+function toFtsQuery(q) {
+  const s = (q || '').trim();
+  if (!s) return '';
+  // Quote each token so dashes and punctuation don't break FTS parsing.
+  // Example: abc-def -> "abc-def"
+  const tokens = s.match(/"[^"]+"|\S+/g) || [];
+  return tokens
+    .map(t => t.replace(/^"|"$/g, '').replace(/"/g, '""'))
+    .filter(Boolean)
+    .map(t => `"${t}"`)
+    .join(' AND ');
+}
+
 // Init DB and start watcher
 init();
 const db = open();
@@ -197,7 +222,11 @@ const server = http.createServer((req, res) => {
       const tools = db.prepare("SELECT DISTINCT tool_name FROM events WHERE tool_name IS NOT NULL").all().map(r => r.tool_name);
       const dateRange = db.prepare('SELECT MIN(start_time) as earliest, MAX(start_time) as latest FROM sessions').get();
       const costData = db.prepare('SELECT SUM(total_cost) as cost, SUM(total_tokens) as tokens FROM sessions').get();
-      const agents = db.prepare('SELECT DISTINCT agent FROM sessions WHERE agent IS NOT NULL').all().map(r => r.agent);
+      const agents = [...new Set(
+        db.prepare('SELECT DISTINCT agent FROM sessions WHERE agent IS NOT NULL').all()
+          .map(r => normalizeAgentLabel(r.agent))
+          .filter(Boolean)
+      )];
       const dbSize = getDbSize();
       json(res, { sessions, events, messages, toolCalls, uniqueTools: tools.length, tools, dateRange, totalCost: costData.cost || 0, totalTokens: costData.tokens || 0, agents, storageMode: config.storage, dbSize, sessionDirs: sessionDirs.map(d => ({ path: d.path, agent: d.agent })) });
     }
@@ -256,7 +285,12 @@ const server = http.createServer((req, res) => {
       if (!q) { json(res, { error: 'No query' }, 400); return; }
       let results;
       try {
-        results = db.prepare(`SELECT e.*, s.start_time as session_start, s.summary as session_summary FROM events_fts fts JOIN events e ON e.rowid = fts.rowid JOIN sessions s ON s.id = e.session_id WHERE events_fts MATCH ? ORDER BY e.timestamp DESC LIMIT 200`).all(q);
+        if (looksLikeSessionId(q)) {
+          results = db.prepare(`SELECT e.*, s.start_time as session_start, s.summary as session_summary FROM events e JOIN sessions s ON s.id = e.session_id WHERE e.session_id = ? ORDER BY e.timestamp DESC LIMIT 200`).all(q.trim());
+        } else {
+          const ftsQuery = toFtsQuery(q);
+          results = db.prepare(`SELECT e.*, s.start_time as session_start, s.summary as session_summary FROM events_fts fts JOIN events e ON e.rowid = fts.rowid JOIN sessions s ON s.id = e.session_id WHERE events_fts MATCH ? ORDER BY e.timestamp DESC LIMIT 200`).all(ftsQuery);
+        }
       } catch (err) { json(res, { error: 'Invalid search query' }, 400); return; }
       if (format === 'md') {
         let md = `# Search Results: "${q}"\n\n${results.length} results\n\n`;
@@ -280,18 +314,32 @@ const server = http.createServer((req, res) => {
 
       if (!q) { json(res, { results: [], total: 0 }); }
       else {
-        let sql = `SELECT e.*, s.start_time as session_start, s.summary as session_summary
-                    FROM events_fts fts
-                    JOIN events e ON e.rowid = fts.rowid
-                    JOIN sessions s ON s.id = e.session_id
-                    WHERE events_fts MATCH ?`;
-        const params = [q];
+        const isSessionLookup = looksLikeSessionId(q);
+        let sql;
+        const params = [];
+
+        if (isSessionLookup) {
+          sql = `SELECT e.*, s.start_time as session_start, s.summary as session_summary
+                 FROM events e
+                 JOIN sessions s ON s.id = e.session_id
+                 WHERE e.session_id = ?`;
+          params.push(q.trim());
+        } else {
+          sql = `SELECT e.*, s.start_time as session_start, s.summary as session_summary
+                 FROM events_fts fts
+                 JOIN events e ON e.rowid = fts.rowid
+                 JOIN sessions s ON s.id = e.session_id
+                 WHERE events_fts MATCH ?`;
+          params.push(toFtsQuery(q));
+        }
+
         if (type) { sql += ` AND e.type = ?`; params.push(type); }
         if (role) { sql += ` AND e.role = ?`; params.push(role); }
         if (from) { sql += ` AND e.timestamp >= ?`; params.push(from); }
         if (to) { sql += ` AND e.timestamp <= ?`; params.push(to); }
         sql += ` ORDER BY e.timestamp DESC LIMIT ?`;
         params.push(limit);
+
         try {
           const results = db.prepare(sql).all(...params);
           json(res, { results, total: results.length });

package/indexer.js

@@ -38,12 +38,12 @@ function discoverSessionDirs(config) {
       // Claude Code: JSONL files directly in project dir
       if (fs.existsSync(projDir) && fs.statSync(projDir).isDirectory()) {
         const hasJsonl = fs.readdirSync(projDir).some(f => f.endsWith('.jsonl'));
-        if (hasJsonl) dirs.push({ path: projDir, agent: `claude-${proj}` });
+        if (hasJsonl) dirs.push({ path: projDir, agent: 'claude-code' });
       }
       // Also check sessions/ subdirectory (future-proofing)
       const sp = path.join(projDir, 'sessions');
       if (fs.existsSync(sp) && fs.statSync(sp).isDirectory()) {
-        dirs.push({ path: sp, agent: `claude-${proj}` });
+        dirs.push({ path: sp, agent: 'claude-code' });
       }
     }
   }
@@ -107,13 +107,19 @@ function extractFilePaths(toolName, toolArgs) {
   return paths;
 }
 
-function extractProjectFromPath(filePath) {
+function aliasProject(project, config) {
+  if (!project) return project;
+  const aliases = (config && config.projectAliases && typeof config.projectAliases === 'object') ? config.projectAliases : {};
+  return aliases[project] || project;
+}
+
+function extractProjectFromPath(filePath, config) {
   if (!filePath || typeof filePath !== 'string') return null;
 
   const normalized = filePath.replace(/\\/g, '/');
 
   // Relative paths are usually from workspace cwd -> treat as workspace activity
-  if (!normalized.startsWith('/') && !normalized.startsWith('~')) return 'workspace';
+  if (!normalized.startsWith('/') && !normalized.startsWith('~')) return aliasProject('workspace', config);
 
   let rel = normalized
     .replace(/^\/home\/[^/]+\//, '')
@@ -124,22 +130,22 @@ function extractProjectFromPath(filePath) {
   if (!parts.length) return null;
 
   // Common repo location: ~/Developer/<repo>/...
-  if (parts[0] === 'Developer' && parts[1]) return parts[1];
+  if (parts[0] === 'Developer' && parts[1]) return aliasProject(parts[1], config);
 
   // OpenClaw workspace and agent stores
-  if (parts[0] === '.openclaw' && parts[1] === 'workspace') return 'workspace';
-  if (parts[0] === '.openclaw' && parts[1] === 'agents' && parts[2]) return `agent:${parts[2]}`;
+  if (parts[0] === '.openclaw' && parts[1] === 'workspace') return aliasProject('workspace', config);
+  if (parts[0] === '.openclaw' && parts[1] === 'agents' && parts[2]) return aliasProject(`agent:${parts[2]}`, config);
 
   // Claude Code projects
-  if (parts[0] === '.claude' && parts[1] === 'projects' && parts[2]) return `claude:${parts[2]}`;
+  if (parts[0] === '.claude' && parts[1] === 'projects' && parts[2]) return aliasProject(`claude:${parts[2]}`, config);
 
   // Shared files area
-  if (parts[0] === 'Shared') return 'shared';
+  if (parts[0] === 'Shared') return aliasProject('shared', config);
 
   return null;
 }
 
-function indexFile(db, filePath, agentName, stmts, archiveMode) {
+function indexFile(db, filePath, agentName, stmts, archiveMode, config) {
   const stat = fs.statSync(filePath);
   const mtime = stat.mtime.toISOString();
 
@@ -312,7 +318,7 @@ function indexFile(db, filePath, agentName, stmts, archiveMode) {
             : 'read';
           fileActivities.push([sessionId, fp, op, ts]);
 
-          const project = extractProjectFromPath(fp);
+          const project = extractProjectFromPath(fp, config);
           if (project) projectCounts.set(project, (projectCounts.get(project) || 0) + 1);
         }
       }
@@ -391,7 +397,7 @@ function run() {
   const indexMany = db.transaction(() => {
     let indexed = 0;
     for (const f of allFiles) {
-      const result = indexFile(db, f.path, f.agent, stmts, archiveMode);
+      const result = indexFile(db, f.path, f.agent, stmts, archiveMode, config);
       if (!result.skipped) {
         indexed++;
         if (indexed % 10 === 0) process.stdout.write('.');
@@ -416,7 +422,7 @@ function run() {
         if (!fs.existsSync(filePath)) return;
         setTimeout(() => {
           try {
-            const result = indexFile(db, filePath, dir.agent, stmts, archiveMode);
+            const result = indexFile(db, filePath, dir.agent, stmts, archiveMode, config);
             if (!result.skipped) console.log(`Re-indexed: ${filename} (${dir.agent})`);
           } catch (err) {
             console.error(`Error re-indexing ${filename}:`, err.message);
@@ -437,7 +443,7 @@ function indexAll(db, config) {
   for (const dir of sessionDirs) {
     const files = fs.readdirSync(dir.path).filter(f => f.endsWith('.jsonl'));
     for (const file of files) {
-      const result = indexFile(db, path.join(dir.path, file), dir.agent, stmts, archiveMode);
+      const result = indexFile(db, path.join(dir.path, file), dir.agent, stmts, archiveMode, config);
       if (!result.skipped) totalSessions++;
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentacta",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Audit trail and search engine for AI agent sessions",
   "main": "index.js",
   "bin": {

package/public/app.js

@@ -57,6 +57,11 @@ function truncate(s, n = 200) {
   return s.length > n ? s.slice(0, n) + '…' : s;
 }
 
+function shortSessionId(id) {
+  if (!id) return '';
+  return id.length > 24 ? `${id.slice(0, 8)}…${id.slice(-8)}` : id;
+}
+
 // Removed jumpToInitialPrompt - now handled within session view
 
 function badgeClass(type, role) {
@@ -113,6 +118,13 @@ function fmtTimeOnly(ts) {
   return new Date(ts).toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true });
 }
 
+function normalizeAgentLabel(a) {
+  if (!a) return a;
+  if (a === 'main') return 'openclaw-main';
+  if (a.startsWith('claude-') || a.startsWith('claude--')) return 'claude-code';
+  return a;
+}
+
 function renderProjectTags(s) {
   let projects = [];
   if (s.projects) {
@@ -141,7 +153,7 @@ function renderSessionItem(s) {
         <span class="session-time">${timeRange} · ${duration}</span>
         <span style="display:flex;gap:6px;align-items:center;flex-wrap:wrap">
           ${renderProjectTags(s)}
-          ${s.agent && s.agent !== 'main' ? `<span class="session-agent">${escHtml(s.agent)}</span>` : ''}
+          ${s.agent && s.agent !== 'main' ? `<span class="session-agent">${escHtml(normalizeAgentLabel(s.agent))}</span>` : ''}
           ${s.session_type ? `<span class="session-type">${escHtml(s.session_type)}</span>` : ''}
           ${renderModelTags(s)}
         </span>
@@ -317,6 +329,12 @@ async function viewSession(id) {
   let html = `
     <div class="back-btn" id="backBtn">← Back</div>
     <div class="page-title">Session</div>
+    <div class="session-id-row">
+      <span class="session-id-label">ID</span>
+      <span class="session-id-value" title="${escHtml(id)}">${escHtml(id)}</span>
+      <button class="session-id-copy" id="copySessionId" title="Copy session ID">⧉</button>
+      <span class="session-id-copied" id="copyConfirm">Copied!</span>
+    </div>
     <div style="display:flex;gap:6px;align-items:center;flex-wrap:wrap;margin-bottom:8px">
       ${s.first_message_id ? `<button class="jump-to-start-btn" id="jumpToStartBtn" title="Jump to initial prompt">↗️ Initial Prompt</button>` : ''}
       ${data.hasArchive ? `<a class="export-btn" href="#" onclick="dlExport('/api/archive/export/${id}','session.jsonl');return false">📦 JSONL</a>` : ''}
@@ -328,7 +346,7 @@ async function viewSession(id) {
         <span class="session-time">${fmtDate(s.start_time)} · ${fmtTimeShort(s.start_time)} – ${fmtTimeShort(s.end_time)}</span>
         <span style="display:flex;gap:6px;align-items:center;flex-wrap:wrap">
           ${renderProjectTags(s)}
-          ${s.agent && s.agent !== 'main' ? `<span class="session-agent">${escHtml(s.agent)}</span>` : ''}
+          ${s.agent && s.agent !== 'main' ? `<span class="session-agent">${escHtml(normalizeAgentLabel(s.agent))}</span>` : ''}
           ${s.session_type ? `<span class="session-type">${escHtml(s.session_type)}</span>` : ''}
           ${renderModelTags(s)}
         </span>
@@ -352,6 +370,46 @@ async function viewSession(id) {
     else viewSessions();
   });
 
+  $('#copySessionId').addEventListener('click', async () => {
+    const conf = $('#copyConfirm');
+    const showCopied = () => {
+      conf.textContent = 'Copied!';
+      conf.classList.add('show');
+      setTimeout(() => conf.classList.remove('show'), 1500);
+    };
+
+    try {
+      if (navigator.clipboard && window.isSecureContext) {
+        await navigator.clipboard.writeText(id);
+        showCopied();
+        return;
+      }
+
+      // Fallback for non-secure contexts (http/local)
+      const ta = document.createElement('textarea');
+      ta.value = id;
+      ta.setAttribute('readonly', '');
+      ta.style.position = 'fixed';
+      ta.style.opacity = '0';
+      ta.style.pointerEvents = 'none';
+      document.body.appendChild(ta);
+      ta.focus();
+      ta.select();
+      const ok = document.execCommand('copy');
+      document.body.removeChild(ta);
+
+      if (ok) showCopied();
+      else throw new Error('Copy failed');
+    } catch {
+      conf.textContent = 'Press Ctrl/Cmd+C';
+      conf.classList.add('show');
+      setTimeout(() => {
+        conf.classList.remove('show');
+        conf.textContent = 'Copied!';
+      }, 1800);
+    }
+  });
+
   const jumpBtn = $('#jumpToStartBtn');
   if (jumpBtn) {
     jumpBtn.addEventListener('click', () => {
@@ -407,13 +465,31 @@ async function viewStats() {
       <div class="stat-card"><div class="label">DB Size</div><div class="value" style="font-size:18px">${escHtml(data.dbSize?.display || 'N/A')}</div></div>
     </div>
 
-    ${data.sessionDirs && data.sessionDirs.length ? `<div class="section-label">Sessions Paths</div>
-    <div style="font-size:13px;color:var(--text2);font-family:var(--mono)">
-      ${data.sessionDirs.map(d => {
-        const display = d.path.replace(/^\/home\/[^/]+/, '~').replace(/^\/Users\/[^/]+/, '~');
-        return `<div style="margin-bottom:4px">📂 ${escHtml(display)} <span style="color:var(--accent)">(${escHtml(d.agent)})</span></div>`;
-      }).join('')}
-    </div>` : ''}
+    ${data.sessionDirs && data.sessionDirs.length ? (() => {
+      const dirs = data.sessionDirs || [];
+      const claudeDirs = dirs.filter(d => d.agent === 'claude-code' || /^claude-/.test(d.agent || ''));
+      const otherDirs = dirs.filter(d => !(d.agent === 'claude-code' || /^claude-/.test(d.agent || '')));
+
+      const lines = [];
+
+      if (claudeDirs.length) {
+        const projects = new Set();
+        for (const d of claudeDirs) {
+          const m = (d.path || '').match(/[\\/]\.claude[\\/]projects[\\/]([^\\/]+)$/);
+          if (m && m[1]) projects.add(m[1]);
+        }
+        const projectCount = projects.size || claudeDirs.length;
+        lines.push(`<div style="margin-bottom:4px">📂 ~/.claude/projects/* <span style="color:var(--accent)">(claude-code · ${projectCount} workspace${projectCount === 1 ? '' : 's'})</span></div>`);
+      }
+
+      for (const d of otherDirs) {
+        const display = (d.path || '').replace(/^\/home\/[^/]+/, '~').replace(/^\/Users\/[^/]+/, '~');
+        lines.push(`<div style="margin-bottom:4px">📂 ${escHtml(display)} <span style="color:var(--accent)">(${escHtml(normalizeAgentLabel(d.agent))})</span></div>`);
+      }
+
+      return `<div class="section-label">Sessions Paths</div>
+      <div style="font-size:13px;color:var(--text2);font-family:var(--mono)">${lines.join('')}</div>`;
+    })() : ''}
 
     ${data.agents && data.agents.length > 1 ? `<div class="section-label">Agents</div><div class="filters">${data.agents.map(a => `<span class="filter-chip">${escHtml(a)}</span>`).join('')}</div>` : ''}
     <div class="section-label">Date Range</div>

package/public/style.css

@@ -459,6 +459,64 @@ mark { background: rgba(210,153,34,0.3); color: var(--text); border-radius: 2px;
   border-color: var(--accent2);
 }
 
+/* Session ID (copyable) */
+.session-id-row {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin-bottom: 8px;
+  width: 100%;
+}
+
+.session-id-label {
+  font-size: 11px;
+  color: var(--text2);
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  flex-shrink: 0;
+}
+
+.session-id-value {
+  font-family: var(--mono);
+  font-size: 12px;
+  color: var(--text2);
+  background: var(--bg3);
+  padding: 2px 8px;
+  border-radius: 4px;
+  flex: 1 1 auto;
+  min-width: 0;
+  max-width: none;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.session-id-copy {
+  background: none;
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  color: var(--text2);
+  cursor: pointer;
+  padding: 2px 6px;
+  font-size: 12px;
+  line-height: 1;
+  transition: all 0.15s;
+  font-family: inherit;
+  display: inline-flex;
+  align-items: center;
+}
+
+.session-id-copy:hover { color: var(--text); border-color: var(--accent); }
+
+.session-id-copied {
+  font-size: 11px;
+  color: var(--accent2);
+  opacity: 0;
+  transition: opacity 0.2s;
+}
+
+.session-id-copied.show { opacity: 1; }
+
 /* File activity */
 .file-item {
   background: var(--bg2);
@@ -560,4 +618,6 @@ mark { background: rgba(210,153,34,0.3); color: var(--text); border-radius: 2px;
 
   .result-meta { flex-wrap: wrap; }
   .tool-args { font-size: 11px; }
+
+  .session-id-value { font-size: 11px; }
 }