<?php
/**
 * Chat Card Contract
 *
 * @package Aisentic\Contracts
 */

namespace Aisentic\Contracts;

defined( 'ABSPATH' ) || exit;

/**
 * Interface for tools that show a card in the chat.
 *
 * The tool returns a short result to the model and keeps the card's full data
 * (images, every slot) for the screen. Chat_Controller takes the card after the
 * tool runs and sends it as one generic `card` SSE event.
 */
interface Chat_Card_Contract {

	/**
	 * The card produced by the last run, then cleared.
	 *
	 * @return array|null [ 'card' => string, 'data' => array ], or null when there is none.
	 */
	public function take_card(): ?array;
}