Enum Request 

pub enum Request {
    Ping,
    Shutdown,
    Status,
    Lookup {
        cache_key: String,
    },
    Store {
        cache_key: String,
        artifact: ArtifactData,
    },
    SessionStart {
        client_pid: u32,
        working_dir: NormalizedPath,
        log_file: Option<NormalizedPath>,
        track_stats: bool,
        journal_path: Option<NormalizedPath>,
        profile: bool,
    },
    Compile {
        session_id: String,
        args: Vec<String>,
        cwd: NormalizedPath,
        compiler: NormalizedPath,
        env: Option<Vec<(String, String)>>,
        stdin: Vec<u8>,
    },
    SessionEnd {
        session_id: String,
    },
    Clear,
    CompileEphemeral {
        client_pid: u32,
        working_dir: NormalizedPath,
        compiler: NormalizedPath,
        args: Vec<String>,
        cwd: NormalizedPath,
        env: Option<Vec<(String, String)>>,
        stdin: Vec<u8>,
    },
    LinkEphemeral {
        client_pid: u32,
        tool: NormalizedPath,
        args: Vec<String>,
        cwd: NormalizedPath,
        env: Option<Vec<(String, String)>>,
    },
    SessionStats {
        session_id: String,
    },
    FingerprintCheck {
        cache_file: NormalizedPath,
        cache_type: String,
        root: NormalizedPath,
        extensions: Vec<String>,
        include_globs: Vec<String>,
        exclude: Vec<String>,
    },
    FingerprintMarkSuccess {
        cache_file: NormalizedPath,
    },
    FingerprintMarkFailure {
        cache_file: NormalizedPath,
    },
    FingerprintInvalidate {
        cache_file: NormalizedPath,
    },
    ListRustArtifacts,
}

A request from client to daemon.

Variants

Ping

Health check.

Shutdown

Request daemon shutdown.

Status

Request daemon status/statistics.

Lookup

Look up a cached artifact by cache key.

Fields

cache_key: String

Hex-encoded cache key.

Store

Store a compilation artifact.

Fields

cache_key: String

Hex-encoded cache key.

artifact: ArtifactData

The artifact data to store.

SessionStart

Start a new session with the daemon.

Fields

client_pid: u32

Client process ID.

working_dir: NormalizedPath

Client working directory.

log_file: Option<NormalizedPath>

Optional path to a log file for this session.

track_stats: bool

Whether to track per-session statistics.

journal_path: Option<NormalizedPath>

Path for per-session JSONL compile journal (must end in .jsonl).

profile: bool

Issue #256: opt in to the extended journal schema. When true, the daemon populates crate_name, crate_type, output_ext, and self_profile_ns on every compile journal line for the duration of this session. When false, behavior is identical to releases before the flag existed (no new allocations, no new fields).

Compile

Compile a source file within an existing session.

Fields

session_id: String

Session ID from a prior SessionStart (UUID string).

args: Vec<String>

Compiler arguments (e.g., [“-c”, “hello.cpp”, “-o”, “hello.o”]).

cwd: NormalizedPath

Working directory for the compilation.

compiler: NormalizedPath

Path to the compiler executable (required).

env: Option<Vec<(String, String)>>

Client environment variables to pass to the compiler process. If None, the daemon’s own environment is inherited (backward compat). If Some, the compiler process uses exactly these env vars.

stdin: Vec<u8>

Bytes the wrapper read from its own stdin, ferried to the compiler child’s stdin over IPC. Empty = no stdin (Stdio::null on the daemon side). cargo’s RUSTC_WRAPPER path normally yields zero bytes here; the field exists so that rustc - and similar stdin-consuming invocations work transparently.

SessionEnd

End a session.

Fields

session_id: String

Session ID to end (UUID string).

Clear

Clear all caches (artifacts, metadata, dep graph).

CompileEphemeral

Single-roundtrip ephemeral compile: session start + compile + session end in one message. Used by the CLI in drop-in wrapper mode to avoid 3 IPC roundtrips per invocation.

Fields

client_pid: u32

Client process ID.

working_dir: NormalizedPath

Client working directory.

compiler: NormalizedPath

Path to the compiler executable.

args: Vec<String>

Compiler arguments (e.g., [“-c”, “hello.cpp”, “-o”, “hello.o”]).

cwd: NormalizedPath

Working directory for the compilation.

env: Option<Vec<(String, String)>>

Client environment variables to pass to the compiler process.

stdin: Vec<u8>

Bytes the wrapper read from its own stdin, ferried to the compiler child’s stdin over IPC. Empty = Stdio::null on the daemon side. See Request::Compile for context.

LinkEphemeral

Single-roundtrip ephemeral link/archive: used for zccache ar ... or zccache ld ... in drop-in wrapper mode.

Fields

client_pid: u32

Client process ID.

tool: NormalizedPath

Path to the linker/archiver tool (ar, ld, lib.exe, link.exe, etc.).

args: Vec<String>

Tool arguments (e.g., [“rcs”, “libfoo.a”, “a.o”, “b.o”]).

cwd: NormalizedPath

Working directory for the link operation.

env: Option<Vec<(String, String)>>

Client environment variables.

SessionStats

Query per-session statistics without ending the session. NOTE: Appended at end to preserve bincode variant indices.

Fields

session_id: String

Session ID to query (UUID string).

FingerprintCheck

Check if files have changed since last successful fingerprint. NOTE: Appended at end to preserve bincode variant indices.

Fields

cache_file: NormalizedPath

Path to the cache file (e.g., .cache/lint.json).

cache_type: String

Cache algorithm: “hash” or “two-layer”.

root: NormalizedPath

Root directory to scan.

extensions: Vec<String>

File extensions to include (without dot, e.g., “rs”, “cpp”). Empty = all files. Conflicts with include_globs.

include_globs: Vec<String>

Glob patterns for files to include (e.g., “**/*.rs”). Empty = use extensions filter.

exclude: Vec<String>

Patterns or directory names to exclude.

FingerprintMarkSuccess

Mark the previous fingerprint check as successful.

Fields

cache_file: NormalizedPath

Path to the cache file.

FingerprintMarkFailure

Mark the previous fingerprint check as failed.

Fields

cache_file: NormalizedPath

Path to the cache file.

FingerprintInvalidate

Invalidate a fingerprint cache (delete all state).

Fields

cache_file: NormalizedPath

Path to the cache file.

ListRustArtifacts

List all cached Rust artifacts with their output paths. NOTE: Appended at end to preserve bincode variant indices.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Request

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Request

fn eq(&self, other: &Request) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Request

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Request