+ Vi'sRt^RIHtHtHtHt^RIHtHtRRlt RRlt RRlt R t RR R llt R RltR RRlltRRltRRRlltRRltRRltRRltRRltRRltR #)!z3 Shared validation functions for Firecrawl v2 API. )OptionalDictAnyList) ScrapeOptions ScrapeFormatsc0V^8dQhR\R\/#) format_strreturn)str)formats"\/home/ubuntu/hermes-agent/venv/lib/python3.14/site-packages/firecrawl/v2/utils/validation.py __annotate__r s66s6s6c4RRRRRR/pVPW4#)z Convert format string from snake_case to camelCase. Args: format_str: Format string in snake_case Returns: Format string in camelCase raw_htmlrawHtmlchange_trackingchangeTrackingscreenshot_full_pagezscreenshot@fullPage)get)r format_mappings& r_convert_format_stringr s/ I+ 5N   j 55rc0V^8dQhR\R\/#r schemar r)r s"rrrsO$O$O$O$rc~aaV'd\V\4'gV#\4oRVV3RlloS!V4#)z Normalize a schema for OpenAI compatibility by handling recursive references. Args: schema: Schema to normalize Returns: Normalized schema c0V^8dQhR\R\/#r objr r)r s"rr1normalize_schema_for_openai..__annotate__*s>>c>c>rcn<\V\4'g1\V\4'dVUu.uF pS !V4NK up#V#\V4pVS 9dV#S P V4\V4pRV9dS P V4V#RV9dVP R4p/pVP4F2wrg\V\4'dRV9d S !V4WV&K.WuV&K4 /pVP4FwrgS !V4W&K /VCRV/Cp S P V4V #VPR4R8Xd RV9dVPR4RJdVRVPR4R8XdRV9d}RV9dv\VR,\4'dV\VR,\4'd9VR,U u.uFp WR,9gKV NK p p V 'dWR&MVRMVR\VP44Fxwrg\V\4'dRV9d S !V4W6&K.\V\4'gKFVUu.uF#p\V\4'd S !V4MTNK% upW6&Kz S P V4V#uupiuup iuupi)$ref$defstypeobject propertiesadditionalPropertiesTrequired) isinstancedictlistidadddiscardpopitemsr)r!itemobj_id normalizeddefsprocessed_restkeyvaluenormalized_defsresultfieldvalid_requirednormalize_objectvisiteds& rr>5normalize_schema_for_openai..normalize_object*s#t$$#t$$;>?34(.3??JC W J F#Y  Z  OOF #  j >>'*DN(..0 eT**vU/B*:5*AN'*/3' 1 !O"jjl '7'>$+BAAF OOF #M NN6 "h . J & NN1 2d :12 NN6 "h . * $ J &:j1488:l3T::5? 5K"E5KE"'l+C"C#(%5K"E!-;z*":.z*z//12JC%&&6+>"25"9 E4((jo"pjobfZd=S=S#3D#9Y]#]jo"p  3 w@V"E#qsJ(J-$J-#)J2r+r,set)rr>r?s&@@rnormalize_schema_for_openairCs8 FD11 eG>>@ F ##rc0V^8dQhR\R\/#rrbool)r s"rrrms2-2-s2-t2-rcaaV'd\V\4'gR#\4oRVV3RlloS!V4'*#)z Validate schema for OpenAI compatibility. Args: schema: Schema to validate Returns: True if schema is valid, False otherwise Tc0V^8dQhR\R\/#r rE)r s"rr0validate_schema_for_openai..__annotate__|s!!3!4!rc<\V\4'gR#\V4pVS9dR#SPV4RV9dSP V4R#VP R4R8Xd7RV9d0RV9d)VP R4RJdSP V4R#VP 4Fp\V\4'd,RV9d%S!V4'dSP V4R#KD\V\4'gK\VFGp\V\4'gKRV9gK$S!V4'gK4SP V4R# K SP V4R#)Fr$r&r'r(patternPropertiesr)T)r+r,r.r/r0rvaluesr-)r!r4r9r3has_invalid_structurer?s& rrM9validate_schema_for_openai..has_invalid_structure|s%#t$$C W  F S= OOF # GGFOx '  # s * GG* +t 3 OOF #ZZ\E%&&6+>(//OOF+0E4((!D!$--&2D066#OOF3#' " " rrA)rrMr?s&@@rvalidate_schema_for_openairOms9 FD11eG!!F%V, ,,raSchema contains invalid structure for OpenAI: object type with no 'properties' defined but 'additionalProperties: true' (schema-less dictionary not supported by OpenAI). Please define specific properties for your object. Note: Recursive schemas using '$ref' are supported.Nc V^8dQhR\R\R\\\3,R\\,R\ /#)r r!target_def_namer6r?r )rr rrrBrF)r s"rrrs?000s0$sCx.0[cdg[h0tx0rcV'd\V\\34'gR#Vf \4p^RIpVP VR\ R7pWS9dR#VPV4\V\4'dRV9d\VR,\ 4'dVR,PR4p\V4^8djV^,R8Xd\V^,R8XdNVR ,pWq8XdVPV4R#Wr9d%\W',WV4VPV4#VP4F)p\WW#4'gKVPV4R# ME\V\4'd0VF)p \WW#4'gKVPV4R# VPV4R# TPT4i;i) aU Check if an object contains a recursive reference to a specific definition. Args: obj: Object to check target_def_name: Name of the definition to check for recursion defs: Dictionary of definitions visited: Set of visited object keys to detect cycles Returns: True if recursive reference is found, False otherwise FNT) sort_keysdefaultr$/#r%) r+r,r-rBjsondumpsr r/splitlenr0_contains_recursive_refrL) r!rQr6r?rXobj_keyref_pathdef_namer9r3s &&&& rr\r\s jtTl33%jjcj:G KK! c4 }CK!=!=v;,,S1x=A%(1+*<!PWAW'|H2#   '6t~^ef  *54QQ  &T " "*4$PP      s1+B G G 6"G G 1-G #G 7G GcRV^8dQhR\\\3,R\/#)r r6r )rr rrF)r s"rrrs"4S>drcvV'gR#VP4Fwr\W!V4'gKR# R#)z Check if $defs contain circular references. Args: defs: Dictionary of definitions to check Returns: True if circular references are found, False otherwise FT)r2r\)r6r_ def_values& r_check_for_circular_defsrcs2 #zz| "9 = = , rc V^8dQhR\R\\\3,R\\,R\ R\/#)r r!r6r?depthr )rrr rrBint)r s"rrrs=00c0c3h0(3-0WZ0cf0rc V'd$\V\\34'dV^ 8dV#Vf \4p\ V4pWB9dV#VP V4\V\4'Ed RV9d\VR,\ 4'dVR,PR4p\V4^8d`V^,R8XdRV^,R8XdDVR,pWa9d5\\W,4WV^,4VPV4#VVPV4#/pVP4F#wrVR8XdK\WW#^,4Wx&K% VVPV4#\V\4'd5VU u.uFp \WW#^,4NK up VPV4#VPV4V#uup i TPT4i;i)a$ Resolve $ref references in a JSON schema object. Args: obj: Object to resolve references in defs: Dictionary of definitions visited: Set to track visited objects and prevent infinite recursion depth: Current recursion depth Returns: Object with resolved references r$rUrVr%rW) r+r,r-rBr.r/r rZr[ resolve_refsr0r2) r!r6r?rer4r^r_resolvedr8r9r3s &&&& rrhrhs jtTl33urz % WF   KK c4 }CK!=!=v;,,S1x=A%(1+*<!PWAW'|H'+D,@$QVYZQZ[  H!iik '> ,U'19 M *  T " "MPQSTLWai@SQ  #  J R s1!B0G%#G%6:G%G%G 8G% G%%G8c0V^8dQhR\R\/#rrE)r s"rrr#s  C D rc(V'd\V\4'gR#^RIpVPV4pRV9;'gRV9;'gRV9p\ VP R4;'gVP R44pT;'gT#)z Detect if a schema contains recursive references. Args: schema: Schema to analyze Returns: True if schema has recursive patterns, False otherwise FN"$ref"#/$defs/z#/definitions/r% definitions)r+r,rXrYrFr)rrX schema_stringhas_refshas_defss& rdetect_recursive_schemarr#s FD11JJv&MM! * *m# * *M) FJJw'DD6::m+DEH   xrcRV^8dQhR\R\\\3,/#rrrr )r s"rrr<s&CCCC4S>CrcXV'gRRRR/#\V4'dRRRR/#RRRR/#)z Select appropriate model based on schema complexity. Args: schema: Schema to analyze Returns: Dict with modelName and reason modelNamez gpt-4o-minireason no_schemazgpt-4orecursive_schema_detected simple_schema)rr)rs&rselect_model_for_schemar{<s@ ]HkBBv&&Xx1LMM / BBrchV^8dQhR\R\\\\3,,/#r)rrrr )r s"rrrOs'88c8htCH~&>8rcJ\VR4'd,\VP4'dVP4#\VR4'dn\VP4'dS\ VP RR4p\V4'dVP P4#VP4#\VR4'd,\VP 4'dVP 4#\VR4'dn\VP4'dS\ VP RR4p\V4'dVP P 4#VP4#\T\4'dT#R# \dL'i;i)z} Normalize a schema object which may be a dict, Pydantic BaseModel subclass, or a Pydantic model instance into a plain dict. model_json_schema model_dumpNrr,) hasattrcallabler~rgetattr __class__rr, Exceptionr+)rmjsschs& r_normalize_schemarOs@  6. / /HV=U=U4V4V++- - 6< ( (Xf6G6G-H-H&**,?FC}}''99;;$$& & 68 $ $&--)@)@==? " 66 " "x '<'<&**Hd;C}}''..00;;=  --6747    s0i;i \dLOi;i) z Validate and prepare json format object. Args: format_obj: Format object that should be json type Returns: Validated json format dict Raises: ValueError: If json format is missing required fields Hjson format must be an object with 'type', 'prompt', and 'schema' fieldsr&rXz!json format must have type='json'rNr%rlrm) r+r, ValueErrorrrrXrYrhrrCrOOPENAI_SCHEMA_ERROR_MESSAGE) rrr5normalized_schemar6rXro has_any_refsresolved_schemaresolved_stringhas_remaining_refsopenai_normalized_schemas & r_validate_json_formatrps j$ ' 'cdd~~f'<==^^H %Fj!J -f5  (+T22(,,Wb9 $ +< = %))'200 -00-/   *67H*O*.**_*E-5-H-i-iJZiLi*10?-)*;TBBwRcGc$5g$>,89J,Q)%&7>>7N_C_ 1' : (CCT'U $-.FGG !<==#;x %%%s0%'F F"F?+F, F)(F), F:9F:cRV^8dQhR\R\\\3,/#rrt)r s"rrrs"stCH~rc\V\4'g \R4h\VPR4\4'dVR,P 4'g \R4hV#)z Validate and prepare query format object. Args: format_obj: Format object that should be query type Returns: Validated query format dict Raises: ValueError: If query format is missing required 'prompt' field >query format must be an object with 'type' and 'prompt' fieldspromptz1query format requires a non-empty 'prompt' string)r+r,rrr strip)rs&r_validate_query_formatrsX j$ ' 'YZZ jnnX. 4 4Jx.>.@.H.HD M*i/1!$+7It#D . >>'///#3#;#;C)#s33#&&=*45+A%A#&'>*45u*v$v 1 8 89OPS9T U!+C!6!6VYV]V]^dVeVe+A#''&/+Rko#+v#55JKbcKbSY[aKb5cN$5$<$<^$L%-%8$5$<$<=STW=X$Y%-%=1NC1N1NJ'2j'@AKP[A\ :(>)3 )CB'.r<'@'@AC\`Aa :(>$5$<$6M6M#f+F $5$<$'777)001AB 0$77/%c3//"f}&01{&| |"g~&01q&r r-445KC5PQ'T22RURYRYZ`RaRa'=cggfo'NgkH'611FG^#G^vW]G^1_ 1 8 8 H!)W!4 1 8 89OPS9T U!)\!9-J-JV\-J #.*#<=G^^K=XJz$:%/^^J%?#*2|#<#<=?]]X\]=]Jz$: 1 8 8 D#)S=2:2I2Ic&kCK 1 8 8 =$S&11"xx61 1 8 89Ns~~O_9` a!$\!9.4l-C #*3 T#B#N=@]]Jz$:#*3 4#@#LahikmyazazR]]X\]=]ACJz$: 1 8 8 D!$W!4 1 8 89OPSP^P^lpP^Pq9r s 1 8 89OPSPXPX9Y Z-44S9Y 0^#(C-44S9$) %-> *% !$&!#F!&$//+-(8> 4J )[8?K 0 .>D.>.QK + !eT**f %uyy=Z^A_'`$L  %wungeUbdhFi'j$L*6 I&$)C w+z G%s=h== i  i )N)N)__doc__typingrrrrtypesrrrrCrOrr\rcrhrrr{rrrrrrrrsk-,06$O$d2-lm0f(0f 2C&8BCL,6zr