"""HTTP adapter, shared by the clean gateway and the original gateway integration.""" from typing import Annotated from fastapi import APIRouter, Depends, Header, Query from pydantic import Field from src.modules.skill.atomic_registry.catalog import check_handler from src.modules.skill.domain.models import Contract, Draft, Framework, Identifier, Operation, SkillError, Version from src.modules.orchestrator.api import StartRun class SaveDraft(Contract): draft: Draft expected_revision: int = Field(ge=1) class Review(Contract): expected_revision: int = Field(ge=1) expected_digest: str = Field(pattern=r"^[a-f0-9]{64}$") evidence_refs: list[str] = Field(min_length=1, max_length=20) class Publish(Contract): version: Version expected_revision: int = Field(ge=1) approval_id: str = Field(pattern=r"^approval-[a-f0-9]{32}$") class Retirement(Contract): reason: str = Field(min_length=5, max_length=500) class Prepare(Contract): release_ref: str = Field(min_length=1, max_length=110) project_id: Identifier source_digest: str = Field(pattern=r"^[a-f0-9]{64}$") def build_router(service, principal, runtime=None): router = APIRouter(prefix="/api/v1", tags=["ZKCoding Skill"]) @router.get("/admin/atomic-operations") def operations(actor=Depends(principal)): service.require(actor, {"admin", "skill_manager", "reviewer"}) return {"items": service.catalog(actor, "operation"), "execution": "handler_contracts_only"} @router.post("/admin/atomic-operations", status_code=201) def create_operation(data: Operation, actor=Depends(principal)): return service.add_operation(actor, data) @router.get("/admin/atomic-operations/{operation_id}/versions") def operation_versions(operation_id: str, actor=Depends(principal)): service.require(actor, {"admin", "skill_manager", "reviewer"}) return {"items": [item for item in service.catalog(actor, "operation") if item["body"]["operation_id"] == operation_id]} @router.post("/admin/atomic-operations/{operation_id}/validate") def validate_operation(operation_id: str, data: Operation, actor=Depends(principal)): service.require(actor, {"admin", "skill_manager"}) if data.operation_id != operation_id: raise SkillError("ID_MISMATCH", "路由与操作ID不一致。") check_handler(data) return {"valid": True, "execution": "not_started"} @router.post("/admin/atomic-operations/{reference}/retire") def retire_operation(reference: str, data: Retirement, actor=Depends(principal)): return service.retire(actor, "operation", reference, data.reason) @router.get("/admin/framework-profiles") def frameworks(actor=Depends(principal)): service.require(actor, {"admin", "skill_manager", "reviewer"}) return {"items": service.catalog(actor, "framework")} @router.post("/admin/framework-profiles", status_code=201) def create_framework(data: Framework, actor=Depends(principal)): return service.add_framework(actor, data) @router.post("/admin/framework-profiles/{reference}/retire") def retire_framework(reference: str, data: Retirement, actor=Depends(principal)): return service.retire(actor, "framework", reference, data.reason) @router.get("/admin/skills") def drafts(actor=Depends(principal)): return {"items": service.drafts(actor)} @router.post("/admin/skills", status_code=201) def create(data: Draft, actor=Depends(principal)): return service.save_draft(actor, data) @router.get("/admin/skills/{skill_id}/draft") def read(skill_id: str, actor=Depends(principal)): return service.read_draft(actor, skill_id) @router.put("/admin/skills/{skill_id}/draft") def save(skill_id: str, data: SaveDraft, actor=Depends(principal)): if data.draft.skill_id != skill_id: raise SkillError("ID_MISMATCH", "路由与Skill ID不一致。") return service.save_draft(actor, data.draft, data.expected_revision) @router.post("/admin/skills/{skill_id}/validate") def validate(skill_id: str, actor=Depends(principal)): return service.validate(actor, skill_id) @router.post("/admin/skills/{skill_id}/approvals", status_code=201) def approve(skill_id: str, data: Review, actor=Depends(principal)): return service.approve(actor, skill_id, data.expected_revision, data.expected_digest, data.evidence_refs) @router.post("/admin/skills/{skill_id}/releases", status_code=201) def publish(skill_id: str, data: Publish, actor=Depends(principal)): return service.publish(actor, skill_id, data.version, data.expected_revision, data.approval_id) @router.post("/admin/skills/{skill_id}/releases/{version}/retire") def retire_release(skill_id: str, version: str, data: Retirement, actor=Depends(principal)): return service.retire(actor, "release", skill_id + "@" + version, data.reason) @router.post("/admin/skills/{skill_id}/trials") def trials(skill_id: str, data: StartRun, actor=Depends(principal), key: str = Header(alias='Idempotency-Key', min_length=8, max_length=128)): service.read_draft(actor, skill_id) if runtime is None: raise SkillError("EXECUTOR_NOT_CONNECTED", "运行模块尚未配置。", 503) return runtime.trial(actor, skill_id, data.model_dump(), key) @router.get("/skills") def released(project_id: str | None = Query(default=None, max_length=80), actor=Depends(principal)): return {"items": service.releases(actor, project_id)} @router.post("/skills/prepare", status_code=201) def prepare(data: Prepare, key: str = Header(alias="Idempotency-Key", min_length=8, max_length=128), actor=Depends(principal)): return service.prepare(actor, data.release_ref, data.project_id, data.source_digest, key) @router.get("/coding/policy") def policy(actor=Depends(principal)): return {"default_language": "java", "default_java_release": 17, "framework_when_unspecified": "no_additional_framework", "skill_required": False, "without_skill": "ordinary_model_chat_without_code_execution", "platform_backend": "python-fastapi-as-explicitly-designed", "deployment": "local_only_until_space_provided"} return router