"""Public data shapes for the Analyses layer.""" from __future__ import annotations from dataclasses import dataclass, field from typing import Any @dataclass class Finding: """Structured output every Analysis returns.""" analysis: str summary: str rows: list[dict[str, Any]] = field(default_factory=list) sql: list[str] = field(default_factory=list) error: str | None = None metadata: dict[str, Any] = field(default_factory=dict)