File size: 3,114 Bytes
0b0888d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
"""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