i>>dZddlmZddlZddlZddlmZddlmZddl m Z m Z m Z ddl mZddlmZmZdd lmZdd lmZdd lmZmZmZdd lmZdd lmZeeZej@ddGddeZ!GddeZ"GddeZ#GddeZ$y)z8Basic skill provider for handling a single skill folder.) annotationsN)Sequence)Path)AnyLiteralcast)AnyUrl)ResourceResourceResult)ResourceTemplate)Provider) SkillInfoparse_frontmatterscan_skill_files) get_logger) VersionSpec text/markdownz.mdcNeZdZUdZded<dZded<d fd Zd dZd d ZxZ S) SkillResourcez8A resource representing a skill's main file or manifest.r skill_infoFbool is_manifestct|}tttt f|d}|j j|jd|d<|S)Nfastmcp)namerskill) superget_metardictstrrrrrselfmetar __class__s ~/Users/bowang/.openclaw/workspace/ChatDev/.venv/lib/python3.12/site-packages/fastmcp/server/providers/skills/skill_provider.pyrzSkillResource.get_meta)sQw!tCH~tI7OO((++  cK|jr|jS|jj|jjz }|j Sw)zRead the resource content.)r_generate_manifestrpath main_file read_text)r"main_file_paths r%readzSkillResource.read2sK   **, ,!__11DOO4M4MMN!++- -sAAc|jj|jjDcgc]&}|j|j|j d(c}d}t j|dScc}w)z%Generate JSON manifest for the skill.)r)sizehash)rfiles)indent)rrr1r)r/r0jsondumps)r"fmanifests r%r(z SkillResource._generate_manifest:sj__))...A@. zz(1-- s+A5returndict[str, Any]r9str | bytes | ResourceResultr9r ) __name__ __module__ __qualname____doc____annotations__rrr-r( __classcell__r$s@r%rr#s%BK. .r&rcFeZdZUdZded<ddZ d d dZd dZy) SkillFileTemplatez.A template for accessing files within a skill.rrcLK|jdd}|jj|z } |j}|j |jjst d|d |j std||jst d|tjt|\}}|r!|jd r|jS|jS#t $r}t d||d}~wwxYww) z%Read a file from the skill directory.r)Path  escapes skill directoryzInvalid path: NFile not found: z Not a file: text/)getrr)resolveis_relative_to ValueErrorexistsFileNotFoundErroris_file mimetypes guess_typer startswithr+ read_bytes)r" arguments file_path full_pathe mime_type_s r%r-zSkillFileTemplate.readKsMM&"- OO((94  :!))+I++DOO,@,@A 5 3K!LMMB !#&6yk$BC C  "|I;78 8!++C N; 1 --g6&&( ('') ) :~aS12 9 :s*,D$AD3BD$ D! DD!!D$NcdK|j|d{}|j|S7w)zServer entry point - read file directly without creating ephemeral resource. Note: task_meta is ignored - this template doesn't support background tasks. )rXN)r-convert_result)r"uriparams task_metaresults r%_readzSkillFileTemplate._reades1yy6y22""6**3s 0.0cK|jdd}|jj|z j}|j |jjst d|dt jt|\}}tt||jjd|d|jjd|xsd|j| Sw) zCreate a resource for the given URI and parameters. Note: This is not typically used since _read() handles file reading directly. Provided for compatibility with the ResourceTemplate interface. r)rHrIrJ/ File from  skillapplication/octet-streamr`r descriptionr\rrY) rMrr)rNrOrPrTrUr SkillFileResourcer r)r"r`rarYrZr\r]s r%create_resourcez!SkillFileTemplate.create_resourcess JJvr* __))I5>>@ ''(<(<=uYK/GHI I ++C N; 1!s OO(()9+6$T__%9%9$:&A=#=   sC(C*)rXr:r9r<N)r`r rar:rbrr9r )r`r rar:r9r )r>r?r@rArBr-rdrmr&r%rFrFFsE8*< +  + + +  + r&rFcBeZdZUdZded<ded<dfd Zd dZxZS) rlz7A resource representing a specific file within a skill.rrr rYct|}tttt f|d}d|j ji|d<|S)Nrrr)rrrrr rrrr!s r%rzSkillFileResource.get_metasJw!tCH~tI7 DOO((  r&cK|jj|jz }|j}|j |jjst d|jd|j std|jtjt|\}}|r!|jdr|jS|jSw)zRead the file content.rIrJrKrL)rr)rYrNrOrPrQrRrTrUr rVr+rW)r"rZr\r]s r%r-zSkillFileResource.readsOO((4>>9 %%' ''(<(<=uT^^$44LMN N!#&6t~~6F$GH H ++C N; 1 --g6&&( ('') )sC.C0r8r;)r>r?r@rArBrr-rCrDs@r%rlrlsAN*r&rlceZdZdZ d d fd Zd dZed dZddZ d ddZ ddZ d ddZ dd Z xZ S) SkillProvideraProvider that exposes a single skill folder as MCP resources. Each skill folder must contain a main file (default: SKILL.md) and may contain additional supporting files. Exposes: - A Resource for the main file (skill://{name}/SKILL.md) - A Resource for the synthetic manifest (skill://{name}/_manifest) - Supporting files via ResourceTemplate or Resources (configurable) Args: skill_path: Path to the skill directory. main_file_name: Name of the main skill file. Defaults to "SKILL.md". supporting_files: How supporting files (everything except main file and manifest) are exposed to clients: - "template": Accessed via ResourceTemplate, hidden from list_resources(). Clients discover files by reading the manifest first. - "resources": Each file exposed as individual Resource in list_resources(). Full enumeration upfront. Example: ```python from pathlib import Path from fastmcp import FastMCP from fastmcp.server.providers.skills import SkillProvider mcp = FastMCP("My Skill") mcp.add_provider(SkillProvider( Path.home() / ".claude/skills/pdf-processing" )) ``` ct|t|j|_||_||_d|_|jyrn) r__init__rrN _skill_path_main_file_name_supporting_files _skill_info _load_skill)r" skill_pathmain_file_namesupporting_filesr$s r%rvzSkillProvider.__init__sL  +335-!1-1 r&c|j|jz }|jjstd|j|js(td|d|jd|j|j }t |\}}|j dd}|s|jjdD]a}|j}|r|jds|d d }n7|jds?|jdjd d }nt|j}t|jj|xsd |jj|j|j|| |_tj!d |jjy )z#Load and parse the skill directory.zSkill directory not found: zMain skill file not found: z . Expected z in rkrH #NzSkill: )rrkr)r*r1 frontmatterzSkillProvider loaded skill: )rwrxrQrRr+rrMstripsplitrVlstriprrrrzloggerdebug)r"r*contentrbodyrkliner1s r%r{zSkillProvider._load_skills$$t';';; &&(#&A$BRBRAS$TU U!#-i[9 001d6F6F5GI  %%'-g6 T"oomR8  **40zz| 4"&t*K__S)"&++c"2"8"8":4C"@K1!!1!12$!!&&#H1A1A1F1F0G'H!!**#    3D4D4D4I4I3JKLr&cH|j td|jS)zGet the loaded skill info.zSkill not loaded)rz RuntimeErrorr"s r%rzSkillProvider.skill_infos(    #12 2r&c @K|j}g}|jttd|jd|j |jd|j |j d|d|jttd|jd|jdd|jd|d |jd k(r|jD]}|j|j k(rtj|j\}}|jttd|jd|j|jd|jd |jd |xsd ||j|Sw)zList skill resources.skill://rfrFr`rrkr\rr /_manifestFile listing for application/jsonT resourcesrgrhrirj) rappendrr rrxrkryr1r)rTrUrl)r"rr file_infor\r]s r%_list_resourceszSkillProvider._list_resourcess$&   Xejj\43G3G2HIJ |1T%9%9$:;!--) !     Xejj\<= |:./ |<,      ! ![ 0"[[ >>T%9%99(33INNC 1  %"Xejj\9>>:J#KL % |1Y^^,<=&0 F$C"+"I/I#("+..   )"sFFc ~K|j}|jdsy|tdd}|jdd}t|dk7ry|\}}||jk7ry|dk(r t t ||dd|d |d S||jk(r3t t ||d|j|jd |d S|jdk(ra|jD]R}|j|k(stj|\} } tt ||d|d|d| xsd||cSyw)zGet a resource by URI.rNrfr2 _manifestrrrTrrFrrgrhrirj)rrVlenrrrr rxrkryr1r)rTrUrl) r"r`versionr path_partparts skill_namerYrr\r]s r% _get_resourcezSkillProvider._get_resourceKsn~~j)J)* Q' u:? % I  #  # 3K"|:./ |<,   $.. . 3K"|1T%9%9$:;!--) !   # #{ 2"[[ >>Y.#,#7#7 #BLIq,"3K *|1YK8&0 F$C"+"I/I#("+ )s C7D=:AD=c K|jdk7rgS|j}td|jd|jdd|jdddd d iidgd | gSw) z=List resource templates for accessing files within the skill.templater/{path*}_filesAccess files within riobjectr)typestringr propertiesrequired uri_templaterrkr\ parametersr)ryrrFr)r"rs r%_list_resource_templatesz&SkillProvider._list_resource_templatess  ! !Z /I ' |:> |6*25::,?4$#)FH+=">!' !   sA!A#c K|jdk7ry|j}|jdsy|tdd}|j dd}t|dk7ry|\}}||j k7ry|dk(s||j k(rytd|j d|j d d |j d d d ddiid gd|Sw)z3Get a resource template that matches the given URI.rNrrfrr2rrrrrirr)rrrr)ryrrVrrrrxrF)r"r`rrrrrrYs r%_get_resource_templatez$SkillProvider._get_resource_templates  ! !Z /~~j)J)* Q' u:? % I  #  #yD4H4H'H #EJJr?r@rArvr{propertyrrrrrrrCrDs@r%rtrtsH)=G   ;   (MT  0f7;33!33 3j .7;% % !3% % N r&rt)%rA __future__rr4rTcollections.abcrpathlibrtypingrrrpydanticr fastmcp.resources.resourcer r fastmcp.resources.templater fastmcp.server.providers.baser 'fastmcp.server.providers.skills._commonrrrfastmcp.utilities.loggingrfastmcp.utilities.versionsrr>radd_typerrFrlrtror&r%rs>" $%%?72 12 H  ?E* .H .FD (D N**LN HN r&