Physical AI host configuration

Package	Value
Distribution	archetype-physical-ai
Import package	archetype.physical_ai

Integration API. Configure trusted hosted-episode providers at process composition time.

PhysicalAIExtensionConfig dataclass

PhysicalAIExtensionConfig(
    *,
    hosted_episode_provider_factory=None,
    hosted_activity_lease_seconds=300.0,
)

Configure hosted Physical-AI providers at process composition time.

HostedEpisodeProvider

Execute or reconcile a whole episode under provider-owned semantics.

HostedEpisodeProviderResult dataclass

HostedEpisodeProviderResult(
    request_ipc,
    trajectory_ipc,
    episode_results_ipc,
    manifest_ipc,
)

Complete provider-durable bytes, recovered before Activity recording.

Field	Type	Default
request_ipc	bytes	required
trajectory_ipc	bytes	required
episode_results_ipc	bytes	required
manifest_ipc	bytes	required

HostedEpisodeRetryGuard dataclass

HostedEpisodeRetryGuard(ref, digest)

Provider-side atomic-start evidence for one safe fresh claim.

Field	Type	Default
ref	str	required
digest	str	required

HostedEpisodeReconciliation

HostedEpisodeReconciliation = (
    HostedEpisodeRecovered
    | HostedEpisodeConfirmedAbsent
    | HostedEpisodeRecoveryUnknown
)

HostedEpisodeRecovered dataclass

HostedEpisodeRecovered(result)

Provider evidence proves the exact prior operation completed.

Field	Type	Default
result	HostedEpisodeProviderResult	required

HostedEpisodeConfirmedAbsent dataclass

HostedEpisodeConfirmedAbsent(guard)

Provider evidence proves atomic-start absence behind a retry guard.

Field	Type	Default
guard	HostedEpisodeRetryGuard	required

HostedEpisodeRecoveryUnknown dataclass

HostedEpisodeRecoveryUnknown(reason='')

Provider truth cannot establish completion or safe absence.

Field	Type	Default
reason	str	''