51 lines
1.4 KiB
PHP
51 lines
1.4 KiB
PHP
<?php
|
|
|
|
declare (strict_types=1);
|
|
namespace WordPress\AiClient\Common\Exception;
|
|
|
|
/**
|
|
* Exception thrown when a token limit is reached during prompt fulfillment.
|
|
*
|
|
* Providers should throw this exception when the token usage for a request
|
|
* exceeds the allowed limit, whether that is the model's context window
|
|
* or a configured maximum.
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
class TokenLimitReachedException extends \WordPress\AiClient\Common\Exception\RuntimeException
|
|
{
|
|
/**
|
|
* The token limit that was reached, if known.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @var int|null
|
|
*/
|
|
private $maxTokens;
|
|
/**
|
|
* Creates a new TokenLimitReachedException.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param string $message The exception message.
|
|
* @param int|null $maxTokens The token limit that was reached, if known.
|
|
* @param \Throwable|null $previous The previous throwable used for exception chaining.
|
|
*/
|
|
public function __construct(string $message = '', ?int $maxTokens = null, ?\Throwable $previous = null)
|
|
{
|
|
parent::__construct($message, 0, $previous);
|
|
$this->maxTokens = $maxTokens;
|
|
}
|
|
/**
|
|
* Returns the token limit that was reached, if known.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @return int|null The token limit, or null if not provided.
|
|
*/
|
|
public function getMaxTokens(): ?int
|
|
{
|
|
return $this->maxTokens;
|
|
}
|
|
}
|