fastsim.api.services

class ControlAxisDescriptor(object)

One ordered command axis and its accepted units.

class ControlCommandSpaceDescriptor(object)

Portable resource-specific contract for one command space. Frame-capable spaces always carry an explicit ``allowed_frames`` tuple. A required-frame space needs at least one entry; an optional space may use an empty tuple to advertise frameless-only operation. Frame-forbidden spaces may use either ``None`` or an empty tuple. ``unit_rule`` states whether the advertised per-axis unit choices are fixed, must be selected uniformly across all axes, or may be selected per axis. This is a track-target contract. Terminal policies and controller convergence are exposed separately by the enclosing target's controller execution descriptors.

class ControlControllerExecutionDescriptor(object)

Portable chunk-execution choices for one target-compatible controller.

class ControlEmbeddedBaseJointDescriptor(object)

Capture-safe manifest declaration for an embedded physical SE(2) base.

class ControlTargetDescriptor(object)

One immutable target visible through a plugin's exact control grant.

class RunInfoSnapshot(object)

Small immutable run identity safe to expose outside the core.

class PublishedPluginEvent(object)

One immutable, core-namespaced event emitted by a plugin.

class ScopedControlSession(Protocol)

Asynchronous control session with a policy fixed by the composition root.

class ScopedControlService(Protocol)

Factory for plugin-scoped control sessions.

class ScopedControlTargetService(Protocol)

Read-only exact-resource view of discoverable control targets.

class ScopedObservationSubscription(Protocol)

Bounded observation stream that cannot reveal ungranted channels. Application-loop plugins must use :meth:`get_async`; synchronous ``get`` is retained only for a plugin-owned worker thread.

class ScopedObservationChannelSubscription(Protocol)

Bounded independently stamped observation-channel stream.

class ScopedObservationService(Protocol)

Read-only exact-channel view of the runtime observation service.

class RunInfoService(Protocol)

Read-only immutable metadata for the current run.

class EventPublishService(Protocol)

Namespaced, bounded and portable plugin event publisher.