Expand description
Neutral host topology, connection, transfer, and bounded fanout contracts.
soma-fleet defines transport-independent identities, topology snapshots,
request bounds, execution ports, revision-keyed connection caching, and a
cancellation-aware fanout scheduler. Product configuration, authorization,
command allowlists, and concrete SSH clients live above or behind this crate.
Structs§
- Capability
Name - Lowercase dotted capability advertised by a host or transport.
- Command
Output - Bounded command execution output.
- Command
Request - Bounded exec-style command request with no shell interpretation.
- Connection
Cache - Thread-safe connection cache bound to exact host topology revisions.
- Connection
Pool - Async connection pool keyed by stable host identity and exact topology revision.
- Fanout
Policy - Bounds for concurrent target execution.
- Fanout
Report - Complete stable-order fanout report.
- Fanout
Scheduler - Cancellation-aware stable-order bounded fanout scheduler.
- Fleet
Event - Product-neutral fleet lifecycle event.
- Forwarded
Unix Socket - RAII guard over one local-to-remote Unix socket forward.
- HostId
- Stable lowercase identity for one managed host.
- Host
Record - Product-neutral managed host record.
- Http
Endpoint - Validated HTTP or HTTPS fleet endpoint.
- Local
Process Driver - Local process-backed command driver used for conformance and local hosts.
- Noop
Fleet Event Sink - Event sink that discards all events.
- Open
SshConnect Plan - Inspectable strict OpenSSH connection plan derived from one host record.
- Open
SshConnection - Revision-bound multiplexed OpenSSH session.
- Open
SshConnector - Strict OpenSSH connection factory.
- Open
SshDriver - Pooled strict OpenSSH command driver.
- PoolKey
- Connection-cache key bound to host identity and exact topology revision.
- SshEndpoint
- Strict-host-key SSH connection material.
- System
Fleet Clock - System-wall-clock implementation.
- Target
Outcome - Stable-order result for one target.
- Topology
Revision - SHA-256 revision of all transport-affecting topology material.
- Topology
Snapshot - Immutable topology snapshot with unique host identities.
- Transfer
Guard - RAII transfer accounting guard.
- Transfer
Lifecycle - Cloneable observer for one transfer guard.
- Transfer
Receipt - Verified transfer completion metadata.
- Transfer
Request - Descriptor-confined transfer request between managed hosts.
Enums§
- Fanout
Policy Error - Invalid bounded fanout policy.
- Fleet
Error - Product-neutral fleet discovery, connection, command, and transfer failure.
- Fleet
Event Kind - Stable fleet lifecycle event category.
- Host
Endpoint - Transport endpoint for one managed host.
- Identity
Error - Invalid fleet identity.
- Request
Error - Invalid fleet command or transfer request.
- Target
Outcome Kind - Terminal classification for one target.
- Topology
Error - Invalid host endpoint or topology snapshot.
- Transfer
Guard State - Observable terminal or in-flight transfer state.
Traits§
- Command
Executor - Exec-style command driver for local, SSH, or other host transports.
- Connection
Factory - Driver that opens and closes revision-bound host connections.
- File
Transfer - Descriptor-confined file transfer driver.
- Fleet
Clock - Clock used for request deadline admission and deterministic tests.
- Fleet
Event Sink - Sink for durable or observable fleet lifecycle events.
- Host
Repository - Source of immutable fleet topology snapshots.
Functions§
- forwarded_
socket_ path - Returns a private deterministic-shape local path for a forwarded Unix socket.
Type Aliases§
- Fleet
Result - Fleet operation result using the shared error vocabulary.