Skip to main content

Module fleet

Module fleet 

Source
Expand description

Agent Fleet control-plane protocol types.

These types define the durable, serializable contract between the fleet manager, workers, CLI/TUI surfaces, and the Runtime API. They are intentionally additive: existing runtime-event consumers ignore unknown fields and are unaffected by fleet extensions.

See:

Structs§

FleetAlertEndpoint
An alert channel endpoint, supporting both inline URLs and secret refs.
FleetAlertPolicy
Alert/escalation policy attached to a task or run.
FleetArtifactRef
Reference to an artifact produced or consumed by a task.
FleetCapabilityGrant
A capability grant that explicitly authorizes a worker to perform a specific class of action.
FleetEffectivePermissions
Effective worker authority persisted on a FleetReceipt (#3211).
FleetEnvironmentRequirements
Environment variables a task requires or may pass through to workers.
FleetEventReplay
Bounded durable replay page.
FleetInboxEntry
Durable inbox entry: a task waiting to be leased to a worker.
FleetReceipt
Receipt produced when a task completes verification.
FleetResolvedRoute
Resolved-route detail persisted on a FleetReceipt (#3154).
FleetRetryPolicy
Retry policy for a task or worker.
FleetRun
Top-level fleet run handle.
FleetRunId
Globally unique identifier for a fleet run.
FleetRuntimeEvent
One privacy-bounded durable event exposed to managed Fleet clients.
FleetScore
FleetSecretRef
A reference to a secret that should be resolved at runtime, never serialized as a plaintext value.
FleetSecurityPolicy
Legacy Runtime execution-policy envelope retained for ledger replay.
FleetTaskBudget
Budget limits for a task.
FleetTaskSpec
Specification of a single unit of work within a run.
FleetTaskWorkerProfile
Worker role and tool expectations for a task.
FleetUsageCeiling
Run-wide usage ceiling (R6, #5567). Token-denominated: workers report provider token counts; a cost-denominated ceiling needs priced receipts in the worker stream and is deliberately not declared until it can be enforced.
FleetWorkerEvent
Worker event envelope.
FleetWorkerSpec
Worker specification.
FleetWorkflowDescriptor
Durable identity for the Workflow that coordinates a Fleet run.
FleetWorkspaceRequirements
Workspace and environment constraints needed before a task starts.

Enums§

FleetAlertChannel
FleetAlertEventClass
FleetArtifactKind
Kind of artifact a task may produce or consume.
FleetHostSpec
Host on which a worker runs.
FleetRunStatus
Lifecycle status for an entire fleet run.
FleetRuntimeTarget
Product-level Runtime target for a managed Fleet run.
FleetScorerSpec
Scoring rule used to verify a task result.
FleetTaskFailureKind
Source category for a failed task receipt.
FleetTaskResult
FleetTrustLevel
Legacy trust classification retained only to deserialize old Fleet ledgers.
FleetWorkerAuth
How a worker authenticates to the fleet manager.
FleetWorkerEventPayload
Union of all worker event payloads.
FleetWorkerStatus
Runtime status of a worker.
FleetWorkflowKind
Scheduling shape currently executable by the durable Fleet manager.

Constants§

FLEET_PROTOCOL_VERSION