Spaces:
Sleeping
Sleeping
File size: 6,363 Bytes
caf8059 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | """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
|