<?php

namespace Espo\Modules\SmartAssistant\Services;

use Espo\ORM\EntityManager;
use Espo\Core\Utils\Log;

/**
 * Lists active skills (metadata only — name/description/triggers) for the
 * system prompt's "=== SKILLS (learned workflows) ===" hint. The full body
 * is fetched on demand by shira-hermes' read_skill tool via REST.
 */
class AssistantSkillContextProvider
{
    private EntityManager $entityManager;
    private Log $log;

    public function __construct(EntityManager $entityManager, Log $log)
    {
        $this->entityManager = $entityManager;
        $this->log = $log;
    }

    /**
     * @return array<int, array{name: string, description: string, triggers: string}>
     */
    public function listSkills(): array
    {
        $entries = $this->entityManager->getRDBRepository('AssistantSkill')
            ->where(['isActive' => true, 'deleted' => false])
            ->order('name', 'ASC')
            ->find();

        $skills = [];
        foreach ($entries as $entry) {
            $skills[] = [
                'name' => (string) $entry->get('name'),
                'description' => (string) ($entry->get('description') ?? ''),
                'triggers' => (string) ($entry->get('triggers') ?? ''),
            ];
        }

        return $skills;
    }
}