o iy@sddlmZddlmZddlmZmZmZmZddl m Z ddl m Z m Z mZddlmZmZddlZddlmZed ed ZGd d d ed dZdddZGdddeZGdddeZdS)) annotations)Sequence) AnnotatedAny TypedDictcast)Icon)BeforeValidatorField PrivateAttr)SelfTypeVarN)FastMCPBaseModelTdefaultc@seZdZUded<dS) FastMCPMetaz list[str]tagsN)__name__ __module__ __qualname____annotations__rrb/var/www/html/karishye-ai-python/venv/lib/python3.10/site-packages/fastmcp/utilities/components.pyrs rF)total maybe_setset[T] | Sequence[T] | Nonereturnset[T]cCs$|durtSt|tr|St|S)z@Convert a sequence to a set, defaulting to an empty set if None.N)set isinstance)rrrr_convert_set_default_nones  r!cs(eZdZUdZeddZded<edddZd ed <edd dZd ed <edd dZ ded<ee ddZ ded<edddZ ded<edddZ ded<eZd ed<ddd=fd"d#Zed>d$d%Z d?d@d(d)Zdd*dd+dAfd/d0ZdBd3d4Zd>d5d6ZdCd7d8ZdCd9d:ZdDd;d<ZZS)EFastMCPComponentzIBase class for FastMCP tools, prompts, resources, and resource templates.zThe name of the component.) descriptionstrnameNz0The title of the component for display purposes.)rr# str | Nonetitlez!The description of the component.r#zHOptional list of icons for this component to display in user interfaces.zlist[Icon] | NoneiconszTags for the component.)default_factoryr#z?Annotated[set[str], BeforeValidator(_convert_set_default_none)]rz$Meta information about the componentdict[str, Any] | NonemetaTz!Whether the component is enabled.boolenabled_key)keyr/kwargsrrNonec tjdi|||_dSNr)super__init__r.)selfr/r0 __class__rrr5= zFastMCPComponent.__init__cCs |jp|jS)a* The key of the component. This is used for internal bookkeeping and may reflect e.g. prefixes or other identifiers. You should not depend on keys having a certain value, as the same tool loaded from different hierarchies of servers may have different keys. )r.r%r6rrrr/As zFastMCPComponent.keyinclude_fastmcp_meta bool | NonecCsT|durtjj}|jp i}|r&tt|jd}|d}r"||B}||d<|p)dS)z Get the meta information about the component. If include_fastmcp_meta is True, a `_fastmcp` key will be added to the meta, containing a `tags` field with the tags of the component. N)r_fastmcp)fastmcpsettingsr;r+rsortedrget)r6r;r+ fastmcp_meta upstream_metarrrget_metaKs  zFastMCPComponent.get_metaF)updatedeepr/rErFr cs(tj||d}|dur||_tt|S)z Create a copy of the component. Args: update: A dictionary of fields to update. deep: Whether to deep copy the component. key: The key to use for the copy. )rErFN)r4 model_copyr.rr )r6rErFr/copyr7rrrGcs zFastMCPComponent.model_copyotherobjectcCs6t|t|ur dSt|t|sdS||kS)NF)typer model_dump)r6rIrrr__eq__zs zFastMCPComponent.__eq__c Cs6|jjd|jd|jd|jd|jd|jd S)Nz(name=z, title=z, description=z, tags=z , enabled=))r8rr%r'r#rr-r:rrr__repr__s6zFastMCPComponent.__repr__cC d|_dS)Enable the component.TNr-r:rrrenable zFastMCPComponent.enablecCrP)Disable the component.FNrRr:rrrdisablerTzFastMCPComponent.disablecCs|S)zCreate a copy of the component.)rGr:rrrrHszFastMCPComponent.copy)r/r&r0rrr1)rr$)N)r;r<rr*)rEr*rFr,r/r&rr )rIrJrr,rr1rr )rrr__doc__r r%rr'r#r(rrr+r-r r.r5propertyr/rDrGrMrOrSrVrH __classcell__rrr7rr"sV       r"csbeZdZUdZeddZded<dddfd d Zdfd d Zdfdd Z dddZ Z S)MirroredComponentzBase class for components that are mirrored from a remote server. Mirrored components cannot be enabled or disabled directly. Call copy() first to create a local version you can modify. Frr, _mirrored)r]r0rrr1c r2r3)r4r5r])r6r]r0r7rrr5r9zMirroredComponent.__init__c.|jrtd|jd|jdtdS)rQz"Cannot enable mirrored component '"'. Create a local copy first with ".copy() and add it to your server.N)r] RuntimeErrorr%r4rSr:r7rrrS zMirroredComponent.enablecr^)rUz#Cannot disable mirrored component 'r_r`N)r]rar%r4rVr:r7rrrVrbzMirroredComponent.disabler cCs|}d|_|S)z4Create a copy of the component that can be modified.F)rGr])r6copiedrrrrHszMirroredComponent.copy)r]r,r0rrr1rWrX) rrrrYr r]rr5rSrVrHr[rrr7rr\s   r\)rrrr) __future__rcollections.abcrtypingrrrr mcp.typesrpydanticr r r typing_extensionsr r r>fastmcp.utilities.typesrrrr!r"r\rrrrs      t