AiClient

82class AiClient83{84    /**85     * @var string The version of the AI Client.86     */87    public const VERSION = '1.3.1';88    /**89     * @var ProviderRegistry|null The default provider registry instance.90     */91    private static ?ProviderRegistry $defaultRegistry = null;92    /**93     * @var EventDispatcherInterface|null The event dispatcher for prompt lifecycle events.94     */95    private static ?EventDispatcherInterface $eventDispatcher = null;96    /**97     * @var CacheInterface|null The PSR-16 cache for storing and retrieving cached data.98     */99    private static ?CacheInterface $cache = null;100    /**101     * Gets the default provider registry instance.102     *103     * @since 0.1.0104     *105     * @return ProviderRegistry The default provider registry.106     */107    public static function defaultRegistry(): ProviderRegistry108    {109        if (self::$defaultRegistry === null) {110            self::$defaultRegistry = new ProviderRegistry();111        }112        return self::$defaultRegistry;113    }114    /**115     * Sets the event dispatcher for prompt lifecycle events.116     *117     * The event dispatcher will be used to dispatch BeforeGenerateResultEvent and118     * AfterGenerateResultEvent during prompt generation.119     *120     * @since 0.4.0121     *122     * @param EventDispatcherInterface|null $dispatcher The event dispatcher, or null to disable.123     * @return void124     */125    public static function setEventDispatcher(?EventDispatcherInterface $dispatcher): void126    {127        self::$eventDispatcher = $dispatcher;128    }129    /**130     * Gets the event dispatcher for prompt lifecycle events.131     *132     * @since 0.4.0133     *134     * @return EventDispatcherInterface|null The event dispatcher, or null if not set.135     */136    public static function getEventDispatcher(): ?EventDispatcherInterface137    {138        return self::$eventDispatcher;139    }140    /**141     * Sets the PSR-16 cache for storing and retrieving cached data.142     *143     * The cache can be used to store AI responses and other data to avoid144     * redundant API calls and improve performance.145     *146     * @since 0.4.0147     *148     * @param CacheInterface|null $cache The PSR-16 cache instance, or null to disable caching.149     * @return void150     */151    public static function setCache(?CacheInterface $cache): void152    {153        self::$cache = $cache;154    }155    /**156     * Gets the PSR-16 cache instance.157     *158     * @since 0.4.0159     *160     * @return CacheInterface|null The cache instance, or null if not set.161     */