Function generateSessionTitle

src/utils/sessionTitle.ts:81–139

(
  description: string,
  signal: AbortSignal,
)

 * @param signal - Abort signal for cancellation
 */
export async function generateSessionTitle(
  description: string,
  signal: AbortSignal,
): Promise<string | null> {
  const trimmed = description.trim()
  if (!trimmed) return null

  // Avoid a duplicate background API error on first prompt when the user
  // is not logged in. The main turn submission already surfaces the auth
  // failure; title generation should quietly skip in that state.
  if (getAPIProvider() === 'firstParty' && getAuthHeaders().error) {
    return null
  }

  try {
    const result = await queryHaiku({
      systemPrompt: asSystemPrompt([SESSION_TITLE_PROMPT]),
      userPrompt: trimmed,
      outputFormat: {
        type: 'json_schema',
        schema: {
          type: 'object',
          properties: {
            title: { type: 'string' },
          },
          required: ['title'],
          additionalProperties: false,
        },
      },
      signal,
      options: {
        querySource: 'generate_session_title',
        agents: [],
        // Reflect the actual session mode — this module is called from
        // both the SDK print path (non-interactive) and the CCR remote
        // session path via useRemoteSession (interactive).
        isNonInteractiveSession: getIsNonInteractiveSession(),
        hasAppendSystemPrompt: false,
        mcpTools: [],
      },
    })

    const text = extractTextContent(result.message.content)
    const parsed = titleSchema().safeParse(
      text.trim().startsWith('{') ? safeParseJSON(text, false) : null,
    )
    const title = parsed.success ? parsed.data.title.trim() || null : null

    logEvent('ncode_session_title_generated', { success: title !== null })

    return title
  } catch (error) {
    logForDebugging(`generateSessionTitle failed: ${error}`, {
      level: 'error',
    })
    logEvent('ncode_session_title_generated', { success: false })
    return null
  }