Function update_must_read

deployments/desktop/shared/agents.py:1816–1852

(user_id: str, item_type: str, value: str, action: str)

def list_must_read(user_id: str) -> Dict[str, Any]:
    profile = db_ops.get_profile(user_id) or {}
    must_read = profile.get("must_read") or {"authors": [], "institutions": [], "keywords": []}
    return {
        "must_read": {
            "authors": list(must_read.get("authors") or []),
            "institutions": list(must_read.get("institutions") or []),
            "keywords": list(must_read.get("keywords") or []),
        }
    }


def update_must_read(user_id: str, item_type: str, value: str, action: str) -> Dict[str, Any]:
    normalized_type = (item_type or "").strip().lower()
    normalized_action = (action or "").strip().lower()
    if normalized_type not in {"author", "institution", "keyword"}:
        raise ValueError("item_type must be author, institution, or keyword")
    if normalized_action not in {"add", "remove"}:
        raise ValueError("action must be add or remove")
    cleaned_value = str(value or "").strip()
    if not cleaned_value:
        raise ValueError("value is required")

    profile = db_ops.get_profile(user_id)
    if not profile:
        raise ValueError(f"Profile not found: {user_id}")

    if normalized_action == "add":
        result = must_read_agent.add_must_read(profile, normalized_type, cleaned_value)
    else:
        result = must_read_agent.remove_must_read(profile, normalized_type, cleaned_value)

    if result.get("success"):
        db_ops.update_profile(user_id, profile)
        db_ops.log_behavior(
            user_id=user_id,
            push_id="desktop_gui",
            paper_id=None,
            action=f"{normalized_action}_{normalized_type}",
            action_type="must_read_update",
            category="desktop_gui",
            metadata={"value": cleaned_value, "item_type": normalized_type},