Function _parse_page_json

openkb/agent/compiler.py:534–547

Parse an LLM page response into a single JSON object. Unwraps a single-element ``[{...}]`` array (some models wrap the object in a list). Returns ``None`` when the response is valid JSON of the wrong shape (empty/multi-element array, list of scalars) so callers skip the page rather

(text: str)

def _parse_page_json(text: str) -> dict | None:
    """Parse an LLM page response into a single JSON object.

    Unwraps a single-element ``[{...}]`` array (some models wrap the object in
    a list). Returns ``None`` when the response is valid JSON of the wrong
    shape (empty/multi-element array, list of scalars) so callers skip the page
    rather than persisting the raw JSON text as its body. Propagates the
    json/ValueError from ``_parse_json`` when the text isn't JSON at all, which
    callers catch to fall back to treating ``raw`` as a prose-markdown body.
    """
    parsed = _parse_json(text)
    if isinstance(parsed, list) and len(parsed) == 1 and isinstance(parsed[0], dict):
        parsed = parsed[0]
    return parsed if isinstance(parsed, dict) else None


def _page_fields(raw: str) -> tuple[str, str, dict | None]: