kKjdZddlmZddlZddlZddlmZddlmZddl m Z ddl Z e rddl mZeGdd ZeGd d ZeGd d ZddZddZdd ddZdd ddZy)zIClient utilities for discovering and downloading skills from MCP servers.) annotationsN) dataclass)Path) TYPE_CHECKING)Clientc0eZdZUdZded<ded<ded<y) SkillSummaryz8Summary information about a skill available on a server.strname descriptionuriN__name__ __module__ __qualname____doc____annotations__i/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/fastmcp/utilities/skills.pyr r sB I Hrr c0eZdZUdZded<ded<ded<y) SkillFilez(Information about a file within a skill.r pathintsizehashNrrrrrrs2 I I Irrc&eZdZUdZded<ded<y) SkillManifestz-Full manifest of a skill including all files.r r zlist[SkillFile]filesNrrrrrr#s7 I rrcbK|jd{}g}|D]}t|j}|jds*|j ds<|t dd}|j ddd}|jt||jxsd||S7w) axList all available skills from an MCP server. Discovers skills by finding resources with URIs matching the `skill://{name}/SKILL.md` pattern. Args: client: Connected FastMCP client Returns: List of SkillSummary objects with name, description, and URI Example: ```python from fastmcp import Client from fastmcp.utilities.skills import list_skills async with Client("http://skills-server/mcp") as client: skills = await list_skills(client) for skill in skills: print(f"{skill.name}: {skill.description}") ``` Nskill://z /SKILL.md/r)r r r ) list_resourcesr r startswithendswithlenrsplitappendr r )client resourcesskillsresourcer path_partr s r list_skillsr0+s.++--I F(,, >>* %#,,{*CC O-.I##C+A.D MM ( 4 4 :  M%.sB/B-1B/ B/AB/c 4Kd|d}|j|d{}|std||d}t|tjj r! t j|j}ntd| t|d|d Dcgc]}t|d |d |d  c}S7#t j$r}td||d}~wwxYwcc}w#ttf$r}td||d}~wwxYww)aGet the manifest for a specific skill. Args: client: Connected FastMCP client skill_name: Name of the skill Returns: SkillManifest with file listing Raises: ValueError: If manifest cannot be read or parsed r!z /_manifestNz#Could not read manifest for skill: rz!Invalid manifest JSON for skill: z&Unexpected manifest format for skill: skillrrrr)rrr)r rz#Invalid manifest format for skill: ) read_resource ValueError isinstancemcptypesTextResourceContentsjsonloadstextJSONDecodeErrorrrKeyError TypeError)r+ skill_name manifest_uriresultcontent manifest_dataefs rget_skill_manifestrFWsBj\4L'' 5 5F >zlKLLQiG'39999: V JJw||4MA*NOO Tw''w//AqyqyqyI/  6## V@ MNTU U V i T>zlKLRSSTsiDC=DC;D C2C- 9C2DC*C%%C**D-C22DDDDF overwritecKt|jj}||z j}|j|st d|d|j r|st d|dt||d{}|jdd|jD]:}t|jjr(||jz j}|j|sWd|d |j}|j|d{} | s| d } |jjddt| tj j"r|j%| j&t| tj j(r0|j+t-j.| j0;=|S7d7ŭw) aDownload a skill and all its files to a local directory. Creates a subdirectory named after the skill containing all files. Args: client: Connected FastMCP client skill_name: Name of the skill to download target_dir: Directory where skill folder will be created overwrite: If True, overwrite existing skill directory. If False (default), raise FileExistsError if directory exists. Returns: Path to the downloaded skill directory Raises: ValueError: If skill cannot be found or downloaded FileExistsError: If skill directory exists and overwrite=False Example: ```python from fastmcp import Client from fastmcp.utilities.skills import download_skill async with Client("http://skills-server/mcp") as client: skill_path = await download_skill( client, "pdf-processing", "~/.claude/skills" ) print(f"Downloaded to: {skill_path}") ``` z Skill name z" would escape the target directoryz Skill directory already exists: z . Use overwrite=True to replace.NT)parentsexist_okr!r"r)r expanduserresolveis_relative_tor4existsFileExistsErrorrFmkdirrr is_absoluter3parentr5r6r7r8 write_textr;BlobResourceContents write_bytesbase64 b64decodeblob) r+r? target_dirrH skill_dirmanifest file_info file_pathfile_urirArBs rdownload_skillr`sNj!,,.668Jj(113I  # #J /;zn4VWXX).yk:- -  ( ;;HOOD4O0^^    + + - /88: '' 2 j\9>>*:;++H55 ) td; gsyy== >   . !?!? @  ! !&"2"27<<"@ A 5$8 E<6s&B G6 G1B G6.G4/CG64G6cKt|d{}g}|D]5} t||j||d{}|j|7|S7B7#t$rYIwxYww)aaDownload all available skills from a server. Args: client: Connected FastMCP client target_dir: Directory where skill folders will be created overwrite: If True, overwrite existing files Returns: List of paths to downloaded skill directories Example: ```python from fastmcp import Client from fastmcp.utilities.skills import sync_skills async with Client("http://skills-server/mcp") as client: paths = await sync_skills(client, "~/.claude/skills") print(f"Downloaded {len(paths)} skills") ``` NrG)r0r`r r*rP)r+rZrHr- downloadedr2rs r sync_skillsrcs{4v& &FJ ' J)D   d #  '    sBA'A A'AAAA'A A$!A'#A$$A')r+rreturnzlist[SkillSummary])r+rr?r rdr) r+rr?r rZ str | PathrHboolrdr)r+rrZrerHrfrdz list[Path])r __future__rrWr9 dataclassesrpathlibrtypingr mcp.typesr6fastmcp.clientrr rrr0rFr`rcrrrrmsO" ! %         )X%TZ X XXX  X  X~ ' '' '  'r