from flask import request from flask_restx import Resource, fields from pydantic import BaseModel, Field, field_validator from controllers.common.schema import register_schema_models from controllers.console import console_ns from controllers.console.app.wraps import get_app_model from controllers.console.wraps import account_initialization_required, setup_required, with_current_user from extensions.ext_database import db from libs.helper import uuid_value from libs.login import login_required from models import Account from models.model import App, AppMode from services.agent.skill_package_service import SkillPackageError, SkillPackageService from services.agent.skill_standardize_service import SkillStandardizeService from services.agent_drive_service import AgentDriveError from services.agent_service import AgentService from services.file_service import FileService class AgentLogQuery(BaseModel): message_id: str = Field(..., description="Message UUID") conversation_id: str = Field(..., description="Conversation UUID") @field_validator("message_id", "conversation_id") @classmethod def validate_uuid(cls, value: str) -> str: return uuid_value(value) register_schema_models(console_ns, AgentLogQuery) @console_ns.route("/apps//agent/logs") class AgentLogApi(Resource): @console_ns.doc("get_agent_logs") @console_ns.doc(description="Get agent execution logs for an application") @console_ns.doc(params={"app_id": "Application ID"}) @console_ns.expect(console_ns.models[AgentLogQuery.__name__]) @console_ns.response( 200, "Agent logs retrieved successfully", fields.List(fields.Raw(description="Agent log entries")) ) @console_ns.response(400, "Invalid request parameters") @setup_required @login_required @account_initialization_required @get_app_model(mode=[AppMode.AGENT_CHAT]) def get(self, app_model: App): """Get agent logs""" args = AgentLogQuery.model_validate(request.args.to_dict(flat=True)) return AgentService.get_agent_logs(app_model, args.conversation_id, args.message_id) @console_ns.route("/apps//agent/skills/upload") class AgentSkillUploadApi(Resource): @console_ns.doc("upload_agent_skill") @console_ns.doc(description="Upload + validate a Skill package (.zip/.skill) and extract its manifest") @console_ns.doc(params={"app_id": "Application ID"}) @console_ns.response(201, "Skill validated") @console_ns.response(400, "Invalid skill package") @setup_required @login_required @account_initialization_required @get_app_model(mode=[AppMode.AGENT]) @with_current_user def post(self, current_user: Account, app_model: App): """Validate an uploaded Skill package and persist the archive. Returns a validated skill ref (to bind into the Agent soul config on save) plus its manifest. Standardizing into the agent drive is ENG-594. """ if "file" not in request.files: return {"code": "no_file", "message": "no skill file uploaded"}, 400 if len(request.files) > 1: return {"code": "too_many_files", "message": "only one skill file is allowed"}, 400 upload = request.files["file"] content = upload.stream.read() try: manifest = SkillPackageService().validate_and_extract(content=content, filename=upload.filename or "") except SkillPackageError as exc: return {"code": exc.code, "message": exc.message}, exc.status_code upload_file = FileService(db.engine).upload_file( filename=upload.filename or "skill.zip", content=content, mimetype=upload.mimetype or "application/zip", user=current_user, ) skill_ref = manifest.to_skill_ref(file_id=upload_file.id) return {"skill": skill_ref.model_dump(exclude_none=True), "manifest": manifest.model_dump()}, 201 @console_ns.route("/apps//agent/skills/standardize") class AgentSkillStandardizeApi(Resource): @console_ns.doc("standardize_agent_skill") @console_ns.doc(description="Validate + standardize a Skill into the agent drive (ENG-594)") @console_ns.doc(params={"app_id": "Application ID"}) @console_ns.response(201, "Skill standardized into drive") @console_ns.response(400, "Invalid skill package or no bound agent") @setup_required @login_required @account_initialization_required @get_app_model(mode=[AppMode.AGENT]) @with_current_user def post(self, current_user: Account, app_model: App): """Upload a Skill, validate it, and standardize it into the app agent's drive.""" agent_id = app_model.bound_agent_id if not agent_id: return {"code": "no_bound_agent", "message": "app has no bound agent"}, 400 if "file" not in request.files: return {"code": "no_file", "message": "no skill file uploaded"}, 400 if len(request.files) > 1: return {"code": "too_many_files", "message": "only one skill file is allowed"}, 400 upload = request.files["file"] content = upload.stream.read() try: result = SkillStandardizeService().standardize( content=content, filename=upload.filename or "", tenant_id=app_model.tenant_id, user_id=current_user.id, agent_id=agent_id, ) except (SkillPackageError, AgentDriveError) as exc: return {"code": exc.code, "message": exc.message}, exc.status_code return result, 201