Expand description
HTTP wire types exchanged between the CLI, the edge worker, the scheduler Durable Object, and trusted CI.
Field docs describe the wire meaning of each payload; the validated
identity newtypes from crate::identity carry the invariants.
Structs§
- Artifact
Record - Artifact record CI POSTs to the edge’s register endpoint after a build.
- Batch
Artifact Request - Exact artifact batch request for one resolved dependency graph.
- Batch
Artifact Request Entry - One exact artifact to batch fetch from edge.
- Build
Complete Report - CI reports job completion to the scheduler DO.
- Build
Task Payload - The task the scheduler dispatches to
stow-build, carried verbatim as theworkflow_dispatchinput of the trusted build workflow. - Dependency
Graph Analysis Entry - Edge response for one dependency entry in the requested graph.
- Dependency
Graph Artifact - One exact cached artifact currently available for a dependency entry.
- Dependency
Graph Entry - A normalized dependency entry from a resolved Cargo dependency graph.
- Dependency
Graph Miss - A dependency miss that falls inside Stow’s prebuild window.
- Dependency
Graph Request - Request sent by the CLI to edge for graph-aware cache analysis.
- Dependency
Graph Response - Batch response describing the current graph’s cache coverage and upgrades.
- Enqueue
Admission - Admission ticket the edge mints for one canonical enqueue task when a public request misses the cache.
- Enqueue
Dependency - One task-level dependency that must complete before its parent dispatches.
- Enqueue
Request - Request body for scheduler task submission.
- Enqueue
Ticket - Request body for
POST /api/v1/enqueue: the redemption of anEnqueueAdmission. - Recommended
Dependency Version - The recommended upgrade target for one dependency entry.
- Resolve
Lockfile Request - Request body for
/api/v1/catalog/resolve-lockfile. - Resolve
Lockfile Response - Edge response carrying a stow-synthesized
Cargo.lockwhose every[[package]]entry corresponds to a cached artifact. - Resolved
Dependency Graph Dependency - One exact dependency edge in a client-resolved Cargo graph.
- Resolved
Dependency Graph Entry - One exact crates.io package node resolved from the client’s current lockfile graph.
- Scheduler
Status - Scheduler DO queue status for monitoring.
- Semantic
Artifact Request - Semantic artifact request from the CLI runtime wrapper.
- User
Direct Dependency - One direct dependency the user’s project declares.
Enums§
- Enqueue
Source - Where an enqueue request originated.