"""Public helper types for extension runners.

Extension Python runners are called with one dictionary context and should return
one dictionary shaped like `RunnerResult`.
"""

from __future__ import annotations

from typing import Any, TypedDict


class RunnerResult(TypedDict, total=False):
    result: str
    observations: list[str]
    facts: dict[str, Any]
    artifact_refs: list[str]