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