ResponseException

16class ResponseException extends RuntimeException17{18    /**19     * Creates a ResponseException for missing expected data.20     *21     * @since 0.2.022     *23     * @param string $apiName The name of the API/provider.24     * @param string $fieldName The field that was expected but missing.25     * @return self26     */27    public static function fromMissingData(string $apiName, string $fieldName): self28    {29        $message = sprintf('Unexpected %s API response: Missing the "%s" key.', $apiName, $fieldName);30        return new self($message);31    }32    /**33     * Creates a ResponseException from invalid data in an API response.34     *35     * @since 0.2.036     *37     * @param string $apiName The name of the API service (e.g., 'OpenAI', 'Anthropic').38     * @param string $fieldName The field that was invalid.39     * @param string $message The specific error message describing the invalid data.40     * @return self41     */42    public static function fromInvalidData(string $apiName, string $fieldName, string $message): self43    {44        return new self(sprintf('Unexpected %s API response: Invalid "%s" key: %s', $apiName, $fieldName, $message));45    }46}