Import round-trip

Source forms

Format	Detect	Notes
Editor / save ("version": 0.4)	nodes array + links	links table, positional widgets_values
Workflow v1	nodes array, version >= 1	named widget maps supported
API / prompt JSON	id → {class_type, inputs}	connections already {id, slot}

Detection is automatic. cwf compile, cwf validate, and cwf run also accept these files directly and import on the fly.

What is preserved

• Node ids verbatim, so Comfy-side errors map back
• Titles and modes (0 active, 2 muted, 4 bypassed)
• Slot identity as output index
• Integers beyond 2^53
• Unknown custom nodes as raw nodes, original JSON on node.source
• Metadata the importer did not understand, same node.source bag

What is normalized

• Reroute chains are traced through
• PrimitiveNode values are inlined into the widgets they feed
• Widget decode of positional widgets_values needs defs (--from or a live --url). Without defs, unknown nodes still round-trip as raw.

What this SDK does not do

It does not export Graph IR back to editor-format JSON yet. That is on the roadmap. Compile emits API JSON, which is the execution form, not a canvas restore file.

Bypass

Imported bypassed nodes do not get a guessed bypassMap. Compile fails with E_UNRESOLVED_BYPASS until you set one. That is deliberate. Bypass and mute.