Function getAllSessionFiles

packages/cli/src/utils/sessionUtils.ts:237–354

(
  chatsDir: string,
  currentSessionId?: string,
  options: GetSessionOptions = {},
)

 * @returns Array of session file entries, with sessionInfo null for corrupted files
 */
export const getAllSessionFiles = async (
  chatsDir: string,
  currentSessionId?: string,
  options: GetSessionOptions = {},
): Promise<SessionFileEntry[]> => {
  try {
    const files = await fs.readdir(chatsDir);
    const sessionFiles = files
      .filter(
        (f) =>
          f.startsWith(SESSION_FILE_PREFIX) &&
          (f.endsWith('.json') || f.endsWith('.jsonl')),
      )
      .sort(); // Sort by filename, which includes timestamp

    const sessionPromises = sessionFiles.map(
      async (file): Promise<SessionFileEntry> => {
        const filePath = path.join(chatsDir, file);
        try {
          const content = await loadConversationRecord(filePath, {
            metadataOnly: !options.includeFullContent,
          });
          if (!content) {
            return { fileName: file, sessionInfo: null };
          }

          // Validate required fields
          if (!content.sessionId) {
            // Missing required fields - treat as corrupted
            return { fileName: file, sessionInfo: null };
          }

          const fileTimestamp =
            !content.startTime || !content.lastUpdated
              ? (
                  await fs.stat(filePath).catch(() => undefined)
                )?.mtime.toISOString()
              : undefined;
          const fallbackTimestamp = fileTimestamp ?? new Date().toISOString();
          const startTime =
            content.startTime || content.lastUpdated || fallbackTimestamp;
          const lastUpdated =
            content.lastUpdated || content.startTime || fallbackTimestamp;

          // Skip sessions with no resumable conversation content, including
          // startup-only, system-only, command-only, and internal-context-only
          // sessions.
          if (!content.hasResumableContent) {
            return { fileName: file, sessionInfo: null };
          }

          // Skip subagent sessions - these are implementation details of a tool call
          // and shouldn't be surfaced for resumption in the main agent history.
          if (content.kind === 'subagent') {
            return { fileName: file, sessionInfo: null };
          }

          const firstUserMessage = content.firstUserMessage