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:
- https://github.com/Hmbown/CodeWhale/issues/3154 (Agent Fleet control plane)
- https://github.com/Hmbown/CodeWhale/issues/3096 (Runtime API sub-agent direction)
Structs§
- Fleet
Alert Endpoint - An alert channel endpoint, supporting both inline URLs and secret refs.
- Fleet
Alert Policy - Alert/escalation policy attached to a task or run.
- Fleet
Artifact Ref - Reference to an artifact produced or consumed by a task.
- Fleet
Capability Grant - A capability grant that explicitly authorizes a worker to perform a specific class of action.
- Fleet
Environment Requirements - Environment variables a task requires or may pass through to workers.
- Fleet
Inbox Entry - Durable inbox entry: a task waiting to be leased to a worker.
- Fleet
Receipt - Receipt produced when a task completes verification.
- Fleet
Retry Policy - Retry policy for a task or worker.
- Fleet
Run - Top-level fleet run handle.
- Fleet
RunId - Globally unique identifier for a fleet run.
- Fleet
Score - Fleet
Secret Ref - A reference to a secret that should be resolved at runtime, never serialized as a plaintext value.
- Fleet
Security Policy - Security policy applied to a fleet run.
- Fleet
Task Budget - Budget limits for a task.
- Fleet
Task Spec - Specification of a single unit of work within a run.
- Fleet
Task Worker Profile - Worker role and tool expectations for a task.
- Fleet
Worker Event - Worker event envelope.
- Fleet
Worker Spec - Worker specification.
- Fleet
Workspace Requirements - Workspace and environment constraints needed before a task starts.
Enums§
- Fleet
Alert Channel - Fleet
Alert Event Class - Fleet
Artifact Kind - Kind of artifact a task may produce or consume.
- Fleet
Host Spec - Host on which a worker runs.
- Fleet
RunStatus - Lifecycle status for an entire fleet run.
- Fleet
Scorer Spec - Scoring rule used to verify a task result.
- Fleet
Task Failure Kind - Source category for a failed task receipt.
- Fleet
Task Result - Fleet
Trust Level - Trust classification assigned to a worker host.
- Fleet
Worker Auth - How a worker authenticates to the fleet manager.
- Fleet
Worker Event Payload - Union of all worker event payloads.
- Fleet
Worker Status - Runtime status of a worker.