Inbox & Archive

/**
 * List flagged sessions (excludes archived)
 */
export function listFlaggedSessions(
  workspaceRootPath: string
): SessionMetadata[] {
  return listActiveSessions(workspaceRootPath).filter(
    s => s.isFlagged === true
  );
}

/**
 * Flag a session
 */
export async function flagSession(
  workspaceRootPath: string,
  sessionId: string
): Promise<void> {
  await updateSessionMetadata(workspaceRootPath, sessionId, {
    isFlagged: true
  });
}

export interface SessionConfig {
  // ... other fields ...
  
  /** Whether this session is archived */
  isArchived?: boolean;
  
  /** Timestamp when session was archived (for retention policy) */
  archivedAt?: number;
}

/**
 * Delete archived sessions older than the specified number of days
 * Returns the number of sessions deleted
 */
export function deleteOldArchivedSessions(
  workspaceRootPath: string,
  retentionDays: number
): number {
  const cutoffTime = Date.now() - (retentionDays * 24 * 60 * 60 * 1000);
  const archivedSessions = listArchivedSessions(workspaceRootPath);
  let deletedCount = 0;

  for (const session of archivedSessions) {
    const archiveTime = session.archivedAt ?? session.lastUsedAt;
    if (archiveTime < cutoffTime) {
      if (deleteSession(workspaceRootPath, session.id)) {
        deletedCount++;
      }
    }
  }

  return deletedCount;
}

// All non-archived sessions
const active = listActiveSessions(workspaceRootPath);

// Sessions with open status (inbox)
const inbox = listInboxSessions(workspaceRootPath);

// Sessions with closed status (archive)
const completed = listCompletedSessions(workspaceRootPath);

// Flagged sessions (excludes archived)
const flagged = listFlaggedSessions(workspaceRootPath);

// Archived sessions only
const archived = listArchivedSessions(workspaceRootPath);

export interface SessionConfig {
  /** ID of last message user has read */
  lastReadMessageId?: string;
  
  /**
   * Explicit unread flag - single source of truth for NEW badge.
   * Set to true when assistant message completes while user is NOT viewing.
   * Set to false when user views the session (and not processing).
   */
  hasUnread?: boolean;
}