Skip to content

Error codes ​

Generated from src/errors.ts. Meanings below are the source comments.

CodeMeaning
E_UNKNOWN_NODE_TYPENode class not present in the provided defs.
E_MISSING_INPUTRequired input (connection or widget) has no value and no default.
E_TYPE_MISMATCHConnected output type does not match the input's declared type.
E_BAD_COMBOCombo param value is not one of the allowed options.
E_RANGENumeric param out of the declared [min, max] range.
E_UNKNOWN_INPUTParam references an input the node def does not declare.
E_INVALID_INPUTInput key conflicts with the def (e.g. a widget name used as a connection).
E_CYCLEGraph contains a cycle.
E_MUTED_CONSUMEDA muted node is still referenced by a consumer.
E_UNRESOLVED_BYPASSA bypassed node's pass-through could not be resolved unambiguously.
E_INVALID_GRAPHStructural graph problem: dangling ref, out-of-range slot, malformed IR.
E_INVALID_PARAMParam value present but not a valid value for its declared kind.
E_UNBOUND_PARAMA template placeholder was never bound before compilation.
E_UNBOUND_PORTA template input port was never bound before compilation.
E_ASSET_UNSTAGEDAn AssetRef reached compilation without being staged by a runtime.
E_ASSET_STAGE_FAILEDAsset upload to the server failed.
E_SUBMIT_FAILEDHTTP submit failed (network, 4xx/5xx).
E_NODE_EXECUTION_ERRORComfyUI reported a node-level execution error.
E_TIMEOUTRun did not complete within the configured timeout.
E_CONNECTION_FAILEDTransport-level failure talking to the Comfy instance.
E_UNSUPPORTED_FEATUREImported workflow uses a construct the importer cannot represent yet.
E_REMOVED_COMMANDCLI command that used to exist (setup / resolve-nodes / node-pack).
E_AGENT_SKILL_MISSINGBundled skill is missing from the installed package.
E_AGENT_SKILL_MODIFIEDProject skill copy has local edits; --force required to overwrite.

CLI envelope codes (not in ErrorCodes) ​

CodeMeaning
E_LOCK_DRIFTLockfile/defs hash mismatch. Warning.
E_LIVE_DEFS_UNAVAILABLE/object_info fetch failed; bundled defs used. Warning.
E_UNCAUGHTNon-ComfyError crash
E_PACK_LOCAL_PATHPack validation: machine-local path in IR (see cwf pack)

Remediation (common) ​

CodeTypical fix
E_UNKNOWN_NODE_TYPESnapshot the Comfy that has the class; codegen; or rawNode
E_TYPE_MISMATCHWire the right handle; unsafe only if the node lies
E_UNBOUND_PARAM / E_UNBOUND_PORTPass bindings or defaults
E_UNRESOLVED_BYPASSg.setBypassMap
E_MUTED_CONSUMEDUnmute or disconnect
E_REMOVED_COMMANDcwf setup / resolve-nodes / node-pack were removed. Use comfy node install <id>

Debugging

Released under the MIT License. Unofficial project. Not affiliated with or endorsed by Comfy Org.