Skip to content

agentic.RunRef

Page status: scaffold Source state: generated Applies to: Shepherd v1.0-dev Owner: @docs-system-owner (TBD) Validation: scripts/gen_shepherd_api_inventory.py --check

This is reference — exact, generated facts. The mental model lives in concepts; recipes live in guides.

Pre-rename surface

Generated from the internal agentic facade; names and paths change at the Shepherd rename.

class

RunRef dataclass

Durable identity of one Run.

Process-local in the syntax nucleus; durable across processes once the durable-runs lane lands. The string id is the externally visible identifier; downstream code should treat RunRef as opaque. metagit is populated once a meta-git-backed run opens (None otherwise), so existing RunRef(id=...) construction stays valid.

id instance-attribute 

id: str

metagit class-attribute instance-attribute 

metagit: MetaGitExecutionLink | None = None

__init__ 

__init__(
    id: str, metagit: MetaGitExecutionLink | None = None
) -> None

See also