TokenUsage

27class TokenUsage extends AbstractDataTransferObject28{29    public const KEY_PROMPT_TOKENS = 'promptTokens';30    public const KEY_COMPLETION_TOKENS = 'completionTokens';31    public const KEY_TOTAL_TOKENS = 'totalTokens';32    public const KEY_THOUGHT_TOKENS = 'thoughtTokens';33    /**34     * @var int Number of tokens in the prompt.35     */36    private int $promptTokens;37    /**38     * @var int Number of tokens in the completion, including any thought tokens.39     */40    private int $completionTokens;41    /**42     * @var int Total number of tokens used.43     */44    private int $totalTokens;45    /**46     * @var int|null Number of tokens used for thinking, as a subset of completion tokens.47     */48    private ?int $thoughtTokens;49    /**50     * Constructor.51     *52     * @since 0.1.053     *54     * @param int $promptTokens Number of tokens in the prompt.55     * @param int $completionTokens Number of tokens in the completion, including any thought tokens.56     * @param int $totalTokens Total number of tokens used.57     * @param int|null $thoughtTokens Number of tokens used for thinking, as a subset of completion tokens.58     */59    public function __construct(int $promptTokens, int $completionTokens, int $totalTokens, ?int $thoughtTokens = null)60    {61        $this->promptTokens = $promptTokens;62        $this->completionTokens = $completionTokens;63        $this->totalTokens = $totalTokens;64        $this->thoughtTokens = $thoughtTokens;65    }66    /**67     * Gets the number of prompt tokens.68     *69     * @since 0.1.070     *71     * @return int The prompt token count.72     */73    public function getPromptTokens(): int74    {75        return $this->promptTokens;76    }77    /**78     * Gets the number of completion tokens, including any thought tokens.79     *80     * @since 0.1.081     *82     * @return int The completion token count.83     */84    public function getCompletionTokens(): int85    {86        return $this->completionTokens;87    }88    /**89     * Gets the total number of tokens.90     *91     * @since 0.1.092     *93     * @return int The total token count.94     */95    public function getTotalTokens(): int96    {97        return $this->totalTokens;98    }99    /**100     * Gets the number of thought tokens, which is a subset of the completion token count.101     *102     * @since 1.3.0103     *104     * @return int|null The thought token count or null if not available.105     */106    public function getThoughtTokens(): ?int