using GB5Shared.DTO.Framework.Login;
using GB5Shared.ExternalAI;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

namespace EAIAdminBLL.Sync
{
    /// <summary>
    /// Calls one of gbEAI's live agent-execution routes (POST /&lt;slug&gt;) — as opposed to
    /// IEAISyncClient, which only pushes/pulls admin config. Built on the same shared
    /// IAIEngineSyncClient transport EAISyncClient uses, reusing EAIAdmin's existing
    /// "EAIAdmin:AIExtract" options (no third named-options section needed — see the approved
    /// plan's Phase 2 "Report-analysis side" note).
    /// </summary>
    public interface IEAIExecutionSyncClient
    {
        /// <summary>file is required for gbEAI agents with requires_file=True (e.g.
        /// document_identifier, parse_validate) and ignored otherwise.</summary>
        Task<AIEngineResponse> ExecuteAgentAsync(
            string agentSlug,
            IReadOnlyDictionary<string, string> formFields,
            LoginDTO login,
            (string FileName, byte[] Bytes)? file = null,
            CancellationToken ct = default);
    }
}