CODEX_ADK/FRONTEND/lib/api/api.dart

/// Svrnty Console API Client Library
///
/// Type-safe CQRS API client for communicating with the backend.
///
/// This library provides:
/// - CQRS pattern support (queries, commands, paginated queries)
/// - Functional error handling with Result<T>
/// - Type-safe serialization via Serializable interface
/// - OpenAPI contract-driven development
///
/// ## Quick Start
///
/// ```dart
/// import 'package:console/api/api.dart';
///
/// // Create client
/// final client = CqrsApiClient(
///   config: ApiClientConfig.development,
/// );
///
/// // Execute query
/// final result = await client.checkHealth();
///
/// result.when(
///   success: (isHealthy) => print('API healthy: $isHealthy'),
///   error: (error) => print('Error: ${error.message}'),
/// );
///
/// // Clean up
/// client.dispose();
/// ```
///
/// ## CQRS Patterns
///
/// ### Queries (Read)
/// ```dart
/// final result = await client.executeQuery<UserDto>(
///   endpoint: 'users/123',
///   query: GetUserQuery(userId: '123'),
///   fromJson: UserDto.fromJson,
/// );
/// ```
///
/// ### Commands (Write)
/// ```dart
/// final result = await client.executeCommand(
///   endpoint: 'createUser',
///   command: CreateUserCommand(name: 'John', email: 'john@example.com'),
/// );
/// ```
///
/// ### Paginated Queries (Lists)
/// ```dart
/// final result = await client.executePaginatedQuery<UserDto>(
///   endpoint: 'users',
///   query: ListUsersQuery(),
///   itemFromJson: UserDto.fromJson,
///   page: 1,
///   pageSize: 20,
/// );
/// ```
///
/// See [README_API.md] for complete documentation.
library;

// Core exports
export 'client.dart' show CqrsApiClient, ApiClientConfig;
export 'types.dart'
    show
        // Result type
        Result,
        ApiSuccess,
        ApiError,
        // Error types
        ApiErrorInfo,
        ApiErrorType,
        // Pagination
        PaginatedResponse,
        PageInfo,
        FilterCriteria,
        FilterOperator,
        SortCriteria,
        SortDirection,
        // Serialization
        Serializable,
        // Queries (from schema)
        HealthQuery;

// Endpoint extensions
export 'endpoints/health_endpoint.dart' show HealthEndpoint, performHealthCheck;
export 'endpoints/agent_endpoint.dart'
    show
        AgentEndpoint,
        // Enums
        AgentType,
        AgentStatus,
        ModelProviderType,
        // Commands
        CreateAgentCommand,
        UpdateAgentCommand,
        DeleteAgentCommand,
        // Queries
        GetAgentQuery,
        // DTOs
        AgentDto;
export 'endpoints/conversation_endpoint.dart'
    show
        ConversationEndpoint,
        // Commands
        CreateConversationCommand,
        // Queries
        GetConversationQuery,
        // DTOs
        CreateConversationResult,
        ConversationDto,
        ConversationListItemDto,
        ConversationMessageDto;
export 'endpoints/execution_endpoint.dart'
    show
        ExecutionEndpoint,
        // Enums
        ExecutionStatus,
        // Commands
        StartAgentExecutionCommand,
        CompleteAgentExecutionCommand,
        // Queries
        GetAgentExecutionQuery,
        // DTOs
        StartExecutionResult,
        AgentExecutionDto,
        ExecutionListItemDto;