+ #j΃ba0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI H t ^RI Ht^RIHtHt^RIHt^RItRtR tR tR t^R?lt0R@R/RARBllt1RCRDlt2RER/RFRGllt3RHRIlt4] !RJRK44t5]] 3RLRMllt6RNRRORRPRRQRRRRRS]RTRRU]RVRRWR/ RXRYllt7ERt8]'d!RZR[]Pr4t:R\R]lt;R^R_ltRdRelt?RfRglt@RhRiltARjRkltBRlRmltCRnRoltDRpRqltERrRsltFERtG^tHRtRultIRvRwltJRxRyltKRzR{ltLR|^/R}R~lltMRRltNR# ]dRt^RIt^RItELi;i(u _common.py — Shared logic for ComfyUI skill scripts. Single source of truth for: - HTTP transport (with retry/backoff, streaming, timeout handling) - Cloud detection and endpoint mapping (local ComfyUI vs Comfy Cloud) - Workflow node-type catalogs (param patterns, model loaders, output nodes) - API-format validation - Path-traversal-safe file writes - API-key loading from env / CLI Stdlib-only by design (with optional `requests` upgrade if installed). Python 3.10+. ) annotationsN) dataclass)Path)AnyIterator)urlparseTFzhttp://127.0.0.1:8188zhttps://cloud.comfy.orgCOMFY_CLOUD_API_KEYg?g>@set[str] OUTPUT_NODESunetdiffusion_modelsclip text_encoders controlnet control_netzdict[str, list[str]]FOLDER_ALIASESc V^8dQhRRRR/#)folderstrreturnz list[str])formats"a/opt/hermes-venv/lib/python3.14/site-packages/../../../skills/creative/comfyui/scripts/_common.py __annotate__rfs00s0y0c.\PW.4#)z8Return the search order of folder names (primary first).)rget)rs&rfolder_aliases_forrfs   fh //rCheckpointLoaderSimpleCheckpointLoaderzCheckpointLoader (Simple)ImageOnlyCheckpointLoaderunCLIPCheckpointLoader LoraLoaderLoraLoaderModelOnlyLoraLoaderTagsQuery VAELoaderControlNetLoaderDiffControlNetLoaderControlNetLoaderAdvanced CLIPLoaderDualCLIPLoaderTripleCLIPLoaderCLIPVisionLoader UNETLoaderDiffusionModelLoaderUNETLoaderGGUFUpscaleModelLoaderStyleModelLoader GLIGENLoaderHypernetworkLoaderIPAdapterModelLoaderInstantIDModelLoaderADE_LoadAnimateDiffModel ADE_AnimateDiffLoaderWithContextADE_AnimateDiffLoaderGen1PhotoMakerLoaderModelSamplingFluxz dict[str, list[tuple[str, str]]] MODEL_LOADERSzlist[tuple[str, str, str]]PARAM_PATTERNSzc(?:^|[\s,(\[])embedding\s*:\s*([A-Za-z0-9_\-\./\\]+?)(?:\.(?:pt|safetensors|bin))?(?=[\s:,)\(\]]|$)zcloud.comfy.orgc V^8dQhRRRR/#)rhostrrboolr)rs"rrrOsDDDDrca\RV9dTMRV 24pVP;'gRP4oS\9dR#\;QJd#V3Rl\ 4F 'gK R# R#!V3Rl\ 44#)zFTrue if the host points at Comfy Cloud (or staging/preview subdomain).z://zhttp://Tc3F<"TFpSPV4xK R#5iN)endswith).0shostnames& r is_cloud_host..Us!C-Bx  ##-Bs!F)rrHlowerCLOUD_DOMAIN_EXACTanyCLOUD_DOMAIN_SUFFIXES)r?parsedrHs& @r is_cloud_hostrPOsm etmd74&1A BF%%2,,.H%% 3C-BC33C3C3C-BC CCr force_cloudc(V^8dQhRRRRRRRR/#)rbaserpathrQ bool | Nonerr)rs"rrrXs)3 WZrcVPR4pVf \V4MTpVPR4'g RV,pV'd!VPR4'g RV,pW,#)aBuild a URL that adds /api prefix when targeting Comfy Cloud. Local ComfyUI accepts both `/foo` and `/api/foo` for many endpoints. Cloud requires `/api/foo`. `path` should be a path component (e.g. "/prompt") or full path with query (e.g. "/view?filename=x"). /z/api/z/api)rstriprP startswith)rSrTrQclouds&&$ rbuild_cloud_aware_urlr[Xs] ;;s D#.#6M$ KE ??3  Tz T__W--} ;rc V^8dQhRRRR/#)rrTrrr)rs"rrrjsrcVPR4'd-VPR4'gRV\R4R,#VPR4'dRV\R4R,#VR8XdR#V#)zMap a cloud endpoint path to its current canonical form. Handles known renames documented in the Comfy Cloud API: /history -> /history_v2 /models/ -> /experiment/models/ /models -> /experiment/models z/historyz /history_v2Nz/models/z/experiment/models/z/modelsz/experiment/models)rYlen)rTs&rcloud_endpointr_jsn z""4??=+I+ItC O$4555 z""$tC O,<'=== y# Kris_cloudc(V^8dQhRRRRRRRR/#)rrSrrTr`rUrr)rs"rrr{s.@@c@@;@#@rcdVf \V4MTpV'd \V4p\WVR7#)zETop-level URL resolver. Applies cloud rename + /api prefix as needed.)rQ)rPr_r[)rSrTr`rZs&&$ r resolve_urlrc{s-#+#3M$ E d#  ??rc V^8dQhRRRR/#)rexplicitz str | Nonerr)rs"rrrsjZrcV'dTM"\PP\4pVfR#VP 4P R4pT;'gR#)uHLook up API key from CLI flag → env var. Strips whitespace and quotes.Nz'")osenvironr ENV_API_KEYstrip)revals& rresolve_api_keyrlsB(BJJNN;$?C { ))+  E "C ;;$rc\]tRtRt$R]R&R]R&R]R&R]R &RR R lltR R ltRtR#) HTTPResponseiintstatusdict[str, str]headersbytesbodyrurlc V^8dQhRRRR/#)rencodingrrr)rs"rrHTTPResponse.__annotate__s< #e D {{00Wq[75Jw'K"( I JJow7 H{W$w'   s$?B4B44C1 C,+C,,C1c,a]tRtRtRtV3RltRtV;t#) _StripSensitiveOnRedirectSessioniuSession that drops sensitive headers on cross-host redirects. `requests` already strips `Authorization` cross-host (rebuild_auth), but it does NOT strip custom headers like `X-API-Key`. We override `rebuild_auth` to additionally strip every header in `_SENSITIVE_HEADERS` when the destination is a different host — critical when ComfyUI Cloud's `/api/view` redirects to a signed S3 URL. c <\S V`W4VPPpVPp\ V4P ;'gRP 4p\ V4P ;'gRP 4pV'd^V'dTWV8wdLVPp\VP44F pVP 4\9gKWxK" R#R#R#R# \dR#i;i)rBN) super rebuild_authrequestrurrHrKrrlistkeys_SENSITIVE_HEADERS Exception) r~prepared_requestresponseold_urlnew_urlold_hostnew_hostrrkey __class__s &&& rr-_StripSensitiveOnRedirectSession.rebuild_auths G !1 < "**..*..$W-66<<"CCE$W-66<<"CCEX-A.66G#GLLN399;*<< '  4.B8   s0=C5,C5=C5C5AC5'C55 DDr)rrrr__doc__rr __classcell__rs@rrrs   rrcHV^8dQhRRRRRRRRRR R R R R R RRRRRRRRR/ #)rrrrurrrqrrrrrrrrrrr@rrrrrnr)rs"rrr sieieieie'5ieie&ie/:ieBMieie'+ie  ie$ ie  ierc \'EdNRVRVRVRVRV/p VeW;R&MVeWKR&MVfVe W[R &WkR&V 'dR V R &\4;_uu_4p V P!R/V Bp V 'd~V ezV PP R R R 7V P R 4;_uu_4pV P \4FpV'gK VPV4K RRR4RpM V Pp\V PV PP4UUu/uF wppVVbK uppVV PR7uuRRR4#Ve9\.P0!V4P3R4pVP5RR4MTp\6PP9VVW R7p!RR\6PP:4p\=V4P>;'gRPA4p\6PPCV!VV44pVP VVR7pTPQ4pTPRp\KTP4pT 'dT eT PP R R R 7T P R 4;_uu_4pTPM\4pT'gMTPT4K2RRR4\TTRTR7#\TTTPM4TR7# +'giEL?;iuuppi \P P"dZp\%T\P P&4'd\)\+T44Th\-\+T44ThRp?ii;i +'giELj;i \6PDPFdnp\TPHTP'd\KTP4M/TPM4;'gR\OTRT4R7uRp?#Rp?ii;i +'giELu;i)zOne HTTP attempt. No retry.rrurrrallow_redirectsNrrrTr)parentsexist_okwbr)rprrrtrurz Content-Typezapplication/json)rrrrc4a]tRtRtRRltV3RltRtV;t#)$_http_once.._RedirectHandleriFc V^8dQhRRRR/#)r original_hostrfollowr@r)rs"rr1_http_once.._RedirectHandler.__annotate__Gs ! !# !t !rc WnW nR#rD)rr)r~rrs&&&r__init__-_http_once.._RedirectHandler.__init__Gs !.  Krc <VP'gR#\V4P;'gRP4pWpP8wd^VP 4UU u/uFwrVP4R9gKWbK p pp \ PPWjRR7p V #\S V`)WW4WV4#uup pi)NrBGET)rrr>cookie authorization x-api-key) rrrHrKr header_itemsurllibrRequestrredirect_request) r~req2fpcodemsghdrsnewurlrkv clean_headersnew_reqrs &&&&&&& rr5_http_once.._RedirectHandler.redirect_requestKs;;; (1177R>>@H---&*%6%6%8!%8TQwwy(PPAD%8!!..00W\0]7+DdN N !s &CC)rr)rrrrrrrrrs@r_RedirectHandlerrFs ! O OrrrB)rr)*rrrparentmkdiropen iter_contentDOWNLOAD_CHUNK_SIZEwritecontentrn status_coderritemsrurequests exceptionsRequestException isinstanceTimeoutrrrrdumpsencoderrrHTTPRedirectHandlerrrHrK build_openererror HTTPErrorrrreadgetattrgeturlrp)rrurrrrrrrrrrkwargsrGrfchunkrtrrr body_bytesreqrropenerr final_url final_status final_headerss$$$$$$$$$$$ rrr s| feS)W w 13C"   &6N  !6N  $"2#7O!6N #F8 . / /1 5II''d.KK%%dT%B4A%&^^4G%HE$u !&I)D99D#==./iioo.?@.?daQT.?@ 0 /4ZZ *11': >+=> .. :w VC O6>>==O&c]++11r88:M ^^ ( ()9-IY)Z [F {{3{0 I;;L&M $" $6 YYt__ "56  <SV_`` |]Zc dd[)A&&77 5a!4!4!API format = top-level dict where each value has `class_type`.Fnodeslinks class_typeT)rrvalues)rrs& r is_api_formatr#sQ h % %(w(2 __  a  <1#4 rc V^8dQhRRRR/#)rpayloadrrrr)rs"rrrsSTrcD\V\4'd\V4'dV#\V\4'd)RV9d"\VR,4'd VR,#\V\4'dRV9dRV9d \R4h\R4h)zQUnwrap common wrapper variants. Returns API-format workflow or raises ValueError.promptrr uWorkflow is in editor format (has top-level 'nodes' and 'links' arrays). Re-export from ComfyUI using 'Workflow → Export (API)' (newer UI) or 'Save (API Format)' (older UI).zSWorkflow is not in API format. Each top-level entry must have a 'class_type' field.)rrr# ValueError)r%s&runwrap_workflowr)s'4  ]7%;%;'4  X%8]7S[K\=]=]x  '4  W%7Gw.avi.gif.mkv.movrO.webm.webp>.m4a.mp3.ogg.wav.flac>.glb.obj.ply.gltf>.md.txt.json)rsuffixrK)rMexts& rmedia_type_from_filenamerhsM x.   % % 'C HH 77 // && rc V^8dQhRRRR/#)rrrrr@r)rs"rrrsrc\V4FIwrVR,\9dR#VR,P4PR4'gKHR# R#)z1Used to bump default timeout for video workflows.r!TF) animatediffade_wanvideo hunyuanvideoltxvideocogvideo)r3SLOW_OUTPUT_NODESrKrY)r_r2s& rlooks_like_video_workflowrssLh'  !2 2   # # % 0 01| } } ( rc V^8dQhRRRR/#)rr+rrror)rs"rrrs  s s rc>Vf \P!\\4#\ V\ 4'd5VP 4R8Xd \P!\\4#VR8Xd \P!\\4#\V4#)zConvert -1 or None to a fresh random seed; otherwise return int(value). Accepts numeric -1 OR string "-1" (both treated as "randomize"). Other parse failures raise TypeError/ValueError for the caller to surface. z-1)rrandintSEED_MINSEED_MAXrrrjror-s&r coerce_seedrzsg  }~~h11%%++-4"7~~h11 {~~h11 u:rc V^8dQhRRRR/#)rr%rrr r)rs"rrrschrc\V\4'g \4#\4pVFp\V\4'dVP V4K,\V\ 4'gKDVP R4;'g+VP R4;'gVP R4p\V\4'gKVP V4K V#)zNormalize model-list responses from local ComfyUI vs Comfy Cloud. Local: `["a.safetensors", "b.safetensors"]` Cloud: `[{"name": "a.safetensors", "pathIndex": 0}, ...]` namerMrT)rrsetraddrr)r%outitemr}s& rparse_model_listrs gt $ $u EC dC GGDM d # #88F#OOtxx ';OOtxx?OD$$$  JrcV^8dQhRR/#)rrrr)rs"rrr3ssrc>\\P!44#rD)ruuiduuid4rrr new_client_idr3s tzz| rc V^8dQhRRRR/#)rdrrrr)rs"rrr7s88d8s8rcNRPRVP444#)zPretty key=value for log lines. c36"TFwrV RV: 2xK R#5i)=Nr)rFrrs& rrIfmt_kv..9s7YTQqc1%LYs)joinr)rs&rfmt_kvr7s 887QWWY7 77rindentc$V^8dQhRRRRRR/#)robjrrrorrr)rs"rrr<s!773737t7rcP\\P!W\R74R#)zKPrint JSON to stdout. Centralised so behavior can be tweaked (e.g., --raw).)rdefaultN)printrrr)rrs&$r emit_jsonr<s $**S 56rc V^8dQhRRRR/#)rrrrrr)rs"rrrAs55S5T5rcB\RV 2\PR7R#)z?stderr log with consistent prefix (so JSON stdout stays clean).z[comfyui-skill] )fileN)rsysstderr)rs&rlogrAs SE "4r>  i> SaveAudio SaveVideoCogVideoSamplerLTXVideoSamplerSaveAnimatedPNGWanVideoSamplerSaveAnimatedWEBPVHS_VideoCombineHunyuanVideoSamplerSaveAnimateDiffVideoSVD_img2vid_Conditioning>Save3DSaveGLB ImageSaver SaveImager SaveLatent PreviewAudio PreviewImage PreviewVideorrr Image Saveeasy imageSaveShowText|pysssssPreviewImage|pysssssImage Save With Metadata) ckpt_name checkpoints) lora_nameloras)vae_namevae)control_net_namer) clip_namer  clip_name1r  clip_name2r )rr) clip_name3r )r clip_vision) unet_namer ) model_namer )rupscale_models)style_model_name style_models) gligen_namegligen)hypernetwork_name hypernetworks)ipadapter_file ipadapter)instantid_file instantid)ranimatediff_models)photomaker_model_name photomaker)CLIPTextEncoderr')CLIPTextEncodeSDXLtext_gr')rtext_lprompt_l)CLIPTextEncodeSDXLRefinerrrefiner_prompt)CLIPTextEncodeFluxclip_lr)rt5xxlr')rguidancer)zsmZ CLIPTextEncoderr')BNK_CLIPTextEncodeAdvancedrr')KSamplerseedr)rstepsr)rcfgr)r sampler_namer)r schedulerr)rdenoiser)KSamplerAdvanced noise_seedr)rrr)rrr)rrr)rrr)r start_at_stepr)r end_at_stepr) RandomNoiserr)BasicSchedulerrr)rrr)rrr)KSamplerSelectrr) CFGGuiderrr) DualCFGGuider cfg_condsr)rcfg_cond2_negative cfg_negative)r; max_shiftr)r; base_shiftr)r;width model_width)r;height model_height)ModelSamplingSD3shiftr)ModelSamplingDiscretesamplingr)SDTurboSchedulerrr)rrr) SamplerCustomrr)rrr)EmptyLatentImagerr)rrr)r batch_sizer)EmptySD3LatentImagerr)r rr)r rr)EmptyHunyuanLatentVideorr)r rr)r lengthr )r rr)EmptyMochiLatentVideorr)r rr)r r r )EmptyLTXVLatentVideorr)r rr)r r r ) LatentUpscaler upscale_width)rrupscale_height)LatentUpscaleByscale_byr) ImageScalerr)rrr) LoadImagerSrS) LoadImageMaskrS mask_image)LoadImageOutputrSrS) VHS_LoadVideorPrP) VHS_LoadAudiorQrQ)rrr)r rr)r!rr)r&rr)r.rr)r/rdiffusion_model_name)r1rupscale_model_name)r*rr)r+rr)r+rr)r'rcontrolnet_name)r#rr)r#strength_model lora_strength)r# strength_cliplora_strength_clip)r$rr)r$rr)ControlNetApplystrengthcontrolnet_strength)ControlNetApplyAdvancedr"r#)r$ start_percentcontrolnet_start)r$ end_percentcontrolnet_end)IPAdapterAdvancedweightipadapter_weight)r)start_atipadapter_start)r)end_at ipadapter_end) IPAdapterr*r+)ImageUpscaleWithModelupscale_methodr2)r8 motion_scaler3)r9r3r3)r frame_rater4)rr video_format)rfilename_prefixr6)rr6r6)rrr)rrr)rrr)rrr)rrr)rrr) LTXVSchedulerrr)r7rr)zSeed (rgthree)rr)zImage Comparer (rgthree)image_arS)zPower Lora Loader (rgthree)PowerLoraLoaderHeaderWidget _lora_header) PrimitiveNoder+primitive_value)z easy seedrr)z easy positivepositiver')z easy negativenegativenegative_prompt)easy fullLoaderrr)r@rr)r@rr)r@r=r')r@r>r?>rrrrrr>r=)z .comfy.org)rrrl)O__conditional_annotations__r __future__rrrgrrerrr dataclassesrpathlibrtypingrr urllib.parserrr ImportError urllib.errorrurllib.requestDEFAULT_LOCAL_HOSTDEFAULT_CLOUD_HOSTriDEFAULT_HTTP_TIMEOUTDEFAULT_RETRIESRETRY_BASE_DELAYRETRY_MAX_DELAYrrrqr rrrr<r=r=compile IGNORECASEr>rNrLrPr[r_rcrlrnrrrSessionrrrrr#r)r.r3r:rBrKrhrsryrxrzrrrrr)rAs@rrTs  # ! !L-.# = h2 V' (+V4 V_ %ov.</ ($0.3!= >.3!= >.3 ">!? .3  ">!? .3 != > .3!7 8.3!7 8.3!7 8.3!4 5.3!C D.3!C D.3 !C D!.3$!6 7%.3&!79O P'.3( h).3*!= >+.3.!6 7/.30!C D!6 7!A B!E F!: ;!G H !@ A!@ A!E F&)M(N"F!G!H I[.3 /.hU.(U./U.1 U. < U. 1 U..U.3U.-U.5U.!U.#U.U. 1!U."+#U.$'%U.&/'U.(+)U.*'+U.,9-U..3/U.0;1U.273U.8*9U.:);U.<1=U.>-?U.@7AU.D EU.F*GU.H8+;+;6ieX./ & & *""    (.8 77 5ALsLL.-L.