<?php
/**
 * Article AI suggestion provider contract.
 *
 * @package Affilun\Application\Ai
 */

declare(strict_types=1);

namespace Affilun\Application\Ai;

/**
 * Provides AI suggestions for article-context product link workflows.
 */
interface ArticleSuggestionProvider {

	/**
	 * Suggest product-link keywords and copy from article context.
	 *
	 * @param string $title   Article title.
	 * @param string $content Article content/excerpt.
	 *
	 * @throws AiSuggestionException When suggestion fails.
	 */
	public function suggest( string $title, string $content ): ArticleSuggestionResult;
}
