"""
Manus Files API implementation.

Manus has an OpenAI-compatible Files API with some differences:
- Uses API_KEY header instead of Authorization: Bearer
- File upload is a two-step process:
  1. Create file record to get upload URL
  2. Upload file content to the upload URL

Reference: https://open.manus.im/docs/openai-compatibility#file-management
"""

import time
from typing import Any, Final

import httpx
from openai.types.file_deleted import FileDeleted

import litellm
from litellm._logging import verbose_logger
from litellm.litellm_core_utils.prompt_templates.common_utils import extract_file_data
from litellm.litellm_core_utils.url_utils import encode_url_path_segment
from litellm.llms.base_llm.chat.transformation import BaseLLMException
from litellm.llms.base_llm.files.transformation import (
    BaseFilesConfig,
    LiteLLMLoggingObj,
)
from litellm.llms.openai.common_utils import OpenAIError
from litellm.secret_managers.main import get_secret_str
from litellm.types.files import TwoStepFileUploadConfig, TwoStepFileUploadRequest
from litellm.types.llms.openai import (
    CreateFileRequest,
    FileContentRequest,
    HttpxBinaryResponseContent,
    OpenAICreateFileRequestOptionalParams,
    OpenAIFileObject,
)
from litellm.types.utils import LlmProviders

MANUS_API_BASE: Final = "https://api.manus.im"


class ManusFilesConfig(BaseFilesConfig):
    """
    Configuration for Manus Files API.

    Manus uses:
    - API_KEY header for authentication (not Authorization: Bearer)
    - Two-step file upload process
    - Content-Type: application/json for all requests

    Reference: https://open.manus.im/docs/openai-compatibility#file-management
    """

    def __init__(self):
        pass

    @property
    def custom_llm_provider(self) -> LlmProviders:
        return LlmProviders.MANUS

    def validate_environment(
        self,
        headers: dict,
        model: str,
        messages: list,
        optional_params: dict,
        litellm_params: dict,
        api_key: str | None = None,
        api_base: str | None = None,
    ) -> dict:
        """
        Validate environment and set up headers for Manus API.

        Manus uses API_KEY header instead of Authorization: Bearer.
        For file uploads, don't set Content-Type - httpx will set it for multipart.
        """
        api_key = api_key or litellm.api_key or get_secret_str("MANUS_API_KEY")

        if not api_key:
            raise ValueError(
                "Manus API key is required. Set MANUS_API_KEY environment variable or pass api_key parameter."
            )

        # Manus uses API_KEY header, not Authorization: Bearer
        # Manus requires Content-Type: application/json for all requests (even GET)
        headers.update(
            {
                "API_KEY": api_key,
                "Content-Type": "application/json",
            }
        )
        return headers

    def get_supported_openai_params(self, model: str) -> list[OpenAICreateFileRequestOptionalParams]:
        """
        Return supported OpenAI file creation parameters for Manus.
        Manus supports the standard 'purpose' parameter.
        """
        return ["purpose"]

    def map_openai_params(
        self,
        non_default_params: dict,
        optional_params: dict,
        model: str,
        drop_params: bool,
    ) -> dict:
        """
        Map OpenAI parameters to Manus-specific parameters.
        Manus is OpenAI-compatible, so no special mapping needed.
        """
        return optional_params

    def get_complete_url(
        self,
        api_base: str | None,
        api_key: str | None,
        model: str,
        optional_params: dict,
        litellm_params: dict,
        stream: bool | None = None,
    ) -> str:
        """
        Get the complete URL for Manus Files API endpoint.

        Returns:
            str: The full URL for the Manus /v1/files endpoint
        """
        api_base = api_base or litellm.api_base or get_secret_str("MANUS_API_BASE") or MANUS_API_BASE

        # Remove trailing slashes
        api_base = api_base.rstrip("/")

        # Manus API uses /v1/files endpoint
        if api_base.endswith("/v1"):
            return f"{api_base}/files"
        return f"{api_base}/v1/files"

    def get_error_class(
        self,
        error_message: str,
        status_code: int,
        headers: dict | httpx.Headers,
    ) -> BaseLLMException:
        """
        Return the appropriate error class for Manus API errors.
        Uses OpenAIError since Manus is OpenAI-compatible.
        """
        return OpenAIError(
            status_code=status_code,
            message=error_message,
            headers=headers,
        )

    def transform_create_file_request(
        self,
        model: str,
        create_file_data: CreateFileRequest,
        optional_params: dict,
        litellm_params: dict,
    ) -> TwoStepFileUploadConfig:
        """
        Transform OpenAI-style file creation request into Manus's two-step format.

        Manus API spec (https://open.manus.im/docs/openai-compatibility#file-management):
        1. POST /v1/files with JSON {"filename": "..."} → returns {"id": "...", "upload_url": "..."}
        2. PUT to upload_url with raw file content
        """
        # Extract file data
        file_data: Final = create_file_data.get("file")
        if file_data is None:
            raise ValueError("File data is required")

        extracted_data: Final = extract_file_data(file_data)
        filename: Final = extracted_data["filename"] or f"file_{int(time.time())}"
        content: Final = extracted_data["content"]

        # Get API base URL
        api_base: Final = self.get_complete_url(
            api_base=litellm_params.get("api_base"),
            api_key=litellm_params.get("api_key"),
            model=model,
            optional_params=optional_params,
            litellm_params=litellm_params,
        )

        # Get API key
        api_key: Final = litellm_params.get("api_key") or litellm.api_key or get_secret_str("MANUS_API_KEY")

        if not api_key:
            raise ValueError(
                "Manus API key is required. Set MANUS_API_KEY environment variable or pass api_key parameter."
            )

        # Build typed two-step upload config
        return TwoStepFileUploadConfig(
            initial_request=TwoStepFileUploadRequest(
                method="POST",
                url=api_base,
                headers={
                    "API_KEY": api_key,
                    "Content-Type": "application/json",
                },
                data={"filename": filename},
            ),
            upload_request=TwoStepFileUploadRequest(
                method="PUT",
                url="",  # Will be populated from initial_request response
                headers={},
                data=content,
            ),
            upload_url_location="body",
            upload_url_key="upload_url",
        )

    def transform_create_file_response(
        self,
        model: str | None,
        raw_response: httpx.Response,
        logging_obj: LiteLLMLoggingObj,
        litellm_params: dict,
    ) -> OpenAIFileObject:
        """
        Transform Manus's file upload response into OpenAI-style FileObject.

        For two-step uploads, the handler stores the initial response in litellm_params.
        We need to return the file object from the initial POST, not the final PUT.

        Manus initial response format:
        {
            "id": "file-abc123xyz",
            "object": "file",
            "filename": "document.pdf",
            "status": "pending",
            "upload_url": "https://...",
            "upload_expires_at": "...",
            "created_at": "..."
        }
        """
        try:
            # For two-step uploads, get the initial response from litellm_params
            initial_response_data: Final = litellm_params.get("initial_file_response")
            if initial_response_data:
                response_json = initial_response_data
            else:
                # Log raw response for debugging
                verbose_logger.debug("Manus raw response text: %s", raw_response.text)
                response_json = raw_response.json()

            verbose_logger.debug("Manus file response: %s", response_json)

            # Parse created_at timestamp
            created_at_str: Final = response_json.get("created_at", "")
            if created_at_str:
                try:
                    # Try parsing ISO format
                    created_at = int(
                        time.mktime(
                            time.strptime(
                                created_at_str.replace("Z", "+00:00")[:19],
                                "%Y-%m-%dT%H:%M:%S",
                            )
                        )
                    )
                except (ValueError, TypeError):
                    created_at = int(time.time())
            else:
                created_at = int(time.time())

            return OpenAIFileObject(
                id=response_json.get("id", ""),
                bytes=response_json.get("bytes", 0),
                created_at=created_at,
                filename=response_json.get("filename", ""),
                object="file",
                purpose=response_json.get("purpose", "assistants"),
                status="uploaded",  # After successful upload, status is uploaded
                status_details=response_json.get("status_details"),
            )
        except Exception as e:
            verbose_logger.exception("Error parsing Manus file response: %s", e)
            raise ValueError(f"Error parsing Manus file response: {e}")

    def transform_retrieve_file_request(
        self,
        file_id: str,
        optional_params: dict,
        litellm_params: dict,
    ) -> tuple[str, dict]:
        """Get URL and params for retrieving a file."""
        api_base: Final = self.get_complete_url(
            api_base=litellm_params.get("api_base"),
            api_key=litellm_params.get("api_key"),
            model="",
            optional_params=optional_params,
            litellm_params=litellm_params,
        )
        encoded_file_id: Final = encode_url_path_segment(file_id, field_name="file_id")
        return f"{api_base}/{encoded_file_id}", {}

    def transform_retrieve_file_response(
        self,
        raw_response: httpx.Response,
        logging_obj: LiteLLMLoggingObj,
        litellm_params: dict,
    ) -> OpenAIFileObject:
        """Transform retrieve file response."""
        return self.transform_create_file_response(
            model=None,
            raw_response=raw_response,
            logging_obj=logging_obj,
            litellm_params=litellm_params,
        )

    def transform_delete_file_request(
        self,
        file_id: str,
        optional_params: dict,
        litellm_params: dict,
    ) -> tuple[str, dict]:
        """Get URL and params for deleting a file."""
        api_base: Final = self.get_complete_url(
            api_base=litellm_params.get("api_base"),
            api_key=litellm_params.get("api_key"),
            model="",
            optional_params=optional_params,
            litellm_params=litellm_params,
        )
        encoded_file_id: Final = encode_url_path_segment(file_id, field_name="file_id")
        return f"{api_base}/{encoded_file_id}", {}

    def transform_delete_file_response(
        self,
        raw_response: httpx.Response,
        logging_obj: LiteLLMLoggingObj,
        litellm_params: dict,
    ) -> FileDeleted:
        """Transform delete file response."""
        response_json: Final = raw_response.json()
        return FileDeleted(**response_json)

    def transform_list_files_request(
        self,
        purpose: str | None,
        optional_params: dict,
        litellm_params: dict,
    ) -> tuple[str, dict]:
        """Get URL and params for listing files."""
        api_base: Final = self.get_complete_url(
            api_base=litellm_params.get("api_base"),
            api_key=litellm_params.get("api_key"),
            model="",
            optional_params=optional_params,
            litellm_params=litellm_params,
        )
        params: Final = {}
        if purpose:
            params["purpose"] = purpose
        return api_base, params

    def transform_list_files_response(
        self,
        raw_response: httpx.Response,
        logging_obj: LiteLLMLoggingObj,
        litellm_params: dict,
    ) -> list[OpenAIFileObject]:
        """Transform list files response."""
        response_json: Final = raw_response.json()
        files_data: Final = response_json.get("data", [])
        return [self._parse_file_dict(f) for f in files_data]

    def _parse_file_dict(self, file_dict: dict[str, Any]) -> OpenAIFileObject:
        """Parse a file dict into OpenAIFileObject."""
        created_at_str: Final = file_dict.get("created_at", "")
        if created_at_str:
            try:
                created_at = int(
                    time.mktime(
                        time.strptime(
                            created_at_str.replace("Z", "+00:00")[:19],
                            "%Y-%m-%dT%H:%M:%S",
                        )
                    )
                )
            except (ValueError, TypeError):
                created_at = int(time.time())
        else:
            created_at = int(time.time())

        return OpenAIFileObject(
            id=file_dict.get("id", ""),
            bytes=file_dict.get("bytes", 0),
            created_at=created_at,
            filename=file_dict.get("filename", ""),
            object="file",
            purpose=file_dict.get("purpose", "assistants"),
            status=file_dict.get("status", "uploaded"),
            status_details=file_dict.get("status_details"),
        )

    def transform_file_content_request(
        self,
        file_content_request: FileContentRequest,
        optional_params: dict,
        litellm_params: dict,
    ) -> tuple[str, dict]:
        """Get URL and params for retrieving file content."""
        file_id: Final = file_content_request.get("file_id")
        api_base: Final = self.get_complete_url(
            api_base=litellm_params.get("api_base"),
            api_key=litellm_params.get("api_key"),
            model="",
            optional_params=optional_params,
            litellm_params=litellm_params,
        )
        encoded_file_id: Final = encode_url_path_segment(file_id, field_name="file_id")
        return f"{api_base}/{encoded_file_id}/content", {}

    def transform_file_content_response(
        self,
        raw_response: httpx.Response,
        logging_obj: LiteLLMLoggingObj,
        litellm_params: dict,
    ) -> HttpxBinaryResponseContent:
        """Transform file content response."""
        return HttpxBinaryResponseContent(response=raw_response)
