<?php

declare(strict_types=1);

namespace Plugin\tnt_mcp\src\Ai;

/**
 * What happened when the KI tab tried to spend a setup link's token.
 *
 * `Unknown` is not an error the merchant sees: a URL with a token this shop never issued is treated
 * as a plain visit to the tab, because the tab works perfectly well without one and a scary message
 * about an unrecognised token would be noise.
 */
enum AiSetupTokenStatus
{
    /** Valid, unspent, and now spent — show the "your assistant prepared this" note. */
    case Accepted;

    /** Issued by this shop, but spent already or past its TTL — say so and point at the assistant. */
    case Expired;

    /** No such token, or nothing was passed. Render the tab as if there had been no link. */
    case Unknown;
}
