Function parse_agent_reference

sia/agent_reference.py:56–78

Parse a raw ``agent_reference`` value from a profile JSON into an AgentReference. ``base_dir`` is the directory the profile file lives in; a relative ``source`` resolves against it (falling back to the current working directory).

(spec: object, base_dir: str | Path | None = None)

def parse_agent_reference(spec: object, base_dir: str | Path | None = None) -> AgentReference:
    """Parse a raw ``agent_reference`` value from a profile JSON into an AgentReference.

    ``base_dir`` is the directory the profile file lives in; a relative ``source``
    resolves against it (falling back to the current working directory).
    """
    if spec is None or spec == "default":
        return DEFAULT_AGENT_REFERENCE
    if not isinstance(spec, dict) or "source" not in spec:
        raise SystemExit('agent_reference must be "default" or an object with a "source" field')

    data = cast("dict[str, Any]", spec)
    base = Path(base_dir) if base_dir else Path.cwd()
    source = Path(data["source"])
    if not source.is_absolute():
        source = base / source
    source = source.resolve()

    if source.is_dir():
        return AgentReference(kind="dir", source=source, entrypoint=data.get("entrypoint"))
    if source.is_file():
        return AgentReference(kind="file", source=source)
    raise SystemExit(f"agent_reference source not found: {source}")


def resolve_agent_reference(ref: AgentReference, task_layout: TaskLayout) -> ResolvedAgentReference: