AgentRegistryAndStateExample.php

<?php

declare(strict_types=1);

namespace imperazim\easylibrary\examples\agent;

use imperazim\agent\api\AgentRegistryAPI;
use imperazim\agent\api\AgentRuntimeAPI;
use imperazim\agent\api\AgentServerStateAPI;

final class AgentRegistryAndStateExample{
    /** @return list<string> */
    public function onlineServerIds() : array{
        if(!AgentRuntimeAPI::isAvailable()){
            return [];
        }

        $registry = AgentRegistryAPI::registry(50, false);
        $ids = [];
        foreach(($registry['servers'] ?? []) as $server){
            if(is_array($server) && ($server['state'] ?? '') === 'online'){
                $ids[] = (string) ($server['id'] ?? '');
            }
        }

        return array_values(array_filter($ids, static fn(string $id) : bool => $id !== ''));
    }

    public function enableMaintenance(string $serverId, string $reason) : bool{
        if(!AgentRuntimeAPI::isAvailable()){
            return false;
        }

        $response = AgentServerStateAPI::maintenance($serverId, true, $reason);
        return ($response['ok'] ?? false) === true;
    }
}