apps/copilot/interfaces.py

"""Placeholder interfaces for future copilot services."""

from dataclasses import dataclass
from typing import Any


@dataclass
class ExecutionRequest:
    language: str
    code: str
    context: dict[str, Any]


@dataclass
class ExecutionResult:
    success: bool
    output: dict[str, Any]
    error: str | None = None


class ToolExecutionService:
    """Contract for secure SQL/Python tool execution."""

    def execute(self, request: ExecutionRequest) -> ExecutionResult:
        raise NotImplementedError("Tool execution service is not implemented yet.")


class HumanApprovalService:
    """Contract for human-in-the-loop review/approval workflows."""

    def request_approval(self, artifact_type: str, payload: dict[str, Any]) -> str:
        raise NotImplementedError("HITL approval service is not implemented yet.")


class AccessControlService:
    """Contract for role-based data access checks."""

    def can_access(self, user_id: str, resource: str, scope: str) -> bool:
        raise NotImplementedError("RBAC service is not implemented yet.")