Fleet, evidence, and operations
Signed inventory, desired state, typed control, exact exchange evidence, audit, monitoring, and bounded automation.
On this page
Inventory and health
The native management dashboard summarizes connected nodes, policy coverage, decision outcomes, pending approvals, evaluator health, command state, and recent activity. Fleet views support server-side filters and pagination for node status, group, tag, policy drift, connector capability, runtime version, and last report time.
Each node detail joins its signed identity, harness and connector versions, uptime, counters, connectivity, current and desired policy revisions, groups, tags, quarantine posture, recent actions, receipts, commands, state root, and acknowledgements. A stale or missing report is visible; the UI does not silently treat configured state as observed state.
Desired state and drift
Authority-signed desired state can set group, tags, desired runtime version, desired policy revision, and quarantine posture. The node verifies the command key and monotonic floors, persists before applying, reconciles locally, then returns a signed applied, partially_applied, or rejected acknowledgement. Drift remains visible until the reported state converges.
Runtime version is a desired target, not permission for the control plane to replace arbitrary executables. The deployment supervisor remains responsible for changing installed software.
Remote commands
Remote operations are typed, targeted, authority-signed, reason-bound, expiring, cancellable, and auditable. Supported commands are:
refresh_policy— fetch and acknowledge the current signed rollout;export_receipts— flush pending signed receipt evidence;reload_control— reload the verified local control attachment;sync_state— report and reconcile the safe state tree;collect_diagnostics— return bounded diagnostic status;restart_runtimeandshutdown_runtime— graceful typed lifecycle requests.
Pilot is not a remote shell. Operators cannot type arbitrary commands into the fleet console. Nodes return bounded signed result codes, and protected local authority cannot be widened through command parameters.
.pilot state visibility
An adopted node can report a signed manifest of its managed state directory: relative paths, file or directory kind, size, mode, modification time, content hash, revision, and root hash. Safe text files may expose sanitized or bounded content. Keys, seeds, credentials, identity, policy internals, trust material, and rollback floors are fingerprint-only and immutable through this channel.
Supported state changes use optimistic concurrency. A mutation names the expected tree revision and existing file hash, contains an auditable reason, expires, and is signed by the authority. The node independently validates safe paths and modes, applies the change locally, and reports the resulting signed revision. History records additions, changes, removals, and root hashes.
Exchanges and tracing
The Exchanges workspace stores tenant-scoped request and response evidence with server-side search and pagination. A detail view correlates:
- agent, action, called resource, intent ID, session, and signing key;
- exact request and reported response content, content type, length, encryption key ID, hash, and retention;
- recipient, purpose, labels, residency, and retention class;
- deterministic and semantic decisions, matched rules and clauses, evaluator/model/prompt versions;
- approval transaction, votes, expiry, continuation, and execution state;
- post-hook result, receipt, fleet activity, audit entries, and procedure runs.
Browser previews are bounded. Complete retained objects require explicit evidence permission and an audited download. Audit metadata and exact exchange content are separate stores with different access and retention concerns.
Audit and investigations
Management mutations write an append-only attempt event and a terminal result event. Records include actor, roles, authentication method, operation, reason, correlation ID, status, duration, and request/response hashes without copying secrets. Operators can filter, paginate, inspect, export NDJSON, monitor continuous delivery, and retry dead-letter exports.
Investigations have assignee, severity, status, resolution, timestamps, and links to action, exchange, receipt, command, and audit evidence. Legal hold and retention policy preserve required objects. Signed action receipts are verified at ingest and may be mirrored into compliance-retention object storage.
Procedures
Procedures are immutable, revisioned, post-action response policies. Triggers match action, node, risk, decision, or observed result. The closed response vocabulary can create an alert, open an investigation, quarantine a node, request policy refresh, request receipt export, or notify an active integration.
A run is durable and idempotent for the activity and procedure revision. Procedures cannot grant or retry the original action, inspect arbitrary content, execute shell commands, or invent remote methods.
External integrations
| Kind | Purpose | Lifecycle |
|---|---|---|
| OIDC / Keycloak | Optional workforce identity federation. | Stage, inspect, probe, activate, rotate, disable. |
| OpenBao / KMS | External signing-key custody. | Reference-only secrets and signature verification. |
| S3-compatible Object Lock | Immutable receipt and evidence mirror. | Retention and legal-hold evidence. |
| PostgreSQL | Replica-safe shared authority state. | TLS, migrations, backup, restore, and health. |
| Prometheus-compatible storage | Metrics retention. | Pilot's native UI remains the operator dashboard. |
| Usage sink | Asynchronous idempotent commercial usage delivery. | Tenant-scoped credentials and delivery health. |
| Audit/SIEM and webhook | Management export, approval, and procedure notifications. | Retry, dead letter, health, and rotation. |
Connectors store secret references, not rendered secret values. Hosted semantic evaluation is Pilot platform infrastructure and is not configured as a customer-owned integration.
Object lifecycle
| Object | Create | Change | Terminal behavior |
|---|---|---|---|
| Node | One-time adopted identity and signed report. | Desired state, tags, groups, quarantine, commands. | Retire or revoke; reactivate only where policy permits. |
| Policy statement | Inactive source revision. | Compile, review, approve, deploy. | Reject or retire; signed policy removal is a higher revision. |
| Policy change | Draft candidate. | Diff, simulate, approve, publish, canary, promote. | Withdraw, terminate, or monotonic rollback. |
| Approval transaction | Exact intent and payload binding. | Vote, escalate, cancel. | Execute once, reject, cancel, or expire. |
| Procedure | Inactive draft revision. | New revision, activate, disable. | Retire while retaining run evidence. |
| Integration | Staged revision. | Probe, activate, rotate, disable. | Retain revision and audit history. |