"""Temporal activity definitions for activity-core.

Activities run inside a Worker bound to 'orchestrator-tq'.
Each function is decorated with @activity.defn and executed by
RunActivityWorkflow via workflow.execute_activity().

Implementations are added in T14–T17; stubs here let the worker
register correctly before the bodies are written.
"""

from __future__ import annotations

from temporalio import activity


@activity.defn
async def load_activity_definition(activity_id: str) -> dict:
    """Load an ActivityDefinition row from the DB by ID.

    Returns a JSON-serialisable dict (Pydantic .model_dump()).
    Implemented in T14.
    """
    raise NotImplementedError("T14")


@activity.defn
async def resolve_context(context_sources: list[dict]) -> dict:
    """Fetch and merge all context sources into a single snapshot dict.

    Implemented in T15.
    """
    raise NotImplementedError("T15")


@activity.defn
async def log_run(run_payload: dict) -> str:
    """Persist an ActivityRun record and return its run_id.

    Implemented in T17.
    """
    raise NotImplementedError("T17")