"""Render compact-v2 output with application-supplied trusted controls. This is a contract example, not a replacement for application policy checks. """ from __future__ import annotations import json from pathlib import Path from typing import Any, Literal from jinja2 import Environment, FileSystemLoader, StrictUndefined from pydantic import BaseModel, ConfigDict, Field Facet = Literal["category", "gender_affinity", "condition", "material", "country"] ORDER = {name: i for i, name in enumerate(("category", "gender_affinity", "condition", "material", "country"))} SORT = {"recommended": "recommended", "price_asc": "price_asc", "listed_at_desc": "newest", "old_price_desc": "price_drop"} TEMPLATES = Environment( loader=FileSystemLoader(Path(__file__).parent / "templates"), undefined=StrictUndefined, autoescape=False, ) class CompactVariables(BaseModel): model_config = ConfigDict(extra="forbid", strict=True) filters: list[tuple[Facet, str | list[str]]] = Field(max_length=5) op: Literal["and", "or"] price: int = Field(ge=1, le=20000) q: str = Field(min_length=1, max_length=300) def render_model_output(content: str, context: dict[str, Any]) -> dict[str, Any]: """Parse model JSON, then combine it with *server-owned* context.""" variables = CompactVariables.model_validate_json(content) required = context["required_filters"] if not isinstance(required, list) or required.count({"term": {"availability": "active"}}) != 1: raise ValueError("invalid required availability filter") facets: list[dict[str, Any]] = [] for clause in required: if clause == {"term": {"availability": "active"}}: continue if not isinstance(clause, dict) or len(clause) != 1: raise ValueError("invalid required filter") op, fields = next(iter(clause.items())) if op not in ("term", "terms") or not isinstance(fields, dict) or len(fields) != 1: raise ValueError("invalid required facet filter") field, value = next(iter(fields.items())) if field not in ORDER: raise ValueError("unsupported required facet") facets.append({"op": op, "field": field, "value": value}) for field, value in variables.filters: facets.append({"op": "terms" if isinstance(value, list) else "term", "field": field, "value": value}) facets.sort(key=lambda item: ORDER[item["field"]]) rendered = TEMPLATES.get_template("optimized-query-v2.json.j2").render( filters=[ {"field": "availability", "op": "term", "value": "active"}, {"field": "price", "op": "range", "value": {"lte": variables.price}}, *facets, ], operator=variables.op, persona=context["persona"].get("query_expansion"), size=context["size"], sort=SORT[context["sort_mode"]], text=variables.q, track_total_hits=context["track_total_hits"], ) result = json.loads(rendered) if not isinstance(result, dict): raise ValueError("template did not render a JSON object") return result