283 lines
8.8 KiB
TypeScript
283 lines
8.8 KiB
TypeScript
/**
|
||
* Shared agent detection utilities — used by both the main process (stats
|
||
* collection) and the renderer (activity indicators, unread badges).
|
||
*
|
||
* Why shared: the main process needs the same OSC title extraction and agent
|
||
* status detection for stat tracking that the renderer uses for UI indicators.
|
||
* Duplicating this logic would risk drift between the two detection paths.
|
||
*/
|
||
|
||
export type AgentStatus = 'working' | 'permission' | 'idle'
|
||
|
||
const CLAUDE_IDLE = '\u2733' // ✳ (eight-spoked asterisk — Claude Code idle prefix)
|
||
|
||
const GEMINI_WORKING = '\u2726' // ✦
|
||
const GEMINI_SILENT_WORKING = '\u23F2' // ⏲
|
||
const GEMINI_IDLE = '\u25C7' // ◇
|
||
const GEMINI_PERMISSION = '\u270B' // ✋
|
||
|
||
export const AGENT_NAMES = ['claude', 'codex', 'gemini', 'opencode', 'aider']
|
||
const PI_IDLE_PREFIX = '\u03c0 - ' // π - (Pi titlebar extension idle format)
|
||
|
||
// eslint-disable-next-line no-control-regex -- intentional terminal escape sequence matching
|
||
const OSC_TITLE_RE = /\x1b\]([012]);([^\x07\x1b]*?)(?:\x07|\x1b\\)/g
|
||
|
||
/**
|
||
* Extract the last OSC title-set sequence from raw PTY data.
|
||
* Agent CLIs (Claude Code, Gemini, etc.) set OSC titles to announce their
|
||
* identity and status. This is a single regex scan — comparable cost to one
|
||
* normalizeTerminalChunk pass.
|
||
*/
|
||
export function extractLastOscTitle(data: string): string | null {
|
||
let last: string | null = null
|
||
let m: RegExpExecArray | null
|
||
OSC_TITLE_RE.lastIndex = 0
|
||
while ((m = OSC_TITLE_RE.exec(data)) !== null) {
|
||
last = m[2]
|
||
}
|
||
return last
|
||
}
|
||
|
||
export function isGeminiTerminalTitle(title: string): boolean {
|
||
return (
|
||
title.includes(GEMINI_PERMISSION) ||
|
||
title.includes(GEMINI_WORKING) ||
|
||
title.includes(GEMINI_SILENT_WORKING) ||
|
||
title.includes(GEMINI_IDLE) ||
|
||
title.toLowerCase().includes('gemini')
|
||
)
|
||
}
|
||
|
||
export function isPiTerminalTitle(title: string): boolean {
|
||
return title.startsWith(PI_IDLE_PREFIX)
|
||
}
|
||
|
||
function containsBrailleSpinner(title: string): boolean {
|
||
for (const char of title) {
|
||
const codePoint = char.codePointAt(0)
|
||
if (codePoint !== undefined && codePoint >= 0x2800 && codePoint <= 0x28ff) {
|
||
return true
|
||
}
|
||
}
|
||
return false
|
||
}
|
||
|
||
function containsAgentName(title: string): boolean {
|
||
const lower = title.toLowerCase()
|
||
return AGENT_NAMES.some((name) => lower.includes(name))
|
||
}
|
||
|
||
function containsAny(title: string, words: string[]): boolean {
|
||
const lower = title.toLowerCase()
|
||
return words.some((word) => lower.includes(word))
|
||
}
|
||
|
||
const WORKING_KEYWORDS = ['working', 'thinking', 'running']
|
||
|
||
/**
|
||
* Strip working-status indicators from a title so that
|
||
* `detectAgentStatusFromTitle` will no longer return 'working'.
|
||
* Used to clear stale titles when an agent exits without resetting its title.
|
||
*/
|
||
export function clearWorkingIndicators(title: string): string {
|
||
let cleaned = title
|
||
|
||
// Gemini working symbols
|
||
cleaned = cleaned.replace(GEMINI_WORKING, '')
|
||
cleaned = cleaned.replace(GEMINI_SILENT_WORKING, '')
|
||
|
||
// Braille spinner characters (U+2800–U+28FF)
|
||
// eslint-disable-next-line no-control-regex -- intentional unicode range
|
||
cleaned = cleaned.replace(/[\u2800-\u28FF]/g, '')
|
||
|
||
// Claude Code ". " working prefix
|
||
if (cleaned.startsWith('. ')) {
|
||
cleaned = cleaned.slice(2)
|
||
}
|
||
|
||
// Strip working keywords that detectAgentStatusFromTitle would pick up
|
||
// when the title also contains an agent name.
|
||
if (containsAgentName(cleaned)) {
|
||
for (const keyword of WORKING_KEYWORDS) {
|
||
cleaned = cleaned.replace(new RegExp(`\\b${keyword}\\b`, 'gi'), '')
|
||
}
|
||
}
|
||
|
||
// Collapse whitespace after removals
|
||
cleaned = cleaned.replace(/\s{2,}/g, ' ').trim()
|
||
|
||
return cleaned || title
|
||
}
|
||
|
||
/**
|
||
* Tracks agent status transitions from terminal title changes.
|
||
* Fires `onBecameIdle` when an agent transitions from working to idle/permission,
|
||
* like haunt's attention flag — the key trigger for unread notifications.
|
||
*/
|
||
export function createAgentStatusTracker(
|
||
onBecameIdle: (title: string) => void,
|
||
onBecameWorking?: () => void,
|
||
onAgentExited?: () => void
|
||
): {
|
||
handleTitle: (title: string) => void
|
||
} {
|
||
let lastStatus: AgentStatus | null = null
|
||
|
||
return {
|
||
handleTitle(title: string): void {
|
||
const newStatus = detectAgentStatusFromTitle(title)
|
||
if (lastStatus === 'working' && newStatus !== null && newStatus !== 'working') {
|
||
onBecameIdle(title)
|
||
}
|
||
if (lastStatus !== 'working' && newStatus === 'working') {
|
||
onBecameWorking?.()
|
||
}
|
||
// Why: when the title reverts to a plain shell prompt (e.g., "bash", "zsh"),
|
||
// detectAgentStatusFromTitle returns null. If we were idle or in a permission
|
||
// prompt, this means the user exited the agent — clear session-tied state
|
||
// (like the prompt-cache countdown). We intentionally do NOT fire this when
|
||
// lastStatus is 'working', because active agents can briefly flash shell
|
||
// titles during internal operations without actually exiting.
|
||
if (lastStatus !== null && lastStatus !== 'working' && newStatus === null) {
|
||
lastStatus = null
|
||
onAgentExited?.()
|
||
}
|
||
if (newStatus !== null) {
|
||
lastStatus = newStatus
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Normalize high-churn agent titles into stable display labels before storing
|
||
* them in app state. Gemini CLI can emit per-keystroke title updates, which
|
||
* otherwise causes broad rerenders and visible flashing.
|
||
*/
|
||
export function normalizeTerminalTitle(title: string): string {
|
||
if (!title) {
|
||
return title
|
||
}
|
||
|
||
if (isGeminiTerminalTitle(title)) {
|
||
const status = detectAgentStatusFromTitle(title)
|
||
if (status === 'permission') {
|
||
return `${GEMINI_PERMISSION} Gemini CLI`
|
||
}
|
||
if (status === 'working') {
|
||
return `${GEMINI_WORKING} Gemini CLI`
|
||
}
|
||
if (status === 'idle') {
|
||
return `${GEMINI_IDLE} Gemini CLI`
|
||
}
|
||
}
|
||
|
||
// Why: Pi's titlebar extension animates every 80ms with different braille
|
||
// frames. Collapsing those frames into one stable label avoids renderer
|
||
// churn while preserving the working/idle transition Orca keys off.
|
||
if (
|
||
isPiTerminalTitle(title) ||
|
||
(containsBrailleSpinner(title) && title.includes(PI_IDLE_PREFIX))
|
||
) {
|
||
const status = detectAgentStatusFromTitle(title)
|
||
if (status === 'working') {
|
||
return '\u280b Pi'
|
||
}
|
||
if (status === 'idle') {
|
||
return 'Pi'
|
||
}
|
||
}
|
||
|
||
return title
|
||
}
|
||
|
||
/**
|
||
* Returns true when the terminal title matches Claude Code's title conventions.
|
||
* Used to scope prompt-cache-timer behavior to Claude sessions only — other
|
||
* agents have different (or no) caching semantics.
|
||
*/
|
||
export function isClaudeAgent(title: string): boolean {
|
||
if (!title) {
|
||
return false
|
||
}
|
||
|
||
// Why: Claude Code titles are prefixed with status indicators (✳, ". ", "* ",
|
||
// braille spinners) followed by the task description. The task text can
|
||
// legitimately mention other agents, so Claude-specific prefixes must win.
|
||
if (title.startsWith(`${CLAUDE_IDLE} `) || title === CLAUDE_IDLE) {
|
||
return true
|
||
}
|
||
// Why: ". " (working) and "* " (idle) are Claude Code title conventions.
|
||
// Other supported agents do not use them, and rejecting titles that mention
|
||
// another agent in the task text caused false negatives for real Claude tabs.
|
||
if (title.startsWith('. ') || title.startsWith('* ')) {
|
||
return true
|
||
}
|
||
if (containsBrailleSpinner(title)) {
|
||
return true
|
||
}
|
||
// Why: permission/action-required Claude titles can omit the usual prefixes.
|
||
// Requiring "claude" at the start avoids false positives from other agents
|
||
// whose task text merely mentions Claude.
|
||
if (title.toLowerCase().startsWith('claude')) {
|
||
return true
|
||
}
|
||
|
||
return false
|
||
}
|
||
|
||
export function detectAgentStatusFromTitle(title: string): AgentStatus | null {
|
||
if (!title) {
|
||
return null
|
||
}
|
||
|
||
// Gemini CLI symbols are the most specific and should take precedence.
|
||
if (title.includes(GEMINI_PERMISSION)) {
|
||
return 'permission'
|
||
}
|
||
if (title.includes(GEMINI_WORKING) || title.includes(GEMINI_SILENT_WORKING)) {
|
||
return 'working'
|
||
}
|
||
if (title.includes(GEMINI_IDLE)) {
|
||
return 'idle'
|
||
}
|
||
|
||
// Claude Code uses ✳ prefix for idle — must check before braille/agent-name
|
||
// because the title text is the task description, not "Claude Code".
|
||
if (title.startsWith(`${CLAUDE_IDLE} `) || title === CLAUDE_IDLE) {
|
||
return 'idle'
|
||
}
|
||
|
||
if (isPiTerminalTitle(title)) {
|
||
return 'idle'
|
||
}
|
||
|
||
if (containsBrailleSpinner(title)) {
|
||
return 'working'
|
||
}
|
||
|
||
if (containsAgentName(title)) {
|
||
if (containsAny(title, ['action required', 'permission', 'waiting'])) {
|
||
return 'permission'
|
||
}
|
||
if (containsAny(title, ['ready', 'idle', 'done'])) {
|
||
return 'idle'
|
||
}
|
||
if (containsAny(title, ['working', 'thinking', 'running'])) {
|
||
return 'working'
|
||
}
|
||
|
||
// Claude Code title prefixes: ". " = working, "* " = idle
|
||
if (title.startsWith('. ')) {
|
||
return 'working'
|
||
}
|
||
if (title.startsWith('* ')) {
|
||
return 'idle'
|
||
}
|
||
|
||
return 'idle'
|
||
}
|
||
|
||
return null
|
||
}
|