/** * Server-driven session auto-titling (services/session-titles.ts). * * REPL-bridge workers title their own sessions (PATCH /v1/sessions/:id via * updateBridgeSessionTitle); headless workers never do. The server fires a * generate_session_title control_request after the first completed turn of an * untitled session and applies the worker's title from the control_response. */ import { describe, test, expect, beforeEach, mock } from 'bun:test' import { mockConfigModule } from './helpers/mock-config' mock.module('../config', () => mockConfigModule({})) import { freshDb } from './helpers/db' import { storeReset } from '../store' import { createSession, getSession, updateSessionTitle, } from '../services/session' import { publishSessionEvent } from '../services/transport' import { getEventBus, type SessionEvent } from '../transport/event-bus' import { maybeRequestSessionTitle, handleTitleControlResponse, resetSessionTitleState, } from '../services/session-titles' beforeEach(() => { freshDb() storeReset() resetSessionTitleState() }) function makeUntitledSession(): string { const session = createSession({ source: 'cli' }) return session.id } /** Capture outbound control_request events published on the bus. */ function captureOutbound(sessionId: string): SessionEvent[] { const captured: SessionEvent[] = [] getEventBus(sessionId).subscribe(e => { if (e.direction === 'outbound') captured.push(e) }) return captured } function seedFirstUserMessage(sessionId: string, text: string): void { publishSessionEvent( sessionId, 'user', { type: 'user', content: text, message: { content: text } }, 'outbound', ) } describe('maybeRequestSessionTitle', () => { test('fires generate_session_title with the first user message as description', () => { const sessionId = makeUntitledSession() seedFirstUserMessage(sessionId, '帮我分析这个仓库的架构') const captured = captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) expect(captured.length).toBe(1) const payload = captured[0].payload as Record expect(captured[0].type).toBe('control_request') expect(typeof payload.request_id).toBe('string') expect((payload.request_id as string).startsWith('srv-title-')).toBe(true) expect(payload.request).toEqual({ subtype: 'generate_session_title', description: '帮我分析这个仓库的架构', persist: true, }) }) test('skips sessions that already have a title', () => { const session = createSession({ source: 'cli', title: '已有标题' }) seedFirstUserMessage(session.id, 'hello') const captured = captureOutbound(session.id) maybeRequestSessionTitle(session.id) expect(captured.length).toBe(0) }) test('skips sessions with no user message in the event log', () => { const sessionId = makeUntitledSession() const captured = captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) expect(captured.length).toBe(0) }) test('fires at most once per session even across repeated results', () => { const sessionId = makeUntitledSession() seedFirstUserMessage(sessionId, 'first') const captured = captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) maybeRequestSessionTitle(sessionId) expect(captured.length).toBe(1) }) test('extracts text from content-block user messages', () => { const sessionId = makeUntitledSession() publishSessionEvent( sessionId, 'user', { message: { role: 'user', content: [ { type: 'image', source: { type: 'base64', data: 'x' } }, { type: 'text', text: '看这张截图' }, ], }, }, 'inbound', ) const captured = captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) const payload = captured[0].payload as Record const request = payload.request as Record expect(request.description).toBe('看这张截图') }) }) describe('handleTitleControlResponse', () => { test('applies the worker title on matching success response', () => { const sessionId = makeUntitledSession() seedFirstUserMessage(sessionId, '写一个排序算法') const captured = captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) const requestId = (captured[0].payload as Record) .request_id as string handleTitleControlResponse(sessionId, { subtype: 'success', request_id: requestId, response: { title: '排序算法实现' }, }) expect(getSession(sessionId)?.title).toBe('排序算法实现') }) test('error response (REPL worker) gives up without a title', () => { const sessionId = makeUntitledSession() seedFirstUserMessage(sessionId, 'hello') const captured = captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) const requestId = (captured[0].payload as Record) .request_id as string handleTitleControlResponse(sessionId, { subtype: 'error', request_id: requestId, error: 'REPL bridge does not handle control_request subtype', }) expect(getSession(sessionId)?.title).toBeNull() }) test('non-matching request_id is ignored', () => { const sessionId = makeUntitledSession() seedFirstUserMessage(sessionId, 'hello') captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) handleTitleControlResponse(sessionId, { subtype: 'success', request_id: 'req-somebody-else', response: { title: 'wrong title' }, }) expect(getSession(sessionId)?.title).toBeNull() }) test('does not clobber a title set in the meantime', () => { const sessionId = makeUntitledSession() seedFirstUserMessage(sessionId, 'hello') const captured = captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) const requestId = (captured[0].payload as Record) .request_id as string // User renamed the session while the worker was generating updateSessionTitle(sessionId, '用户重命名') handleTitleControlResponse(sessionId, { subtype: 'success', request_id: requestId, response: { title: 'AI 生成标题' }, }) expect(getSession(sessionId)?.title).toBe('用户重命名') }) test('rejects empty and oversized titles', () => { const sessionId = makeUntitledSession() seedFirstUserMessage(sessionId, 'hello') const captured = captureOutbound(sessionId) maybeRequestSessionTitle(sessionId) const requestId = (captured[0].payload as Record) .request_id as string handleTitleControlResponse(sessionId, { subtype: 'success', request_id: requestId, response: { title: ' ' }, }) expect(getSession(sessionId)?.title).toBeNull() handleTitleControlResponse(sessionId, { subtype: 'success', request_id: requestId, response: { title: 'x'.repeat(201) }, }) expect(getSession(sessionId)?.title).toBeNull() }) })