@threadcrumbs/common 0.1.8 → 0.1.9

package/telemetry/hermes.mjs

@@ -1,441 +1,441 @@
-import fsp from 'node:fs/promises'
-import os from 'node:os'
-import path from 'node:path'
-import { exists, listDirs } from '../lib/fsutil.mjs'
-import { resolveHermesHome } from '../lib/hermes-home.mjs'
-import { columnsOf, tablesOf, withReadOnly } from '../lib/sqlite.mjs'
-import {
-  DETAIL_LIMITS,
-  RECENT_MS,
-  activityDetail,
-  askOf,
-  clip,
-  clipBlock,
-  emptyActivity,
-  endCall,
-  keepNewest,
-  keepText,
-  number,
-  openTool,
-  planItems,
-  planSummary,
-  settleCalls,
-  startCall,
-  text,
-  textList,
-  titleFromPrompt,
-  toolFile,
-  toolInput,
-  toolNow,
-  toolTarget,
-} from '../lib/telemetry-fields.mjs'
-
-const ACTIVE_WINDOW_MS = 30 * 60 * 1000
-const FORK_MARKERS = ['_branched_from', '_delegate_from', '_reset_from']
-const DELEGATE_TOOLS = new Set(['delegate_task'])
-const TODO_TOOLS = ['todo_list', 'todo']
-const ASKING = /^waiting for user (approval|clarify)/i
-const TOOL_LABEL = /^(?:executing tool|sequential tool running \([^)]*\)): (.+)$/i
-const SESSION_COLUMNS = [
-  'id', 'title', 'model', 'source', 'cwd', 'git_branch', 'git_repo_root', 'started_at', 'ended_at',
-  'last_activity_at', 'last_activity_description', 'parent_session_id', 'end_reason', 'model_config', 'hidden',
-  'input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_write_tokens', 'estimated_cost_usd',
-  'actual_cost_usd', 'billing_base_url', 'archived', 'last_read_at',
-]
-
-const seconds = (v) => Math.round(number(v) * 1000)
-
-function parseConfig(raw) {
-  try {
-    const config = JSON.parse(raw || '{}')
-    return config && typeof config === 'object' ? config : {}
-  } catch {
-    return {}
-  }
-}
-
-const unquote = (key) => {
-  if (/^'.*'$/.test(key)) return key.slice(1, -1).replace(/''/g, "'")
-  if (/^".*"$/.test(key)) {
-    try {
-      return JSON.parse(key)
-    } catch {
-      return key.slice(1, -1)
-    }
-  }
-  return key
-}
-
-export function parseContextLengths(source) {
-  const lengths = new Map()
-  let inSection = false
-  for (const line of text(source).split(/\r?\n/)) {
-    if (/^\S/.test(line)) {
-      inSection = /^context_lengths:\s*$/.test(line)
-      continue
-    }
-    const entry = inSection && /^\s+(.+?):\s+(\d+)\s*$/.exec(line)
-    if (entry) lengths.set(unquote(entry[1]), Number(entry[2]))
-  }
-  return lengths
-}
-
-function contextLimit(lengths, model, baseUrl) {
-  if (!model) return 0
-  const exact = lengths.get(`${model}@${text(baseUrl).replace(/\/+$/, '')}`)
-  if (exact) return exact
-  for (const [key, limit] of lengths) if (key.startsWith(`${model}@`)) return limit
-  return 0
-}
-
-export function hermes({ home = resolveHermesHome(), now = Date.now } = {}) {
-  const mainDb = path.join(home, 'state.db')
-  const contextCaches = new Map()
-
-  async function storeFiles() {
-    const files = [{ profile: 'main', dir: home, file: mainDb }]
-    for (const dir of await listDirs(path.join(home, 'profiles'))) {
-      const file = path.join(dir, 'state.db')
-      if (await exists(file)) files.push({ profile: path.basename(dir), dir, file })
-    }
-    return files
-  }
-
-  async function contextLengths(dir) {
-    const file = path.join(dir, 'context_length_cache.yaml')
-    const stat = await fsp.stat(file).catch(() => null)
-    if (!stat) return new Map()
-    const hit = contextCaches.get(file)
-    if (hit && hit.mtime === stat.mtimeMs) return hit.lengths
-    const lengths = parseContextLengths(await fsp.readFile(file, 'utf8').catch(() => ''))
-    contextCaches.set(file, { mtime: stat.mtimeMs, lengths })
-    return lengths
-  }
-
-  async function scanSessions() {
-    const sessions = []
-    for (const store of await storeFiles()) {
-      const lengths = await contextLengths(store.dir)
-      const found = await withReadOnly(store.file, (db) => sessionsFrom(db, store.profile, lengths, home, now()), [])
-      sessions.push(...found)
-    }
-    return sessions
-  }
-
-  async function sessionDetail(key, { filesOnly = false } = {}) {
-    const match = /^hermes:([^:]+):(.+)$/.exec(String(key))
-    if (!match) return null
-    const [, profile, rootId] = match
-    if (filesOnly) return { id: `hermes:${profile}:${rootId}`, sessionId: rootId, files: null }
-    const store = (await storeFiles()).find((s) => s.profile === profile)
-    if (!store) return null
-    const detail = await withReadOnly(store.file, (db) => detailFrom(db, rootId, now()), null)
-    return detail && { id: `hermes:${profile}:${rootId}`, sessionId: rootId, source: store.file, ...detail }
-  }
-
-  return {
-    id: 'hermes',
-    name: 'Hermes',
-    detect: () => exists(mainDb),
-    watchRoots: () => [home],
-    scanSessions,
-    sessionDetail,
-  }
-}
-
-function lineage(db, at) {
-  const tables = tablesOf(db)
-  if (!tables.has('sessions') || !tables.has('messages')) return null
-  const cols = columnsOf(db, 'sessions')
-  if (!['id', 'started_at'].every((c) => cols.has(c))) return null
-  const rows = db.prepare(`SELECT ${SESSION_COLUMNS.map((c) => (cols.has(c) ? c : `NULL AS ${c}`)).join(', ')} FROM sessions`).all()
-  for (const row of rows) row.config = parseConfig(row.model_config)
-  const leases = tables.has('session_turn_leases')
-    ? new Set(db.prepare('SELECT conversation_id FROM session_turn_leases WHERE expires_at > ?').all(at / 1000).map((r) => r.conversation_id))
-    : null
-  const messages = columnsOf(db, 'messages')
-  if (!['id', 'session_id', 'role', 'content'].every((c) => messages.has(c))) return null
-  const visible = messages.has('active') ? (messages.has('compacted') ? 'AND (active = 1 OR compacted = 1)' : 'AND active = 1') : ''
-
-  const byId = new Map(rows.map((r) => [r.id, r]))
-  const fork = (row) => FORK_MARKERS.find((key) => row.config[key] != null) || ''
-  const continues = (row) => {
-    const parent = row.parent_session_id ? byId.get(row.parent_session_id) : null
-    return parent && parent.end_reason === 'compression' && !fork(row) ? parent : null
-  }
-  const continued = new Set(rows.map(continues).filter(Boolean).map((p) => p.id))
-  const isErrand = (row) => row.source === 'subagent' || fork(row) === '_delegate_from'
-  const lastAt = (row) => seconds(row.last_activity_at || row.ended_at || row.started_at)
-  const chainOf = (tip) => {
-    const chain = [tip]
-    for (let parent = continues(tip); parent && chain.length <= rows.length; parent = continues(parent)) chain.push(parent)
-    return chain
-  }
-  const turnOpen = (row, root) =>
-    leases ? leases.has(root.id) : Boolean(text(row.last_activity_description)) && at - lastAt(row) < ACTIVE_WINDOW_MS
-  return { rows, continued, isErrand, lastAt, chainOf, turnOpen, messages, visible }
-}
-
-function sessionsFrom(db, profile, lengths, home, at) {
-  const found = lineage(db, at)
-  if (!found) return []
-  const { rows, continued, isErrand, lastAt, chainOf, turnOpen, messages, visible } = found
-
-  const out = []
-  for (const tip of rows) {
-    if (continued.has(tip.id) || isErrand(tip) || number(tip.hidden) || number(tip.archived) || tip.source === 'cron') continue
-    const chain = chainOf(tip)
-    const root = chain[chain.length - 1]
-    const open = turnOpen(tip, root)
-    if (!open && at - lastAt(tip) > RECENT_MS) continue
-    const ids = chain.map((r) => r.id)
-    const working = rows
-      .filter((r) => isErrand(r) && ids.includes(r.parent_session_id) && turnOpen(r, chainOf(r).at(-1)))
-      .sort((a, b) => seconds(a.started_at) - seconds(b.started_at))
-      .map((r) => ({ id: r.id, name: text(r.title) || 'Subagent' }))
-    out.push(toSession({ db, profile, tip, root, chain, ids, open, errands: working.length, workingSubagents: working, lengths, home, messages, visible, at, lastAt: lastAt(tip) }))
-  }
-  return out
-}
-
-function parseJson(raw, fallback) {
-  try {
-    return JSON.parse(raw)
-  } catch {
-    return fallback
-  }
-}
-
-const FAILED_END = /error|fail/i
-
-function detailFrom(db, rootId, at) {
-  const found = lineage(db, at)
-  if (!found) return null
-  const { rows, continued, isErrand, lastAt, chainOf, turnOpen, messages, visible } = found
-  const tip = rows.find((r) => !continued.has(r.id) && !isErrand(r) && chainOf(r).at(-1).id === rootId)
-  if (!tip) return null
-  const chain = chainOf(tip)
-  const ids = chain.map((r) => r.id)
-  const placeholders = ids.map(() => '?').join(', ')
-  const open = turnOpen(tip, chain.at(-1))
-  const cwd = text(tip.cwd)
-
-  const activity = emptyActivity()
-  const prompts = []
-  const thoughts = []
-  const replies = []
-  const pick = (column, fallback = 'NULL') => (messages.has(column) ? column : `${fallback} AS ${column}`)
-  const said = (column) => (messages.has(column) ? `CASE WHEN role = 'assistant' THEN ${column} END AS ${column}` : `NULL AS ${column}`)
-  const reasons = messages.has('reasoning') || messages.has('reasoning_content')
-  const order = messages.has('timestamp') ? 'timestamp, id' : 'id'
-  const records = db
-    .prepare(
-      `SELECT id, role, CASE WHEN role IN ('user', 'assistant') THEN content END AS content, ${said('reasoning')}, ${said('reasoning_content')}, ${pick('tool_calls')}, ${pick('tool_call_id')}, ${pick('timestamp', '0')}
-       FROM messages WHERE session_id IN (${placeholders}) ${visible} ORDER BY ${order}`,
-    )
-    .all(...ids)
-  for (const record of records) {
-    const time = seconds(record.timestamp)
-    if (record.role === 'user') {
-      settleCalls(activity)
-      const prompt = text(record.content).trim()
-      if (prompt) keepNewest(prompts, { at: time, text: clipBlock(prompt, DETAIL_LIMITS.promptText) }, DETAIL_LIMITS.prompts)
-    } else if (record.role === 'assistant') {
-      keepText(thoughts, 'thoughts', { at: time, text: text(record.reasoning) || text(record.reasoning_content) })
-      keepText(replies, 'replies', { at: time, text: text(record.content) })
-      for (const call of (record.tool_calls && parseJson(record.tool_calls, [])) || []) {
-        if (!call?.id) continue
-        const args = callArgs(call)
-        startCall(activity, { id: text(call.id), name: text(call.function?.name), target: toolTarget(args, cwd), input: toolInput(args), ...toolFile(args, cwd), startedAt: time })
-      }
-    } else if (record.role === 'tool' && record.tool_call_id) {
-      endCall(activity, text(record.tool_call_id), time, null)
-    }
-  }
-  if (!open) settleCalls(activity)
-
-  const subagents = rows
-    .filter((r) => isErrand(r) && ids.includes(r.parent_session_id))
-    .map((r) => {
-      const working = turnOpen(r, chainOf(r).at(-1))
-      const label = TOOL_LABEL.exec(text(r.last_activity_description))
-      const tokens = ['input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_write_tokens'].map((c) => (r[c] == null ? null : number(r[c])))
-      return {
-        id: r.id,
-        name: text(r.title) || 'Subagent',
-        type: text(r.source) === 'subagent' ? '' : 'delegate',
-        status: working ? 'working' : FAILED_END.test(text(r.end_reason)) ? 'error' : r.ended_at != null ? 'done' : 'idle',
-        model: text(r.model),
-        tokens: tokens.some((t) => t != null) ? { input: tokens[0] || 0, output: tokens[1] || 0, cacheRead: tokens[2] || 0, cacheWrite: tokens[3] || 0 } : null,
-        tool: working && label ? toolNow({ name: label[1].trim(), startedAt: seconds(r.last_activity_at) }) : null,
-        startedAt: seconds(r.started_at),
-        lastActivityAt: lastAt(r),
-      }
-    })
-    .sort((a, b) => a.startedAt - b.startedAt)
-    .slice(-DETAIL_LIMITS.subagents)
-
-  const models = new Map()
-  for (const row of chain) {
-    const model = text(row.model)
-    if (!model) continue
-    const entry = models.get(model) || { model, tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, costUsd: null }
-    entry.tokens.input += number(row.input_tokens)
-    entry.tokens.output += number(row.output_tokens)
-    entry.tokens.cacheRead += number(row.cache_read_tokens)
-    entry.tokens.cacheWrite += number(row.cache_write_tokens)
-    const cost = row.actual_cost_usd ?? row.estimated_cost_usd
-    if (cost != null) entry.costUsd = (entry.costUsd || 0) + number(cost)
-    models.set(model, entry)
-  }
-
-  const errors = chain
-    .filter((r) => FAILED_END.test(text(r.end_reason)))
-    .map((r) => ({ at: seconds(r.ended_at), message: `The session ended: ${text(r.end_reason)}` }))
-    .reverse()
-
-  return {
-    models: [...models.values()],
-    history: null,
-    compactions: null,
-    contextParts: null,
-    ...activityDetail(activity),
-    plan: planItems(latestPlan(db, ids, messages)),
-    subagents,
-    files: null,
-    prompts,
-    thoughts: reasons ? textList(thoughts) : null,
-    replies: textList(replies),
-    contextBreakdown: null,
-    errors,
-  }
-}
-
-function openCalls(db, sessionId, messages, visible, cwd) {
-  if (!['tool_calls', 'tool_call_id', 'timestamp'].every((c) => messages.has(c))) return []
-  const last = db
-    .prepare(`SELECT id, tool_calls, timestamp FROM messages WHERE session_id = ? AND role = 'assistant' ${visible} ORDER BY id DESC LIMIT 1`)
-    .get(sessionId)
-  if (!last?.tool_calls) return []
-  let calls
-  try {
-    calls = JSON.parse(last.tool_calls)
-  } catch {
-    return []
-  }
-  const answered = new Set(
-    db.prepare(`SELECT tool_call_id FROM messages WHERE session_id = ? AND role = 'tool' AND id > ?`).all(sessionId, last.id).map((r) => r.tool_call_id),
-  )
-  return (Array.isArray(calls) ? calls : [])
-    .filter((c) => c?.id && !answered.has(c.id))
-    .map((c) => openTool(text(c.function?.name), seconds(last.timestamp), callArgs(c), cwd))
-}
-
-const callArgs = (call) => (typeof call.function?.arguments === 'string' ? parseJson(call.function.arguments, null) : call.function?.arguments)
-
-function turnStart(db, ids, messages, visible) {
-  if (!messages.has('timestamp')) return null
-  const row = db
-    .prepare(`SELECT MAX(timestamp) AS at FROM messages WHERE session_id IN (${ids.map(() => '?').join(', ')}) AND role = 'user' ${visible}`)
-    .get(...ids)
-  return row?.at == null ? null : seconds(row.at)
-}
-
-function latestPlan(db, ids, messages) {
-  if (!messages.has('tool_name') || !messages.has('timestamp')) return null
-  const row = db
-    .prepare(
-      `SELECT content FROM messages WHERE session_id IN (${ids.map(() => '?').join(', ')}) AND role = 'tool' AND tool_name IN (${TODO_TOOLS.map(() => '?').join(', ')}) ORDER BY timestamp DESC, id DESC LIMIT 1`,
-    )
-    .get(...ids, ...TODO_TOOLS)
-  try {
-    const todos = JSON.parse(row?.content || '{}').todos
-    return Array.isArray(todos) ? todos.map((t) => ({ content: text(t?.content), status: text(t?.status) || 'pending' })) : null
-  } catch {
-    return null
-  }
-}
-
-function sum(chain, column) {
-  let total = 0
-  let known = false
-  for (const row of chain) {
-    if (row[column] == null) continue
-    total += number(row[column])
-    known = true
-  }
-  return known ? total : null
-}
-
-function toSession({ db, profile, tip, root, chain, ids, open, errands, workingSubagents, lengths, home, messages, visible, at, lastAt }) {
-  const description = text(tip.last_activity_description)
-  const placeholders = ids.map(() => '?').join(', ')
-  const calls = open ? openCalls(db, tip.id, messages, visible, text(tip.cwd)) : []
-  const working = calls.filter((c) => !DELEGATE_TOOLS.has(c.name))
-  const asking = ASKING.exec(description)
-  let status
-  let statusReason
-  if (open) {
-    if (asking) [status, statusReason] = ['asking', /approval/i.test(asking[1]) ? 'approval' : 'question']
-    else if (!working.length && (calls.length || errands)) [status, statusReason] = ['delegating', 'subagents']
-    else [status, statusReason] = ['working', 'turn-open']
-  } else if (errands) [status, statusReason] = ['delegating', 'subagents']
-  else if (tip.last_read_at != null) [status, statusReason] = seconds(tip.last_activity_at || tip.started_at) > seconds(tip.last_read_at) ? ['done', 'unread'] : ['idle', 'read']
-  else [status, statusReason] = tip.ended_at == null && at - lastAt < ACTIVE_WINDOW_MS ? ['done', 'recent'] : ['idle', 'quiet']
-
-  let tool = null
-  if (status === 'working' || status === 'delegating') {
-    const latest = (working.length ? working : calls).at(-1)
-    const label = TOOL_LABEL.exec(description)
-    if (latest) tool = toolNow(latest)
-    else if (label) tool = toolNow({ name: label[1].trim(), startedAt: seconds(tip.last_activity_at) })
-  }
-
-  const where = text(tip.git_repo_root) || text(tip.cwd)
-  const userHome = os.homedir()
-  const atHome = !where || where === userHome || where === home || where === path.join(userHome, '.hermes')
-  const anchor = tip.config._usage_anchor
-  const used = anchor ? number(anchor.prompt_tokens) + number(anchor.completion_tokens) : 0
-  const reasoning = tip.config.reasoning_config
-  const tokens = ['input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_write_tokens'].map((c) => sum(chain, c))
-  const costs = chain.map((r) => r.actual_cost_usd ?? r.estimated_cost_usd)
-  const firstPrompt = db
-    .prepare(`SELECT content FROM messages WHERE session_id = ? AND role = 'user' ORDER BY id ASC LIMIT 1`)
-    .get(root.id)?.content
-  const prompts = db.prepare(`SELECT COUNT(*) AS n FROM messages WHERE session_id IN (${placeholders}) AND role = 'user' ${visible}`).get(...ids)
-
-  return {
-    id: `hermes:${profile}:${root.id}`,
-    harness: 'hermes',
-    title: text(tip.title) || text(root.title) || titleFromPrompt(text(firstPrompt)) || 'Untitled session',
-    project: atHome ? 'Hermes' : path.basename(where.replace(/\\/g, '/')),
-    projectPath: atHome ? userHome : where,
-    worktree: '',
-    cwd: text(tip.cwd),
-    gitBranch: text(tip.git_branch),
-    model: text(tip.model),
-    effort: reasoning && reasoning.enabled !== false ? text(reasoning.effort) : '',
-    status,
-    live: open,
-    startedAt: seconds(root.started_at),
-    lastActivityAt: lastAt,
-    tool,
-    tokens: tokens.some((t) => t != null)
-      ? { input: tokens[0] || 0, output: tokens[1] || 0, cacheRead: tokens[2] || 0, cacheWrite: tokens[3] || 0 }
-      : null,
-    context: used ? { used, limit: contextLimit(lengths, text(tip.model), tip.billing_base_url) } : null,
-    contextHistory: null,
-    costUsd: costs.some((c) => c != null) ? costs.reduce((total, c) => total + number(c), 0) : null,
-    lines: null,
-    plan: planSummary(latestPlan(db, ids, messages)),
-    subagents: errands,
-    workingSubagents,
-    prompts: number(prompts?.n),
-    turnStartedAt: open ? turnStart(db, ids, messages, visible) : null,
-    statusReason,
-    ask: askOf(status),
-    usageLimits: null,
-  }
-}
-
-export default hermes()
+import fsp from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import { exists, listDirs } from '../lib/fsutil.mjs'
+import { resolveHermesHome } from '../lib/hermes-home.mjs'
+import { columnsOf, tablesOf, withReadOnly } from '../lib/sqlite.mjs'
+import {
+  DETAIL_LIMITS,
+  RECENT_MS,
+  activityDetail,
+  askOf,
+  clip,
+  clipBlock,
+  emptyActivity,
+  endCall,
+  keepNewest,
+  keepText,
+  number,
+  openTool,
+  planItems,
+  planSummary,
+  settleCalls,
+  startCall,
+  text,
+  textList,
+  titleFromPrompt,
+  toolFile,
+  toolInput,
+  toolNow,
+  toolTarget,
+} from '../lib/telemetry-fields.mjs'
+
+const ACTIVE_WINDOW_MS = 30 * 60 * 1000
+const FORK_MARKERS = ['_branched_from', '_delegate_from', '_reset_from']
+const DELEGATE_TOOLS = new Set(['delegate_task'])
+const TODO_TOOLS = ['todo_list', 'todo']
+const ASKING = /^waiting for user (approval|clarify)/i
+const TOOL_LABEL = /^(?:executing tool|sequential tool running \([^)]*\)): (.+)$/i
+const SESSION_COLUMNS = [
+  'id', 'title', 'model', 'source', 'cwd', 'git_branch', 'git_repo_root', 'started_at', 'ended_at',
+  'last_activity_at', 'last_activity_description', 'parent_session_id', 'end_reason', 'model_config', 'hidden',
+  'input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_write_tokens', 'estimated_cost_usd',
+  'actual_cost_usd', 'billing_base_url', 'archived', 'last_read_at',
+]
+
+const seconds = (v) => Math.round(number(v) * 1000)
+
+function parseConfig(raw) {
+  try {
+    const config = JSON.parse(raw || '{}')
+    return config && typeof config === 'object' ? config : {}
+  } catch {
+    return {}
+  }
+}
+
+const unquote = (key) => {
+  if (/^'.*'$/.test(key)) return key.slice(1, -1).replace(/''/g, "'")
+  if (/^".*"$/.test(key)) {
+    try {
+      return JSON.parse(key)
+    } catch {
+      return key.slice(1, -1)
+    }
+  }
+  return key
+}
+
+export function parseContextLengths(source) {
+  const lengths = new Map()
+  let inSection = false
+  for (const line of text(source).split(/\r?\n/)) {
+    if (/^\S/.test(line)) {
+      inSection = /^context_lengths:\s*$/.test(line)
+      continue
+    }
+    const entry = inSection && /^\s+(.+?):\s+(\d+)\s*$/.exec(line)
+    if (entry) lengths.set(unquote(entry[1]), Number(entry[2]))
+  }
+  return lengths
+}
+
+function contextLimit(lengths, model, baseUrl) {
+  if (!model) return 0
+  const exact = lengths.get(`${model}@${text(baseUrl).replace(/\/+$/, '')}`)
+  if (exact) return exact
+  for (const [key, limit] of lengths) if (key.startsWith(`${model}@`)) return limit
+  return 0
+}
+
+export function hermes({ home = resolveHermesHome(), now = Date.now } = {}) {
+  const mainDb = path.join(home, 'state.db')
+  const contextCaches = new Map()
+
+  async function storeFiles() {
+    const files = [{ profile: 'main', dir: home, file: mainDb }]
+    for (const dir of await listDirs(path.join(home, 'profiles'))) {
+      const file = path.join(dir, 'state.db')
+      if (await exists(file)) files.push({ profile: path.basename(dir), dir, file })
+    }
+    return files
+  }
+
+  async function contextLengths(dir) {
+    const file = path.join(dir, 'context_length_cache.yaml')
+    const stat = await fsp.stat(file).catch(() => null)
+    if (!stat) return new Map()
+    const hit = contextCaches.get(file)
+    if (hit && hit.mtime === stat.mtimeMs) return hit.lengths
+    const lengths = parseContextLengths(await fsp.readFile(file, 'utf8').catch(() => ''))
+    contextCaches.set(file, { mtime: stat.mtimeMs, lengths })
+    return lengths
+  }
+
+  async function scanSessions() {
+    const sessions = []
+    for (const store of await storeFiles()) {
+      const lengths = await contextLengths(store.dir)
+      const found = await withReadOnly(store.file, (db) => sessionsFrom(db, store.profile, lengths, home, now()), [])
+      sessions.push(...found)
+    }
+    return sessions
+  }
+
+  async function sessionDetail(key, { filesOnly = false } = {}) {
+    const match = /^hermes:([^:]+):(.+)$/.exec(String(key))
+    if (!match) return null
+    const [, profile, rootId] = match
+    if (filesOnly) return { id: `hermes:${profile}:${rootId}`, sessionId: rootId, files: null }
+    const store = (await storeFiles()).find((s) => s.profile === profile)
+    if (!store) return null
+    const detail = await withReadOnly(store.file, (db) => detailFrom(db, rootId, now()), null)
+    return detail && { id: `hermes:${profile}:${rootId}`, sessionId: rootId, source: store.file, ...detail }
+  }
+
+  return {
+    id: 'hermes',
+    name: 'Hermes',
+    detect: () => exists(mainDb),
+    watchRoots: () => [home],
+    scanSessions,
+    sessionDetail,
+  }
+}
+
+function lineage(db, at) {
+  const tables = tablesOf(db)
+  if (!tables.has('sessions') || !tables.has('messages')) return null
+  const cols = columnsOf(db, 'sessions')
+  if (!['id', 'started_at'].every((c) => cols.has(c))) return null
+  const rows = db.prepare(`SELECT ${SESSION_COLUMNS.map((c) => (cols.has(c) ? c : `NULL AS ${c}`)).join(', ')} FROM sessions`).all()
+  for (const row of rows) row.config = parseConfig(row.model_config)
+  const leases = tables.has('session_turn_leases')
+    ? new Set(db.prepare('SELECT conversation_id FROM session_turn_leases WHERE expires_at > ?').all(at / 1000).map((r) => r.conversation_id))
+    : null
+  const messages = columnsOf(db, 'messages')
+  if (!['id', 'session_id', 'role', 'content'].every((c) => messages.has(c))) return null
+  const visible = messages.has('active') ? (messages.has('compacted') ? 'AND (active = 1 OR compacted = 1)' : 'AND active = 1') : ''
+
+  const byId = new Map(rows.map((r) => [r.id, r]))
+  const fork = (row) => FORK_MARKERS.find((key) => row.config[key] != null) || ''
+  const continues = (row) => {
+    const parent = row.parent_session_id ? byId.get(row.parent_session_id) : null
+    return parent && parent.end_reason === 'compression' && !fork(row) ? parent : null
+  }
+  const continued = new Set(rows.map(continues).filter(Boolean).map((p) => p.id))
+  const isErrand = (row) => row.source === 'subagent' || fork(row) === '_delegate_from'
+  const lastAt = (row) => seconds(row.last_activity_at || row.ended_at || row.started_at)
+  const chainOf = (tip) => {
+    const chain = [tip]
+    for (let parent = continues(tip); parent && chain.length <= rows.length; parent = continues(parent)) chain.push(parent)
+    return chain
+  }
+  const turnOpen = (row, root) =>
+    leases ? leases.has(root.id) : Boolean(text(row.last_activity_description)) && at - lastAt(row) < ACTIVE_WINDOW_MS
+  return { rows, continued, isErrand, lastAt, chainOf, turnOpen, messages, visible }
+}
+
+function sessionsFrom(db, profile, lengths, home, at) {
+  const found = lineage(db, at)
+  if (!found) return []
+  const { rows, continued, isErrand, lastAt, chainOf, turnOpen, messages, visible } = found
+
+  const out = []
+  for (const tip of rows) {
+    if (continued.has(tip.id) || isErrand(tip) || number(tip.hidden) || number(tip.archived) || tip.source === 'cron') continue
+    const chain = chainOf(tip)
+    const root = chain[chain.length - 1]
+    const open = turnOpen(tip, root)
+    if (!open && at - lastAt(tip) > RECENT_MS) continue
+    const ids = chain.map((r) => r.id)
+    const working = rows
+      .filter((r) => isErrand(r) && ids.includes(r.parent_session_id) && turnOpen(r, chainOf(r).at(-1)))
+      .sort((a, b) => seconds(a.started_at) - seconds(b.started_at))
+      .map((r) => ({ id: r.id, name: text(r.title) || 'Subagent' }))
+    out.push(toSession({ db, profile, tip, root, chain, ids, open, errands: working.length, workingSubagents: working, lengths, home, messages, visible, at, lastAt: lastAt(tip) }))
+  }
+  return out
+}
+
+function parseJson(raw, fallback) {
+  try {
+    return JSON.parse(raw)
+  } catch {
+    return fallback
+  }
+}
+
+const FAILED_END = /error|fail/i
+
+function detailFrom(db, rootId, at) {
+  const found = lineage(db, at)
+  if (!found) return null
+  const { rows, continued, isErrand, lastAt, chainOf, turnOpen, messages, visible } = found
+  const tip = rows.find((r) => !continued.has(r.id) && !isErrand(r) && chainOf(r).at(-1).id === rootId)
+  if (!tip) return null
+  const chain = chainOf(tip)
+  const ids = chain.map((r) => r.id)
+  const placeholders = ids.map(() => '?').join(', ')
+  const open = turnOpen(tip, chain.at(-1))
+  const cwd = text(tip.cwd)
+
+  const activity = emptyActivity()
+  const prompts = []
+  const thoughts = []
+  const replies = []
+  const pick = (column, fallback = 'NULL') => (messages.has(column) ? column : `${fallback} AS ${column}`)
+  const said = (column) => (messages.has(column) ? `CASE WHEN role = 'assistant' THEN ${column} END AS ${column}` : `NULL AS ${column}`)
+  const reasons = messages.has('reasoning') || messages.has('reasoning_content')
+  const order = messages.has('timestamp') ? 'timestamp, id' : 'id'
+  const records = db
+    .prepare(
+      `SELECT id, role, CASE WHEN role IN ('user', 'assistant') THEN content END AS content, ${said('reasoning')}, ${said('reasoning_content')}, ${pick('tool_calls')}, ${pick('tool_call_id')}, ${pick('timestamp', '0')}
+       FROM messages WHERE session_id IN (${placeholders}) ${visible} ORDER BY ${order}`,
+    )
+    .all(...ids)
+  for (const record of records) {
+    const time = seconds(record.timestamp)
+    if (record.role === 'user') {
+      settleCalls(activity)
+      const prompt = text(record.content).trim()
+      if (prompt) keepNewest(prompts, { at: time, text: clipBlock(prompt, DETAIL_LIMITS.promptText) }, DETAIL_LIMITS.prompts)
+    } else if (record.role === 'assistant') {
+      keepText(thoughts, 'thoughts', { at: time, text: text(record.reasoning) || text(record.reasoning_content) })
+      keepText(replies, 'replies', { at: time, text: text(record.content) })
+      for (const call of (record.tool_calls && parseJson(record.tool_calls, [])) || []) {
+        if (!call?.id) continue
+        const args = callArgs(call)
+        startCall(activity, { id: text(call.id), name: text(call.function?.name), target: toolTarget(args, cwd), input: toolInput(args), ...toolFile(args, cwd), startedAt: time })
+      }
+    } else if (record.role === 'tool' && record.tool_call_id) {
+      endCall(activity, text(record.tool_call_id), time, null)
+    }
+  }
+  if (!open) settleCalls(activity)
+
+  const subagents = rows
+    .filter((r) => isErrand(r) && ids.includes(r.parent_session_id))
+    .map((r) => {
+      const working = turnOpen(r, chainOf(r).at(-1))
+      const label = TOOL_LABEL.exec(text(r.last_activity_description))
+      const tokens = ['input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_write_tokens'].map((c) => (r[c] == null ? null : number(r[c])))
+      return {
+        id: r.id,
+        name: text(r.title) || 'Subagent',
+        type: text(r.source) === 'subagent' ? '' : 'delegate',
+        status: working ? 'working' : FAILED_END.test(text(r.end_reason)) ? 'error' : r.ended_at != null ? 'done' : 'idle',
+        model: text(r.model),
+        tokens: tokens.some((t) => t != null) ? { input: tokens[0] || 0, output: tokens[1] || 0, cacheRead: tokens[2] || 0, cacheWrite: tokens[3] || 0 } : null,
+        tool: working && label ? toolNow({ name: label[1].trim(), startedAt: seconds(r.last_activity_at) }) : null,
+        startedAt: seconds(r.started_at),
+        lastActivityAt: lastAt(r),
+      }
+    })
+    .sort((a, b) => a.startedAt - b.startedAt)
+    .slice(-DETAIL_LIMITS.subagents)
+
+  const models = new Map()
+  for (const row of chain) {
+    const model = text(row.model)
+    if (!model) continue
+    const entry = models.get(model) || { model, tokens: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, costUsd: null }
+    entry.tokens.input += number(row.input_tokens)
+    entry.tokens.output += number(row.output_tokens)
+    entry.tokens.cacheRead += number(row.cache_read_tokens)
+    entry.tokens.cacheWrite += number(row.cache_write_tokens)
+    const cost = row.actual_cost_usd ?? row.estimated_cost_usd
+    if (cost != null) entry.costUsd = (entry.costUsd || 0) + number(cost)
+    models.set(model, entry)
+  }
+
+  const errors = chain
+    .filter((r) => FAILED_END.test(text(r.end_reason)))
+    .map((r) => ({ at: seconds(r.ended_at), message: `The session ended: ${text(r.end_reason)}` }))
+    .reverse()
+
+  return {
+    models: [...models.values()],
+    history: null,
+    compactions: null,
+    contextParts: null,
+    ...activityDetail(activity),
+    plan: planItems(latestPlan(db, ids, messages)),
+    subagents,
+    files: null,
+    prompts,
+    thoughts: reasons ? textList(thoughts) : null,
+    replies: textList(replies),
+    contextBreakdown: null,
+    errors,
+  }
+}
+
+function openCalls(db, sessionId, messages, visible, cwd) {
+  if (!['tool_calls', 'tool_call_id', 'timestamp'].every((c) => messages.has(c))) return []
+  const last = db
+    .prepare(`SELECT id, tool_calls, timestamp FROM messages WHERE session_id = ? AND role = 'assistant' ${visible} ORDER BY id DESC LIMIT 1`)
+    .get(sessionId)
+  if (!last?.tool_calls) return []
+  let calls
+  try {
+    calls = JSON.parse(last.tool_calls)
+  } catch {
+    return []
+  }
+  const answered = new Set(
+    db.prepare(`SELECT tool_call_id FROM messages WHERE session_id = ? AND role = 'tool' AND id > ?`).all(sessionId, last.id).map((r) => r.tool_call_id),
+  )
+  return (Array.isArray(calls) ? calls : [])
+    .filter((c) => c?.id && !answered.has(c.id))
+    .map((c) => openTool(text(c.function?.name), seconds(last.timestamp), callArgs(c), cwd))
+}
+
+const callArgs = (call) => (typeof call.function?.arguments === 'string' ? parseJson(call.function.arguments, null) : call.function?.arguments)
+
+function turnStart(db, ids, messages, visible) {
+  if (!messages.has('timestamp')) return null
+  const row = db
+    .prepare(`SELECT MAX(timestamp) AS at FROM messages WHERE session_id IN (${ids.map(() => '?').join(', ')}) AND role = 'user' ${visible}`)
+    .get(...ids)
+  return row?.at == null ? null : seconds(row.at)
+}
+
+function latestPlan(db, ids, messages) {
+  if (!messages.has('tool_name') || !messages.has('timestamp')) return null
+  const row = db
+    .prepare(
+      `SELECT content FROM messages WHERE session_id IN (${ids.map(() => '?').join(', ')}) AND role = 'tool' AND tool_name IN (${TODO_TOOLS.map(() => '?').join(', ')}) ORDER BY timestamp DESC, id DESC LIMIT 1`,
+    )
+    .get(...ids, ...TODO_TOOLS)
+  try {
+    const todos = JSON.parse(row?.content || '{}').todos
+    return Array.isArray(todos) ? todos.map((t) => ({ content: text(t?.content), status: text(t?.status) || 'pending' })) : null
+  } catch {
+    return null
+  }
+}
+
+function sum(chain, column) {
+  let total = 0
+  let known = false
+  for (const row of chain) {
+    if (row[column] == null) continue
+    total += number(row[column])
+    known = true
+  }
+  return known ? total : null
+}
+
+function toSession({ db, profile, tip, root, chain, ids, open, errands, workingSubagents, lengths, home, messages, visible, at, lastAt }) {
+  const description = text(tip.last_activity_description)
+  const placeholders = ids.map(() => '?').join(', ')
+  const calls = open ? openCalls(db, tip.id, messages, visible, text(tip.cwd)) : []
+  const working = calls.filter((c) => !DELEGATE_TOOLS.has(c.name))
+  const asking = ASKING.exec(description)
+  let status
+  let statusReason
+  if (open) {
+    if (asking) [status, statusReason] = ['asking', /approval/i.test(asking[1]) ? 'approval' : 'question']
+    else if (!working.length && (calls.length || errands)) [status, statusReason] = ['delegating', 'subagents']
+    else [status, statusReason] = ['working', 'turn-open']
+  } else if (errands) [status, statusReason] = ['delegating', 'subagents']
+  else if (tip.last_read_at != null) [status, statusReason] = seconds(tip.last_activity_at || tip.started_at) > seconds(tip.last_read_at) ? ['done', 'unread'] : ['idle', 'read']
+  else [status, statusReason] = tip.ended_at == null && at - lastAt < ACTIVE_WINDOW_MS ? ['done', 'recent'] : ['idle', 'quiet']
+
+  let tool = null
+  if (status === 'working' || status === 'delegating') {
+    const latest = (working.length ? working : calls).at(-1)
+    const label = TOOL_LABEL.exec(description)
+    if (latest) tool = toolNow(latest)
+    else if (label) tool = toolNow({ name: label[1].trim(), startedAt: seconds(tip.last_activity_at) })
+  }
+
+  const where = text(tip.git_repo_root) || text(tip.cwd)
+  const userHome = os.homedir()
+  const atHome = !where || where === userHome || where === home || where === path.join(userHome, '.hermes')
+  const anchor = tip.config._usage_anchor
+  const used = anchor ? number(anchor.prompt_tokens) + number(anchor.completion_tokens) : 0
+  const reasoning = tip.config.reasoning_config
+  const tokens = ['input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_write_tokens'].map((c) => sum(chain, c))
+  const costs = chain.map((r) => r.actual_cost_usd ?? r.estimated_cost_usd)
+  const firstPrompt = db
+    .prepare(`SELECT content FROM messages WHERE session_id = ? AND role = 'user' ORDER BY id ASC LIMIT 1`)
+    .get(root.id)?.content
+  const prompts = db.prepare(`SELECT COUNT(*) AS n FROM messages WHERE session_id IN (${placeholders}) AND role = 'user' ${visible}`).get(...ids)
+
+  return {
+    id: `hermes:${profile}:${root.id}`,
+    harness: 'hermes',
+    title: titleFromPrompt(text(tip.title) || text(root.title) || text(firstPrompt)) || 'Untitled session',
+    project: atHome ? 'Hermes' : path.basename(where.replace(/\\/g, '/')),
+    projectPath: atHome ? userHome : where,
+    worktree: '',
+    cwd: text(tip.cwd),
+    gitBranch: text(tip.git_branch),
+    model: text(tip.model),
+    effort: reasoning && reasoning.enabled !== false ? text(reasoning.effort) : '',
+    status,
+    live: open,
+    startedAt: seconds(root.started_at),
+    lastActivityAt: lastAt,
+    tool,
+    tokens: tokens.some((t) => t != null)
+      ? { input: tokens[0] || 0, output: tokens[1] || 0, cacheRead: tokens[2] || 0, cacheWrite: tokens[3] || 0 }
+      : null,
+    context: used ? { used, limit: contextLimit(lengths, text(tip.model), tip.billing_base_url) } : null,
+    contextHistory: null,
+    costUsd: costs.some((c) => c != null) ? costs.reduce((total, c) => total + number(c), 0) : null,
+    lines: null,
+    plan: planSummary(latestPlan(db, ids, messages)),
+    subagents: errands,
+    workingSubagents,
+    prompts: number(prompts?.n),
+    turnStartedAt: open ? turnStart(db, ids, messages, visible) : null,
+    statusReason,
+    ask: askOf(status),
+    usageLimits: null,
+  }
+}
+
+export default hermes()