spdl.autoresearch.core.HypothesisNode

class HypothesisNode(node_id: str, name: str, parent_id: str | None = None, commit: str | None = None, spec: dict = <factory>, status: str = 'queued', job_id: str | None = None, launched_at: float | None = None, result: dict | None = None, children: list[str] = <factory>, priority: float = 0.0, duration: float | None = None, failure: ~spdl.autoresearch.core._types.FailureRecord | None = None)

A node in the autoresearch hypothesis tree.

Methods

from_dict(data)
to_dict()

Attributes

commit	Source-control commit hash for this experiment's code state.
duration	Job duration in seconds, if completed.
failure	Structured failure record, if the experiment failed.
job_id	External job identifier, if launched.
launched_at	Unix timestamp when the job was launched.
parent_id	ID of the parent node, or None for root nodes.
priority	Scheduling priority (lower runs first).
result	Raw result dict from analysis.
status	Current lifecycle status ("queued", "running", "completed", "failed").
node_id	Unique identifier (e.g. "003_nvdec").
name	Human-readable experiment name.
spec	Free-form experiment specification dict.
children	IDs of child nodes in the hypothesis tree.

children: list[str]

IDs of child nodes in the hypothesis tree.

commit: str | None = None

Source-control commit hash for this experiment’s code state.

duration: float | None = None

Job duration in seconds, if completed.

failure: FailureRecord | None = None

Structured failure record, if the experiment failed.

classmethod from_dict(data: dict) → HypothesisNode

job_id: str | None = None

External job identifier, if launched.

launched_at: float | None = None

Unix timestamp when the job was launched.

name: str

Human-readable experiment name.

node_id: str

Unique identifier (e.g. "003_nvdec").

parent_id: str | None = None

ID of the parent node, or None for root nodes.

priority: float = 0.0

Scheduling priority (lower runs first).

result: dict | None = None

Raw result dict from analysis.

spec: dict

Free-form experiment specification dict.

status: str = 'queued'

Current lifecycle status ("queued", "running", "completed", "failed").

to_dict() → dict