Get blueprint
Download
checkpoint-resume-runner-1.1.0.tgzEvery file of this release in one archive, ready to unpack into a folder.
Clone
npx -y darkprint clone autogen/checkpoint-resume-runnerThere is no repository and no history behind a release. Download hands you its files as they stand, and Clone fetches the same files by name.
A staged pipeline that snapshots state after every stage, so a failure at stage 3 resumes from the last good checkpoint instead of restarting the whole job.
- Vector store
- File I/O
Node job, Job Intake. DOT line 5, card job-intake@1.0.0. 9 nodes in the graph.
1 The graph
9 nodes · 10 edges- Hears from
- nothing in this graph
- Sends to
- plan
2 The card skeleton
idjob-intakeline 1Filled.
The key a blueprint pins. A DOT node carries card="id@version", and this string is the only way a graph and a card find each other. It may be namespaced, berti/solver-a, so two authors can publish a card under the same short name.
nameJob Intakeline 2Filled.
What a person calls the node. The drawing prints it and every listing leads with it. Nothing matches on it: that is the id's job, and the two are free to disagree.
typetoolline 3Filled.
Exactly one node-type term from the vocabulary. It says what kind of work the node does and whether a person acts at it: a type under human-in-the-loop, such as human-gate, holds the run until somebody acts; every other type lets it pass. The static analysis groups nodes by this term. Either way it is the author's design choice; nothing here is measured.
phaseoutside the fivenot writtenLeft empty by this card.
Which of the five phases the node stands in, any number of them. The phases describe a blueprint's shape rather than placing every node in one. Intake, retrieval and routing are real work that none of the five names, so declaring none is a valid answer.
actionAccept a long-running job submission, stamp it with a run id and the idempotency key the checkpoint log will be keyed on, and hand it to the planner.lines 5–7Filled.
The operation, in one line, short enough to read off a drawing. It is prose for whoever opens the card. The agent is instructed by spec, and nothing parses this line.
specAccept the incoming job submission and refuse it outright if its payload is larger than 512 KB, reporting the size you measured. Mint a run id for an accepted submission and copy the submitter's job_id onto it as the idempotency key: the checkpoint log is keyed on that value, so a resubmission carrying a job_id already in flight must return the run already open rather than starting a second one. Emit on job a single record holding the job's stated goal, the references to its payload and the run id you minted, and nothing beyond those three. You are done when that record is emitted, do not begin any of the work the job describes.115 wordslines 8–15Filled.
The instructions handed to the agent when someone runs the graph on their own machine. They must stand on their own, because the agent never sees the rest of the graph. They must not carry what the graph withholds: if the text supplies information no edge brings to this node, the isolation the graph draws exists only on paper. One check reads this field, card/spec-too-thin, and it only measures length.
modelnot namednot writtenLeft empty by this card.
Which model the agent is instantiated with, written the way the provider writes the identifier. A default rather than a binding: a graph's model_stylesheet sets the model for every node matching a shape, an explicit field here outranks the sheet, and whoever runs the blueprint outranks both. Absent on most cards, which means the node takes whatever the graph or the runner supplies.
agentnot namednot writtenLeft empty by this card.
A label the card's author chose for the agent behind the node. Nothing checks it.
skillskills/job-intake.mdline 18Filled.
Where the written procedure for this agent lives, as a path inside the repository you run from. It is only a pointer: no skill document travels in a DarkPrint bundle, and you write the file it names. A node whose spec field holds the whole instruction declares none.
toolsnone requiredline 16Left empty by this card.
tool capability terms from the vocabulary: what the node is permitted to do. This does not say which server supplies the capability; the mcp field answers that. A node can carry either field without the other.
mcpno server is namedline 17Left empty by this card.
The MCP servers the node reaches, under the names they are registered with on the machine that runs the graph. Free text by design: an MCP server is a process somebody installed, and the vocabulary has no term for one.
paramsmax_payload_kb: 512, idempotency_key: job_idlines 19–21Filled.
Nested configuration for the node, free-form but JSON-serializable. It travels with the card to whoever runs the graph; nothing on this site interprets a key of it.
inputsnothing arrives on a declared portline 23Left empty by this card.
The ports data arrives on, each with a name and a data-type term from the vocabulary. Every incoming edge is checked against them: an edge whose source produces nothing this node accepts is reported as bundle/type-mismatch.
outputsjob: jsonlines 24–27Filled.
The ports data leaves on. An output type makes an edge into the next node meaningful. The next node's declared inputs and prohibitions are checked against it.
job: json. The submitted job, its goal, its payload references and the run id assigned here.
dependenciesno upstream node is namedline 28Left empty by this card.
Cards this one expects to hear from, by id. This is the one card field that names topology, so it can point back at a line in the DOT on its own. The DOT still decides what is wired; this field says what the author expected to be wired.
cannotno type is refusedline 29Left empty by this card.
Data types that must never arrive, written as vocabulary term ids. Every incoming edge is checked against every entry, and an edge that can carry that type, or a narrower one, is refused as bundle/prohibition-violated. This is the half of the node's refusals that the checker enforces; will_not is the other half, which nothing checks automatically.
will_notbegin any of the work the job describes, open a second run for a job id already in flightlines 30–32Filled.
What the node promises never to do, in the author's own sentences. Nothing checks an entry here, and nothing can: a promise like "never opens a shell" cannot be read off a graph. It is addressed to whoever reads the card and to the agent instantiated from it, which is why it is a field of its own rather than a second kind of entry inside cannot.
risk_markersnone declaredline 34Left empty by this card.
risk-marker terms the author declares for the node. The static analysis subtracts each distinct marker's weight from the blueprint's static risk-exposure reading, once per blueprint however many nodes carry it. An empty list is a valid answer. Three markers are also read off the graph whether or not a card declares them: unbounded loops, unvalidated external access and criteria leaks.
notesThe run id is minted at intake rather than per stage so a resumed run keeps writing into the same episode log instead of starting a fresh one.28 wordslines 35–37Filled.
The author's commentary on the card, addressed to whoever reads it. Nothing checks it.
version1.0.0line 39Filled.
Semver of the card itself. A published version is never edited in place, so a pinned id@version means the same content forever and a change ships as a new version beside it.
authorautogenline 40Filled.
Who wrote the card. It is excluded from the card's digest, along with provenance. Two cards describing the same node are the same card, whoever typed them.
provenancenot statednot writtenLeft empty by this card.
Where the card came from when it did not start here, such as the blueprint it was forked from or the document behind it. Free text, and excluded from the card's digest.
filled, left empty; both are valid. The skeleton is the card’s fields with what each one is for: open a row to read it. Long values are cut at two lines until the row is opened. This card is pinned by job at topology.dot line 5.
Files
- README.mdwhat this blueprint is, its digest, and how to run itgeneratedSep 11, 2026
- cards/9 pinned cards, one document eachpinnedSep 11, 2026
- topology.dotthe topology, as the author wrote itsourceSep 11, 2026
README.md
Checkpoint & Resume Runner
A staged pipeline that snapshots state after every stage, so a failure at stage 3 resumes from the last good checkpoint instead of restarting the whole job.
blueprint checkpoint-resume-runner
bundle digest sha256:2b3817fc52b73af4a5fe31c3fd0109e1f3bdee7c6c8dd7a1b0a55294e80303b8
nodes 9
cards pinned 9The digest is taken over topology.dot and the digest of every card version pinned in it.
Recompute it to confirm these files are the ones DarkPrint read. One changed byte gives a
different digest.
Run it
This runs on your machine. DarkPrint hands out the files and analyses them statically. It executes nothing and holds none of your provider keys.
This folder carries the topology and its pinned cards, nothing compiled. To compile them into
a pipeline a graph runner takes, run darkprint export <dir> --attractor. It writes Attractor
DOT to stdout, and that file opens with the same two lists this README carries under What
these files leave to the runner. Adapting the result, or building the run yourself from these
files instead, is your own harness's job.
5 of the 9 nodes name the model they run on, in their card's own model field. Read it off
cards/<ref>.yaml; whether your harness honours it is yours to decide.
What is in the folder
topology.dot node ids, edges, and the card version pinned on each node
cards/ the pinned cards, as the registry stores them; each carries the `spec` that becomes its node's prompt
README.md this file9 of the nodes in this bundle name a skill document. There is no skills/ directory above and
there is not meant to be: DarkPrint stores the pointer and reads nothing at the other end of
it. The paths are relative to the repository you run this blueprint from, and writing the
documents is yours to do. Nothing here needs them to run, because every card carries its own
spec inline.
job skills/job-intake.md
plan skills/stage-planner.md
stage1 skills/ingest-stage.md
stage2 skills/transform-stage.md
stage3 skills/assemble-stage.md
checkpoint skills/episodic-memory.md
resume skills/bounded-retry.md
verify skills/acceptance-verifier.md
ship skills/result-delivery.mdWhat these files leave to the runner
Attractor reads more attributes than a DarkPrint blueprint has fields to set. Compile these files into a pipeline, by the command above or by hand, and the names below are the ones nothing in this folder sets. Write them in where your run needs them, and expect a later export of this blueprint to overwrite the whole compiled file. Appendix A of the Attractor spec tabulates most of them; the rest are named by the retry rules in §3.5, by the handler pseudocode in §4, and by §9.7's tool call hooks.
Left out, these fall to the runner and the pipeline still runs. The Attractor spec states a value or a behaviour for each one's absence, in Appendix A or in the handler pseudocode that reads it, so what you get is a choice nobody in this folder made:
- graph:
model_stylesheet,default_max_retries,default_max_retry,default_fidelity,retry_target,fallback_retry_target,stack.child_workdir,tool_hooks.pre,tool_hooks.post - node:
goal_gate,retry_target,fallback_retry_target,fidelity,thread_id,timeout,llm_provider,reasoning_effort,auto_status,allow_partial,join_policy,max_parallel,manager.poll_interval,manager.max_cycles,manager.stop_condition,manager.actions,stack.child_autostart,tool_hooks.pre,tool_hooks.post - edge:
fidelity,thread_id,loop_restart
Left out, these have nothing to fall to. The handler a node's shape selects reads each one directly, and with no value it refuses or goes round again while the rest of the compiled file reads as though the node would run. Read §4's handler section for the shape you are compiling before you leave one of these unset:
- graph:
stack.child_dotfile - node:
human.default_choice
The nodes
| node | card |
|---|---|
job | job-intake@1.0.0 |
plan | stage-planner@1.0.0 |
stage1 | ingest-stage@1.0.0 |
stage2 | transform-stage@1.0.0 |
stage3 | assemble-stage@1.0.0 |
checkpoint | episodic-memory@1.0.0 |
resume | bounded-retry@2.0.0 |
verify | acceptance-verifier@1.0.0 |
ship | result-delivery@1.0.0 |
Exported from https://www.darkprint.io/blueprints/checkpoint-resume-runner
History
each release is a frozen snapshot, addressed by its digest- 1.1.0sha256:2b3817…latest
A staged pipeline that snapshots state after every stage, so a failure at stage 3 resumes from the last good checkpoint instead of restarting the whole job.
autogen · Sep 11, 2026
- 1.0.0sha256:be642a…
A staged pipeline that snapshots state after every stage, so a failure at stage 3 resumes from the last good checkpoint instead of restarting the whole job.
k0bra · Aug 30, 2026
There is no repository behind a release, so there is nothing to pull.
Community notes (0)
No notes yet.
Nobody has posted about this blueprint yet.
Sign in to post a note.