mechaharness.core.environment

Optional host probe for the active inference environment.

Hosts (for example junespark) implement this to refuse runs that need capabilities the loaded profile does not provide. The library default is a no-op so CLI/mock paths stay unchanged.

Lanes are open str identity (reason, judge, media, or a host namespace). Unknown lanes round-trip; hosts supply load hints.

class mechaharness.core.environment.InferenceEnvironment

Bases: ABC

Describe what the current backend / host profile can do.

abstractmethod active_capabilities() → CapabilityProfile

Capability set of the loaded environment.

active_grants() → list[str]

Grants the environment is willing to honor (default: none).

active_lane() → str | None

Capability lane derived from the active profile, or None if unknown.

Well-known values: reason, judge, media. Hosts may return other namespaced lanes.

abstractmethod active_profile() → str | None

Host profile name, or None when unknown.

assert_compatible(*, required_grants: Sequence[object] | None = None, require_media: bool = False, require_lane: str | None = None) → None

Raise if the active environment cannot satisfy the request.

lane_load_hint(lane: str) → str

Operator hint naming how to load a profile for lane.

exception mechaharness.core.environment.InferenceEnvironmentError

Bases: MechaHarnessError

Requested work does not match the active inference environment.

class mechaharness.core.environment.NoOpInferenceEnvironment

Bases: InferenceEnvironment

Always compatible; used when no host probe is configured.

active_capabilities() → CapabilityProfile

Capability set of the loaded environment.

active_lane() → str | None

Capability lane derived from the active profile, or None if unknown.

Well-known values: reason, judge, media. Hosts may return other namespaced lanes.

active_profile() → str | None

Host profile name, or None when unknown.

assert_compatible(*, required_grants: Sequence[object] | None = None, require_media: bool = False, require_lane: str | None = None) → None

Raise if the active environment cannot satisfy the request.