sharp-pixel's picture
Upload compact v2 adapter
0b0888d verified
Raw History Blame Contribute Delete
3.11 kB
"""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