Enum AgentRequest 

pub enum AgentRequest {
    Hello {
        protocol: u8,
        client_version: String,
    },
    BeginTask {
        task: String,
    },
    CommitTask {
        run: String,
    },
    FindBlob {
        digest: CacheDigest,
    },
    FindBlobs {
        digests: Vec<CacheDigest>,
    },
    StoreBlob {
        digest: CacheDigest,
        source: PathBuf,
    },
    FindActionResult {
        action: CacheDigest,
    },
    RecordActionHit {
        action: CacheDigest,
        restore: RestoreStats,
        crate_name: Option<String>,
    },
    RecordBypass {
        kind: String,
    },
    RecordUnconsulted,
    RecordCompilerInvocation {
        outcome: String,
        crate_name: Option<String>,
        duration_ns: u64,
    },
    RecordActionVerification {
        matched: bool,
        restore: RestoreStats,
    },
    StoreActionResult {
        result: RemoteActionResult,
    },
    FindActionPrediction {
        task: String,
        invocation: CacheDigest,
    },
    RecordActionPrediction {
        task: String,
        prediction: ActionPrediction,
    },
    FindExecutableIdentity {
        executable: PathBuf,
        environment: BTreeMap<String, Option<String>>,
    },
    StoreExecutableIdentity {
        executable: PathBuf,
        environment: BTreeMap<String, Option<String>>,
        stdout: Vec<u8>,
    },
    RecordWarning {
        message: String,
    },
    FindFileDigests {
        scope: FileDigestScope,
        files: Vec<FileIdentity>,
    },
    RecordFileDigests {
        scope: FileDigestScope,
        entries: Vec<RecordedFileDigest>,
    },
    JoinActionPromise {
        adapter: String,
        invocation: CacheDigest,
    },
    CompleteActionPromise {
        claim: String,
        prediction: ActionPrediction,
    },
}

A request accepted by the task-scoped cache agent.

Variants

Hello

Negotiate protocol and application versions.

Fields

protocol: u8

Agent protocol version understood by the caller.

client_version: String

Human-readable mbx client version.

BeginTask

Begin a prediction-manifest run for a stable Cargo or task identity.

Fields

task: String

Stable 64-character lowercase hexadecimal task identity.

CommitTask

Commit predictions collected by an earlier Self::BeginTask.

Fields

run: String

Opaque run identifier returned by the agent.

FindBlob

Resolve a blob to a session-verified local CAS path.

Fields

digest: CacheDigest

Blob to resolve.

FindBlobs

Resolve blobs to session-verified local CAS paths.

Fields

digests: Vec<CacheDigest>

Blobs to resolve, preserving request order in the response.

StoreBlob

Import a file into the local content-addressed store.

Fields

digest: CacheDigest

Digest the source must match.

source: PathBuf

File to verify and import.

FindActionResult

Look up an action-result record.

Fields

action: CacheDigest

Action digest to resolve.

RecordActionHit

Account for a successfully restored cache hit.

Fields

action: CacheDigest

Action that supplied the outputs.

restore: RestoreStats

Restoration work performed by the adapter.

crate_name: Option<String>

Compiler crate name, when the invocation supplied one.

RecordBypass

A compilation the adapter declined to cache, grouped by reason.

Fields

kind: String

Stable, low-cardinality bypass-reason name.

RecordUnconsulted

A compilation the adapter could not look up, having no key to look up with. Distinct from a bypass: these are cached once compiled.

RecordCompilerInvocation

Account for one real compiler invocation performed by the adapter.

Fields

outcome: String

Stable outcome category such as miss, unconsulted, bypass, or incremental for a compilation the adapter deliberately ran with incremental state instead of publishing.

crate_name: Option<String>

Compiler crate name, when the invocation supplied one.

duration_ns: u64

Wall time spent running the compiler.

RecordActionVerification

Account for a cache hit that was rebuilt for correctness verification.

Fields

matched: bool

Whether rebuilt and cached outputs matched.

restore: RestoreStats

Restoration work performed before rebuilding.

StoreActionResult

Store an action-result record locally and enqueue remote publication.

Fields

result: RemoteActionResult

Action-result record to store.

FindActionPrediction

Find an earlier input prediction for a task and invocation.

Fields

task: String

Stable task identity.

invocation: CacheDigest

Digest of the compiler invocation without discovered inputs.

RecordActionPrediction

Record an input prediction after a successful compilation.

Fields

task: String

Stable task identity.

prediction: ActionPrediction

Adapter-owned prediction record.

FindExecutableIdentity

Find cached identity output for an executable and environment.

Fields

executable: PathBuf

Executable whose identity command would run.

environment: BTreeMap<String, Option<String>>

Environment variables affecting identity output.

StoreExecutableIdentity

Cache identity output for an executable and environment.

Fields

executable: PathBuf

Executable whose identity command ran.

environment: BTreeMap<String, Option<String>>

Environment variables affecting identity output.

stdout: Vec<u8>

Captured identity-command standard output.

RecordWarning

Surface a shim diagnostic through the session that owns the build.

A shim must not print diagnostics itself: its stderr belongs to the compiler it stands in for, and build scripts read that stream as part of the compiler’s answer – cc-rs treats any stderr output from a flag probe as “unsupported”, which changes the flags of every compilation that follows and, with them, every action key the build produces.

Appended rather than grouped with the other Record* requests it belongs beside: these variants carry no repr, so inserting one moves the discriminant of every variant after it, and a break nobody asked for is worth less than the grouping. New variants go here.

Fields

message: String

Human-readable single-line diagnostic.

FindFileDigests

Find session-recorded digests for files with these identities.

Fields

scope: FileDigestScope

What the recorded digests may stand in for.

files: Vec<FileIdentity>

File identities to resolve, preserving request order in the response.

RecordFileDigests

Record digests of files a shim hashed or wrote this session.

Fields

scope: FileDigestScope

What the recorded digests may stand in for.

entries: Vec<RecordedFileDigest>

Hashed files and the identities their digests describe.

JoinActionPromise

Join or claim an invocation-wide promise through the cache server.

Fields

adapter: String

Adapter that owns the invocation and prediction payload.

invocation: CacheDigest

Digest of the compiler invocation before input discovery.

CompleteActionPromise

Fulfill a claimed promise after its action result is remotely durable.

Fields

claim: String

Opaque claim token returned by Self::JoinActionPromise.

prediction: ActionPrediction

Prediction through which waiters reconstruct the final action key.

Trait Implementations

impl Clone for AgentRequest

fn clone(&self) -> AgentRequest

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.