Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.
Python agentagentic-aiagentic-frameworkagentic-workflowaiautomationclaudedeepseekgenaigptllmlow-codemcpnextjsno-codeopenaipythonskillsworkflow
"""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