Skip to content

OpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.

Python
3.6 KB
Raw Blame
"""Ephemeral ingest preview endpoints for preview-mode ingest."""

from typing import Annotated, Any

from fastapi import Depends
from fastapi.responses import JSONResponse

from dependencies import (
    get_ingest_preview_service,
    get_session_manager,
    get_task_service,
    require_permission,
)
from session_manager import User
from utils.ingest_preview_flag import is_ingest_preview_enabled


def _preview_unavailable_response() -> JSONResponse:
    return JSONResponse(
        {"error": "Ingest preview is not available in this run mode"},
        status_code=404,
    )


def _require_preview_task(task_service: Any, user: User, task_id: str):
    """Return (upload_task, error_response). Exactly one of the tuple values is None."""
    if not is_ingest_preview_enabled():
        return None, _preview_unavailable_response()

    upload_task = task_service.get_upload_task(user.user_id, task_id)
    if upload_task is None:
        return None, JSONResponse({"error": "Task not found"}, status_code=404)
    if not upload_task.preview_mode:
        return None, JSONResponse({"error": "Task is not a preview ingest"}, status_code=404)
    return upload_task, None


async def get_parse_preview(
    task_id: str,
    preview_service: Annotated[Any, Depends(get_ingest_preview_service)],
    task_service: Annotated[Any, Depends(get_task_service)],
    user: Annotated[User, Depends(require_permission("knowledge:upload"))],
    file: str | None = None,
):
    """Return cached Docling JSON for a preview-mode ingest task.

    ``file`` selects a specific file within a multi-file preview task (the
    file_path key from the task status). Omitted = first available file.
    """
    _, error = _require_preview_task(task_service, user, task_id)
    if error is not None:
        return error

    preview = preview_service.get_docling_preview(user.user_id, task_id, file_path=file)
    if preview is None:
        return JSONResponse({"error": "Parse preview not available yet"}, status_code=404)

    return JSONResponse(
        {
            "task_id": task_id,
            "document": preview["document"],
            "stats": preview["stats"],
            "expires_at": preview["expires_at"],
            "document_id": preview.get("document_id"),
            "file_path": preview.get("file_path"),
            "filename": preview.get("filename"),
        }
    )


async def get_index_proof(
    task_id: str,
    preview_service: Annotated[Any, Depends(get_ingest_preview_service)],
    task_service: Annotated[Any, Depends(get_task_service)],
    session_manager: Annotated[Any, Depends(get_session_manager)],
    user: Annotated[User, Depends(require_permission("knowledge:upload"))],
    file: str | None = None,
):
    """Return indexed chunk metadata proving embeddings landed in OpenSearch.

    ``file`` selects a specific file within a multi-file preview task.
    """
    upload_task, error = _require_preview_task(task_service, user, task_id)
    if error is not None:
        return error

    opensearch_client = session_manager.get_user_opensearch_client(user.user_id, user.jwt_token)
    proof = await preview_service.get_index_proof(
        upload_task=upload_task,
        task_id=task_id,
        opensearch_client=opensearch_client,
        file_path=file,
    )

    if proof.get("error") == "not_preview_task":
        return JSONResponse({"error": "Task is not a preview ingest"}, status_code=404)
    if proof.get("error") == "file_not_found":
        return JSONResponse({"error": "File not found in preview task"}, status_code=404)

    return JSONResponse({"task_id": task_id, **proof})