"""Admit annotation reply jobs before accessing their cache or publishing tasks.""" import logging from dataclasses import dataclass from typing import Literal, Protocol from uuid import uuid4 from services.annotation_query import AnnotationAppQuery logger = logging.getLogger(__name__) type AnnotationReplyAction = Literal["enable", "disable"] class AnnotationReplyJobNotFoundError(Exception): """The job is absent or does not belong to the requested tenant, app and action.""" @dataclass(frozen=True, slots=True) class AnnotationReplyJob: job_id: str job_status: str error_msg: str = "" class AnnotationReplyJobStore(Protocol): def reserve(self, *, tenant_id: str, app_id: str, action: AnnotationReplyAction, job_id: str) -> str: """Reserve this job or return the existing owned job ID without another publication.""" ... def fail(self, *, tenant_id: str, app_id: str, action: AnnotationReplyAction, job_id: str, error_msg: str) -> None: """Release the reservation while retaining a bounded, queryable error result.""" ... def get( self, *, tenant_id: str, app_id: str, action: AnnotationReplyAction, job_id: str ) -> AnnotationReplyJob | None: """Return an owned job's state; missing or unverifiable jobs return None.""" ... class EnableAnnotationReplyTask(Protocol): def __call__( self, *, job_id: str, app_id: str, user_id: str, tenant_id: str, score_threshold: float, embedding_provider_name: str, embedding_model_name: str, ) -> object: ... class DisableAnnotationReplyTask(Protocol): def __call__(self, *, job_id: str, app_id: str, tenant_id: str) -> object: ... class AnnotationReplyService: def __init__( self, *, apps: AnnotationAppQuery, jobs: AnnotationReplyJobStore, enable_task: EnableAnnotationReplyTask, disable_task: DisableAnnotationReplyTask, ) -> None: self._apps = apps self._jobs = jobs self._enable_task = enable_task self._disable_task = disable_task def enable( self, *, tenant_id: str, app_id: str, account_id: str, score_threshold: float, embedding_provider_name: str, embedding_model_name: str, ) -> AnnotationReplyJob: self._apps.require_app(tenant_id=tenant_id, app_id=app_id) job_id = str(uuid4()) try: pending = self._jobs.reserve(tenant_id=tenant_id, app_id=app_id, action="enable", job_id=job_id) if pending != job_id: return AnnotationReplyJob(job_id=pending, job_status="processing") self._enable_task( job_id=job_id, app_id=app_id, user_id=account_id, tenant_id=tenant_id, score_threshold=score_threshold, embedding_provider_name=embedding_provider_name, embedding_model_name=embedding_model_name, ) except Exception as exc: self._record_failed_job( tenant_id=tenant_id, app_id=app_id, action="enable", job_id=job_id, error_msg=str(exc) ) raise return AnnotationReplyJob(job_id=job_id, job_status="waiting") def disable(self, *, tenant_id: str, app_id: str) -> AnnotationReplyJob: self._apps.require_app(tenant_id=tenant_id, app_id=app_id) job_id = str(uuid4()) try: pending = self._jobs.reserve(tenant_id=tenant_id, app_id=app_id, action="disable", job_id=job_id) if pending != job_id: return AnnotationReplyJob(job_id=pending, job_status="processing") self._disable_task(job_id=job_id, app_id=app_id, tenant_id=tenant_id) except Exception as exc: self._record_failed_job( tenant_id=tenant_id, app_id=app_id, action="disable", job_id=job_id, error_msg=str(exc) ) raise return AnnotationReplyJob(job_id=job_id, job_status="waiting") def _record_failed_job( self, *, tenant_id: str, app_id: str, action: AnnotationReplyAction, job_id: str, error_msg: str ) -> None: try: # Even a failed reservation call may have exposed this ID before Redis disconnected. self._jobs.fail(tenant_id=tenant_id, app_id=app_id, action=action, job_id=job_id, error_msg=error_msg) except Exception: logger.exception( "Failed to record annotation reply job failure %s for app %s in workspace %s", job_id, app_id, tenant_id ) def get_status( self, *, tenant_id: str, app_id: str, action: AnnotationReplyAction, job_id: str ) -> AnnotationReplyJob: self._apps.require_app(tenant_id=tenant_id, app_id=app_id) job = self._jobs.get(tenant_id=tenant_id, app_id=app_id, action=action, job_id=job_id) if job is None: raise AnnotationReplyJobNotFoundError(f"Annotation reply job {job_id} is unavailable for app {app_id}") return job