from fastapi import APIRouter, Depends from pydantic import Field from src.modules.skill.domain.models import Contract class Search(Contract): query: str = Field(min_length=1, max_length=300) collection_ids: list[str] = Field(min_length=1, max_length=10) limit: int = Field(default=8, ge=1, le=20) for_code_reuse: bool = False def build_router(catalog, principal): router = APIRouter(prefix="/api/v1", tags=["ZKCoding Knowledge"]) @router.get("/knowledge/collections") def collections(actor=Depends(principal)): return {"items": catalog.collections(actor)} @router.post("/knowledge/search") def search(data: Search, actor=Depends(principal)): return {"items": catalog.search(actor, data.query, data.collection_ids, data.limit, for_code_reuse=data.for_code_reuse), "mode": "lexical_with_explicit_aliases", "review": "external_reference_not_enterprise_rule"} return router