[Feature] create a set of tools for task app

[ArtemBaranenko]

Issue Type

• Bug report
• Feature request
• Documentation update
• Other (please specify)

Description

Implemented a preprocessing tool that analyzes user input, extracts structured task data, and prepares a clean prompt before sending requests to the LLM through MCP.

Expected behaviour

The tool receives raw user input, identifies the task intent, extracts relevant data, applies validation rules, and returns a structured prompt ready to be sent to the LLM through MCP.

[Robbo-lab]

Can you add this module to the utils folder and impliment it in the task manager, create roles and scopes for control which tools any LLM can use. Initial the LLM should not be able to add, create or delete tasks.

from fastapi import HTTPException
from utils.get_principal import Principal

REQUIRED_ROLES = {"utility.read", "conversion.run"} 
REQUIRED_SCOPES = {"miles:convert"}

def enforce_permissions(p: Principal):
    """Check if the principal has required roles and scopes, raising 403 if not.
    Parameters: 
        p is the Principal object containing user_id, roles, and scopes.
    Raises: 
        HTTPException with status 403 if required roles or scopes are missing, detailing which"""
    missing_roles  = REQUIRED_ROLES  - p.roles
    missing_scopes = REQUIRED_SCOPES - p.scopes
    if missing_roles or missing_scopes:
        raise HTTPException(
            status_code=403,
            detail={
                "error": "forbidden",
                "missing_roles":  sorted(missing_roles),
                "missing_scopes": sorted(missing_scopes),
            },
        )