package cn.nianxx.thhotel.integrations.ai.superagent.service;

import cn.nianxx.thhotel.platform.message.common.request.CaptureSourceMessageCommand;
import cn.nianxx.thhotel.platform.message.common.result.SourceMessageCaptureResult;

/**
 * SuperAgent 自动分发服务。负责把已入库的 SourceMessage 异步交给 SuperAgent Open API。
 */
public interface SuperAgentDispatchService {

    /**
     * AgentBus 实时入口捕获 SourceMessage 后，按幂等规则创建 SuperAgent dispatch 记录。
     *
     * @param command SourceMessage 捕获命令
     * @param captureResult SourceMessage 捕获结果
     */
    void enqueueAgentBusRealtime(CaptureSourceMessageCommand command, SourceMessageCaptureResult captureResult);

    /**
     * 处理一批到期 dispatch 记录，供定时 worker 调用。
     *
     * @return 本轮处理的 dispatch 数量
     */
    int processDueDispatches();
}
