<?php
/**
 * Module: Definitions.
 *
 * @package MazeAi
 * @since   0.1.0
 */

declare(strict_types=1);

namespace MazeAi\Modules\Definitions;

defined('ABSPATH') || exit;

use Illuminate\MazeAssistant\Contracts\Container\Container;
use MazeAi\Kernel\Contracts\Module;
use MazeAi\Kernel\Contracts\Registrar;
use MazeAi\Platform\ProvidesAbilities;
use MazeAi\Tools\Abilities\DefinitionAbilities;

/**
 * JSON definitions as tools (decision 044). Required so the definition abilities stay available; in chat the write
 * tools stay off until an administrator switches them on.
 *
 * @since 0.1.0
 */
final class DefinitionsModule implements Module, ProvidesAbilities
{
    /**
     * The packs are made when abilities are registered, not when the module loads: a pack may need engines (the
     * agent registry) that are built from what the modules register.
     */
    public function __construct(protected Container $app)
    {
    }

    public function id(): string
    {
        return 'definitions';
    }

    public function describe(): array
    {
        return [
            'name'        => __('Definitions', 'maze-graph'),
            'description' => __('Tools that read and write the site\'s JSON definitions (agents, templates, starters, policy rules), with approval and undo.', 'maze-graph'),
            'requires'    => ['tools' => 2, 'registrar' => 1],
            'optional'    => false,
        ];
    }

    public function register(Registrar $maze): void
    {
    }

    public function abilities(): void
    {
        $this->app->make(DefinitionAbilities::class)->register();
    }
}