Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

9.0 KB
Raw Blame
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { appendFileSync, mkdirSync, mkdtempSync, rmSync, utimesSync, writeFileSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { cleanCodexTitle, cleanOmpTitle, codexThreadName, engineSessionTitle, namingTitle, ompSessionTitle, resetCodexThreadNames } from './sessionTitle.js'

describe('namingTitle: the engine’s title, when it names the session', () => {
  const harness = { engine: 'claude', cwd: '/Users/example/harnesses/harness-43', defaultName: 'harness-43' }

  it('takes a conversation title as it is', () => {
    expect(namingTitle('Unitree Go2 squats and wave', harness)).toBe('Unitree Go2 squats and wave')
  })

  it('is no name while the title is only the engine, the folder or the default name', () => {
    for (const title of ['Claude Code', 'claude', 'CODEX', 'harness-43', 'Harness-43', '  ', '', null, undefined]) {
      expect(namingTitle(title, harness)).toBeNull()
    }
    expect(namingTitle('harness-43', { engine: 'claude', cwd: '/elsewhere/x', defaultName: 'harness-43' })).toBeNull()
    expect(namingTitle('project', { engine: 'claude', cwd: '/Users/example/project' })).toBeNull()
    expect(namingTitle('Something', {})).toBe('Something')
  })

  it('drops OpenCode’s and Kilo’s short-name prefix', () => {
    expect(namingTitle('OC | Greeting', { engine: 'opencode' })).toBe('Greeting')
    expect(namingTitle('Kilo | Refactor the parser', { engine: 'kilo' })).toBe('Refactor the parser')
    expect(namingTitle('OC | opencode', { engine: 'opencode' })).toBeNull()
  })

  it('reads a Codex title without its status words and folder', () => {
    const codex = { engine: 'codex', cwd: '/Users/example/harnesses/harness-36' }
    expect(namingTitle('Action Required | Build 555 LED flasher | harness-36', codex)).toBe('Build 555 LED flasher')
    expect(namingTitle('Build brick breaker game | harness-36', codex)).toBe('Build brick breaker game')
    expect(namingTitle('Working | harness-36', codex)).toBeNull()
    expect(namingTitle('codex | Ready', codex)).toBeNull()
  })

  it.each([
    'renaming',
    'renaming...',
    'Renaming…',
    'renaming... ⠹',
    'renaming... ⠴',
    'renaming… ⠦',
    'renaming ⠋',
    'Working... ⠹',
    '[ ! ] Action Required…',
    'renaming... ⠹ | golden-koala',
  ])('ignores the temporary Codex status %s', (title) => {
    expect(namingTitle(title, { engine: 'codex', cwd: '/src/golden-koala' })).toBeNull()
  })

  it('keeps conversation titles about renaming and strips only the separate status', () => {
    const codex = { engine: 'codex', cwd: '/src/golden-koala' }
    expect(namingTitle('Renaming branches safely', codex)).toBe('Renaming branches safely')
    expect(namingTitle('Working with multiple machines', codex)).toBe('Working with multiple machines')
    expect(namingTitle('renaming... ⠹ | Improve multiple-machine experience | golden-koala', codex))
      .toBe('Improve multiple-machine experience')
  })
})

describe('cleanCodexTitle', () => {
  it('keeps every part that is not a status word, the banner, the app name or the folder', () => {
    expect(cleanCodexTitle('[ ! ] Action Required | Fix the flaky test | repo', '/src/repo')).toBe('Fix the flaky test')
    expect(cleanCodexTitle('[ . ] Action Required | Fix it', null)).toBe('Fix it')
    expect(cleanCodexTitle('Starting | Thinking | Waiting | Ready | Working', undefined)).toBe('')
    expect(cleanCodexTitle('Compare A | B options | main', '/src/other')).toBe('Compare A | B options | main')
  })
})

describe('codexThreadName: Codex’s own name for a thread', () => {
  let home: string
  const savedHome = process.env.CODEX_HOME
  beforeEach(() => {
    home = mkdtempSync(join(tmpdir(), 'codex-home-'))
    resetCodexThreadNames()
  })
  afterEach(() => {
    rmSync(home, { recursive: true, force: true })
    if (savedHome === undefined) delete process.env.CODEX_HOME
    else process.env.CODEX_HOME = savedHome
    resetCodexThreadNames()
  })
  const index = (lines: string[]) => writeFileSync(join(home, 'session_index.jsonl'), lines.join('\n') + '\n')

  it('reads the latest name for the session and skips torn or unnamed lines', () => {
    index([
      JSON.stringify({ id: 't1', thread_name: 'First name' }),
      '{"id":"t2","thread_na',
      JSON.stringify({ id: 't3', thread_name: '   ' }),
      JSON.stringify({ id: 't4' }),
      '',
      JSON.stringify({ id: 't1', thread_name: ' Renamed thread ' }),
    ])
    expect(codexThreadName('t1', home)).toBe('Renamed thread')
    expect(codexThreadName('t2', home)).toBeNull()
    expect(codexThreadName('t3', home)).toBeNull()
    expect(codexThreadName('t9', home)).toBeNull()
  })

  it('rereads the index only when it changes', () => {
    index([JSON.stringify({ id: 't1', thread_name: 'Before' })])
    expect(codexThreadName('t1', home)).toBe('Before')
    appendFileSync(join(home, 'session_index.jsonl'), JSON.stringify({ id: 't1', thread_name: 'After /rename' }) + '\n')
    const later = new Date(Date.now() + 5_000)
    utimesSync(join(home, 'session_index.jsonl'), later, later)
    expect(codexThreadName('t1', home)).toBe('After /rename')
  })

  it('uses CODEX_HOME when the agent has no profile folder, and is no name without a file or a session', () => {
    index([JSON.stringify({ id: 't1', thread_name: 'From the env home' })])
    process.env.CODEX_HOME = home
    expect(codexThreadName('t1')).toBe('From the env home')
    expect(codexThreadName(null, home)).toBeNull()
    expect(codexThreadName('t1', join(home, 'missing'))).toBeNull()
  })

  it('is no name when the index cannot be read', () => {
    mkdirSync(join(home, 'session_index.jsonl')) // stat succeeds, reading a directory fails
    expect(codexThreadName('t1', home)).toBeNull()
  })

  it('falls back to ~/.codex when neither the agent nor the environment names a Codex home', async () => {
    const savedUserHome = process.env.HOME
    const savedProfile = process.env.USERPROFILE
    delete process.env.CODEX_HOME
    process.env.HOME = home
    process.env.USERPROFILE = home
    try {
      mkdirSync(join(home, '.codex'))
      writeFileSync(join(home, '.codex', 'session_index.jsonl'), JSON.stringify({ id: 't1', thread_name: 'Default home' }) + '\n')
      // Configuration is captured at process startup; give this fresh HOME a fresh config module too.
      vi.resetModules()
      const fresh = await import('./sessionTitle.js')
      expect(fresh.codexThreadName('t1')).toBe('Default home')
    } finally {
      process.env.HOME = savedUserHome
      if (savedProfile === undefined) delete process.env.USERPROFILE; else process.env.USERPROFILE = savedProfile
    }
  })
})

describe('engineSessionTitle: what the terminal sweep records', () => {
  let home: string
  beforeEach(() => { home = mkdtempSync(join(tmpdir(), 'codex-home-')); resetCodexThreadNames() })
  afterEach(() => { rmSync(home, { recursive: true, force: true }); resetCodexThreadNames() })

  it('prefers Codex’s thread name, then the terminal title, for Codex; the terminal title for everyone else', () => {
    writeFileSync(join(home, 'session_index.jsonl'), JSON.stringify({ id: 's1', thread_name: 'Design a cable clip' }) + '\n')
    expect(engineSessionTitle({ engine: 'codex', sessionId: 's1', codexHome: home }, 'Working | harness-40')).toBe('Design a cable clip')
    expect(engineSessionTitle({ engine: 'codex', sessionId: 's2', codexHome: home }, 'Working | harness-40')).toBe('Working | harness-40')
    expect(engineSessionTitle({ engine: 'codex', sessionId: 's2', codexHome: home }, undefined)).toBeNull()
    expect(engineSessionTitle({ engine: 'claude', sessionId: 's1', codexHome: home }, '✳ Plan the launch')).toBe('✳ Plan the launch')
  })
})

describe('omp titles', () => {
  it('strips the π name, the status or spinner mark and the topic icon', () => {
    for (const raw of ['π ⠴ \u{F08F3} Login: Fix redirect', 'π ⠙ \u{F08F3} Login: Fix redirect', 'π > \u{F08F3} Login: Fix redirect', 'π * \u{F08F3} Login: Fix redirect', '\u{F08F3} Login: Fix redirect', 'Login: Fix redirect']) {
      expect(cleanOmpTitle(raw)).toBe('Login: Fix redirect')
    }
    expect(cleanOmpTitle('π ⠴ ')).toBeNull()
    expect(cleanOmpTitle('')).toBeNull()
  })

  it('reads the title line at the head of an omp session file, falling back to it without a terminal title', () => {
    const dir = mkdtempSync(join(tmpdir(), 'omp-title-'))
    const file = join(dir, 's.jsonl')
    writeFileSync(file, JSON.stringify({ type: 'title', v: 1, title: '\u{F08F3} Login: Fix the redirect loop', source: 'auto', pad: '   ' }) + '\n'
      + JSON.stringify({ type: 'session', id: 'x' }) + '\n')
    expect(ompSessionTitle(file)).toBe('Login: Fix the redirect loop')
    expect(ompSessionTitle(join(dir, 'missing.jsonl'))).toBeNull()
    expect(engineSessionTitle({ engine: 'omp', transcriptPath: file }, undefined)).toBe('Login: Fix the redirect loop')
    expect(engineSessionTitle({ engine: 'omp', transcriptPath: file }, 'π ⠋ Renamed topic')).toBe('Renamed topic')
    rmSync(dir, { recursive: true, force: true })
  })
})