Function loadMostRecentChatState

cli/src/utils/run-state-storage.ts:103–174

(
  chatId?: string,
)

 * Returns null if no previous chat exists or files can't be parsed.
 */
export function loadMostRecentChatState(
  chatId?: string,
): SavedChatState | null {
  try {
    let chatDir: string | null = null

    if (chatId && chatId.trim().length > 0) {
      const baseDir = path.join(getProjectDataDir(), 'chats')
      const candidateDir = path.join(baseDir, chatId.trim())
      if (
        fs.existsSync(candidateDir) &&
        fs.statSync(candidateDir).isDirectory()
      ) {
        chatDir = candidateDir
      } else {
        logger.debug(
          { candidateDir, chatId },
          'Requested chatId directory not found, falling back to most recent chat directory',
        )
      }
    }

    if (!chatDir) {
      chatDir = getMostRecentChatDir()
    }

    if (!chatDir) {
      logger.debug('No previous chat directory found')
      return null
    }

    const runStatePath = path.join(chatDir, RUN_STATE_FILENAME)
    const messagesPath = path.join(chatDir, CHAT_MESSAGES_FILENAME)

    if (!fs.existsSync(runStatePath) || !fs.existsSync(messagesPath)) {
      logger.debug(
        { runStatePath, messagesPath },
        'Missing state files in chat directory',
      )
      return null
    }

    const runStateContent = fs.readFileSync(runStatePath, 'utf8')
    const messagesContent = fs.readFileSync(messagesPath, 'utf8')

    const runState = JSON.parse(runStateContent) as RunState
    runState.traceSessionId ??= randomUUID()
    const messages = JSON.parse(messagesContent) as ChatMessage[]

    const resolvedChatId = path.basename(chatDir)

    logger.info(
      {
        runStatePath,
        messagesPath,
        messageCount: messages.length,
        chatId: resolvedChatId,
      },