Error codes
Generated from src/errors.ts. Meanings below are the source comments.
| Code | Meaning |
|---|---|
E_UNKNOWN_NODE_TYPE | Node class not present in the provided defs. |
E_MISSING_INPUT | Required input (connection or widget) has no value and no default. |
E_TYPE_MISMATCH | Connected output type does not match the input's declared type. |
E_BAD_COMBO | Combo param value is not one of the allowed options. |
E_RANGE | Numeric param out of the declared [min, max] range. |
E_UNKNOWN_INPUT | Param references an input the node def does not declare. |
E_INVALID_INPUT | Input key conflicts with the def (e.g. a widget name used as a connection). |
E_CYCLE | Graph contains a cycle. |
E_MUTED_CONSUMED | A muted node is still referenced by a consumer. |
E_UNRESOLVED_BYPASS | A bypassed node's pass-through could not be resolved unambiguously. |
E_INVALID_GRAPH | Structural graph problem: dangling ref, out-of-range slot, malformed IR. |
E_INVALID_PARAM | Param value present but not a valid value for its declared kind. |
E_UNBOUND_PARAM | A template placeholder was never bound before compilation. |
E_UNBOUND_PORT | A template input port was never bound before compilation. |
E_ASSET_UNSTAGED | An AssetRef reached compilation without being staged by a runtime. |
E_ASSET_STAGE_FAILED | Asset upload to the server failed. |
E_SUBMIT_FAILED | HTTP submit failed (network, 4xx/5xx). |
E_NODE_EXECUTION_ERROR | ComfyUI reported a node-level execution error. |
E_TIMEOUT | Run did not complete within the configured timeout. |
E_CONNECTION_FAILED | Transport-level failure talking to the Comfy instance. |
E_UNSUPPORTED_FEATURE | Imported workflow uses a construct the importer cannot represent yet. |
E_NODE_PACK_AMBIGUOUS | Multiple verified registry packs provide the same node class. |
E_NODE_PACK_UNKNOWN | No verified registered pack could be identified for a node class. |
E_INVALID_NODE_PACK | Node-pack metadata in the manifest is invalid. |
E_NODE_PACK_VERSION_UNSATISFIED | Declared version range matches no active Registry version. |
E_COMFY_PYTHON_UNKNOWN | Target Comfy Python interpreter could not be established. |
E_SETUP_DECLINED | User declined the setup plan (or non-interactive without --yes). |
E_SETUP_NOT_APPLICABLE | Setup cannot be applied (remote URL, missing Comfy path, missing installer). |
E_SETUP_FAILED | Official installer returned a failure. |
E_AGENT_SKILL_MISSING | Bundled skill is missing from the installed package. |
E_AGENT_SKILL_MODIFIED | Project skill copy has local edits; --force required to overwrite. |
CLI envelope codes (not in ErrorCodes)
| Code | Meaning |
|---|---|
E_LOCK_DRIFT | Lockfile/defs hash mismatch. Warning. |
E_LIVE_DEFS_UNAVAILABLE | /object_info fetch failed; bundled defs used. Warning. |
E_UNCAUGHT | Non-ComfyError crash |
E_PACK_LOCAL_PATH | Pack validation: machine-local path in IR (see cwf pack) |
Remediation (common)
| Code | Typical fix |
|---|---|
E_UNKNOWN_NODE_TYPE | Snapshot the Comfy that has the class; codegen; or rawNode |
E_TYPE_MISMATCH | Wire the right handle; unsafe only if the node lies |
E_UNBOUND_PARAM / E_UNBOUND_PORT | Pass bindings or defaults |
E_UNRESOLVED_BYPASS | g.setBypassMap |
E_MUTED_CONSUMED | Unmute or disconnect |
E_NODE_PACK_AMBIGUOUS | cwf node-pack add / pick a provider |
E_NODE_PACK_UNKNOWN | Manual map, or the class is core/unregistered |
E_NODE_PACK_VERSION_UNSATISFIED | Relax the range or publish that version |
E_COMFY_PYTHON_UNKNOWN | Pass --comfy at the tree that has Python |
E_SETUP_DECLINED | Answer y or pass --yes |
E_SETUP_NOT_APPLICABLE | Local --comfy required to apply |