[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8},"actionData","errors","root",{"_107":108,"_109":110},"routes/embed.x.$handle.$name.$",{"_9":10,"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":-5},"handle","mcpconformance","name","mcp-client-conformance","path","src/scenarios/server/skills/manifest.ts","project",{"_22":51,"_11":12,"_35":52,"_53":-5,"_54":44,"_55":56,"_57":56,"_58":-5,"_59":-5,"_60":61,"_62":63,"_64":34,"_65":-5,"_66":-5,"_67":38,"_68":69,"_70":-5,"_71":-5,"_72":-5,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":84,"_85":86,"_87":88,"_89":44},"file",{"_22":23,"_11":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":38,"_39":40,"_41":42,"_43":44,"_45":-5,"_13":46},"permalink","https://www.val.town/x/mcpconformance/mcp-client-conformance/code/src/scenarios/server/skills/manifest.ts","extension","id","12eb13b8-6d02-4f7f-935f-98424756ec80","manifest.ts","fileId","b79f1434-ae14-11f1-ad67-1607ee4eb77e","parentId","1c742940-41f3-4821-b71e-e95273d6a26e","branchId","fdc11199-683b-41f1-a3c5-d5ac53972f86","branchVersion",179,"latest",true,"createdAt",["D",1789153942827],"version",0,"fileType","script","content","/**\n * SEP-2640 Skills extension — the `SKILL.md` manifest resource.\n *\n * One scenario, many checks (per AGENTS.md \"fewer scenarios, more checks\").\n * Each check's verbatim spec quote lives next to its check ID in\n * src/seps/sep-2640.yaml.\n *\n * Discovery is dynamic and brand-neutral: the scenario finds a `skill-md`\n * skill's `SKILL.md` resource from `resources/list` (preferred — it carries the\n * Resource `name`/`description` metadata) or falls back to the first `skill-md`\n * entry in `skills/list`, hardcoding no fixture skill. Undeclared\n * extension SKIPs; a declared extension with no discoverable `SKILL.md` reports\n * the missing prerequisite via untestableCheck (issue #248), never a silent\n * green.\n */\n\nimport { ClientScenario, ConformanceCheck } from '../../../types.ts';\nimport { JsonRpcError, type RunContext } from '../../../connection/index.ts';\nimport { untestableCheck } from '../../untestable.ts';\nimport {\n SKILLS_EXTENSION_ID,\n SKILLS_META_PREFIX,\n SEP_2640_REF,\n type SkillResource,\n skillsCapability,\n skillsCheck,\n listAllResources,\n skillsListAll,\n readResourceText,\n skillNameFromManifestUri,\n parseFrontmatter\n} from './helpers.ts';\n\nconst MIMETYPE_ID = 'sep-2640-skillmd-mimetype';\nconst METADATA_NAME_ID = 'sep-2640-skillmd-metadata-name';\nconst METADATA_DESCRIPTION_ID = 'sep-2640-skillmd-metadata-description';\nconst FINAL_SEGMENT_ID = 'sep-2640-final-segment-equals-name';\nconst META_PREFIX_ID = 'sep-2640-meta-prefix';\n\nconst MARKDOWN_MIME = 'text/markdown';\n\n/** A SKILL.md resource URI is skill:///SKILL.md. */\nfunction isManifestUri(uri: string): boolean {\n return skillNameFromManifestUri(uri) !== undefined;\n}\n\n/** A `_meta` key that already carries a reverse-domain namespace (`vendor.tld/…`). */\nfunction isNamespacedMetaKey(key: string): boolean {\n return /^[a-z0-9-]+(\\.[a-z0-9-]+)+\\//i.test(key);\n}\n\nexport class SkillsManifestScenario implements ClientScenario {\n name = 'sep-2640-skills-manifest';\n readonly source = { extensionId: SKILLS_EXTENSION_ID } as const;\n description = `SEP-2640 Skills extension: the \\`SKILL.md\\` manifest resource.\n\n**Resource**: \\`skill:///SKILL.md\\` (read via \\`resources/read\\`)\n\n**Requirements covered** (each check carries a verbatim spec excerpt in src/seps/sep-2640.yaml):\n\n- \\`sep-2640-skillmd-mimetype\\` — the SKILL.md resource \\`mimeType\\` SHOULD be \\`text/markdown\\`\n- \\`sep-2640-skillmd-metadata-name\\` — the resource \\`name\\` SHOULD be the frontmatter \\`name\\`\n- \\`sep-2640-skillmd-metadata-description\\` — the resource \\`description\\` SHOULD be the frontmatter \\`description\\`\n- \\`sep-2640-final-segment-equals-name\\` — the final \\`\\` segment MUST equal the frontmatter \\`name\\`\n- \\`sep-2640-meta-prefix\\` — un-namespaced skill \\`_meta\\` keys SHOULD use the \\`io.modelcontextprotocol.skills/\\` prefix\n\n**Discovery is dynamic**: the scenario picks the first \\`skill-md\\` skill it finds. Undeclared extension SKIPs; a declared extension with no discoverable SKILL.md reports the missing prerequisite (not a silent skip).`;\n\n async run(ctx: RunContext): Promise {\n const conn = await ctx.connect();\n try {\n const skills = await skillsCapability(conn);\n const allIds = [\n MIMETYPE_ID,\n METADATA_NAME_ID,\n METADATA_DESCRIPTION_ID,\n FINAL_SEGMENT_ID,\n META_PREFIX_ID\n ];\n if (!skills) {\n const reason =\n 'Server did not declare the io.modelcontextprotocol/skills extension; SKILL.md checks not applicable.';\n return allIds.map((id) =>\n skillsCheck(id, reason, 'SKIPPED', { errorMessage: reason })\n );\n }\n\n // === Dynamic discovery: resources/list first (carries Resource\n // metadata), then skills/list. ===\n const resources = await listAllResources(conn);\n const manifestResource: SkillResource | undefined = resources.find((r) =>\n isManifestUri(r.uri)\n );\n let manifestUri = manifestResource?.uri;\n if (!manifestUri) {\n const listed = await skillsListAll(conn);\n if (!('error' in listed)) {\n const entry = listed.entries.find(\n (e) => typeof e.uri === 'string' && isManifestUri(e.uri)\n );\n manifestUri = entry?.uri as string | undefined;\n }\n }\n\n if (!manifestUri) {\n const reason =\n 'no skill:///SKILL.md resource found via resources/list or skills/list';\n return [\n untestableCheck(\n MIMETYPE_ID,\n MIMETYPE_ID,\n 'SKILL.md resource mimeType SHOULD be text/markdown.',\n reason,\n [SEP_2640_REF],\n 'WARNING'\n ),\n untestableCheck(\n METADATA_NAME_ID,\n METADATA_NAME_ID,\n 'SKILL.md resource name SHOULD match the frontmatter name.',\n reason,\n [SEP_2640_REF],\n 'WARNING'\n ),\n untestableCheck(\n METADATA_DESCRIPTION_ID,\n METADATA_DESCRIPTION_ID,\n 'SKILL.md resource description SHOULD match the frontmatter description.',\n reason,\n [SEP_2640_REF],\n 'WARNING'\n ),\n untestableCheck(\n FINAL_SEGMENT_ID,\n FINAL_SEGMENT_ID,\n 'The final segment MUST equal the frontmatter name.',\n reason,\n [SEP_2640_REF],\n 'FAILURE'\n ),\n untestableCheck(\n META_PREFIX_ID,\n META_PREFIX_ID,\n 'Skill _meta keys SHOULD use the io.modelcontextprotocol.skills/ prefix.',\n reason,\n [SEP_2640_REF],\n 'WARNING'\n )\n ];\n }\n\n const checks: ConformanceCheck[] = [];\n\n // Read the manifest content (for mimeType, frontmatter, and _meta).\n let content:\n | { text: string; mimeType?: string; meta?: Record }\n | undefined;\n let readError: string | undefined;\n try {\n content = await readResourceText(conn, manifestUri);\n if (!content) readError = 'resources/read returned no text content';\n } catch (e) {\n readError =\n e instanceof JsonRpcError\n ? `resources/read failed: code ${e.code}: ${e.message}`\n : e instanceof Error\n ? e.message\n : String(e);\n }\n\n // === skillmd-mimetype (SHOULD) ===\n // Prefer the read content's mimeType; fall back to the resources/list\n // Resource metadata mimeType.\n const mimeType = content?.mimeType ?? manifestResource?.mimeType;\n if (mimeType === undefined) {\n checks.push(\n untestableCheck(\n MIMETYPE_ID,\n MIMETYPE_ID,\n 'SKILL.md resource mimeType SHOULD be text/markdown.',\n `no mimeType observable for ${manifestUri}${readError ? ` (${readError})` : ''}`,\n [SEP_2640_REF],\n 'WARNING'\n )\n );\n } else {\n checks.push(\n skillsCheck(\n MIMETYPE_ID,\n 'SKILL.md resource mimeType SHOULD be text/markdown.',\n mimeType === MARKDOWN_MIME ? 'SUCCESS' : 'WARNING',\n mimeType === MARKDOWN_MIME\n ? { details: { uri: manifestUri, mimeType } }\n : {\n errorMessage: `expected mimeType \"${MARKDOWN_MIME}\", got ${JSON.stringify(mimeType)}`\n }\n )\n );\n }\n\n // Parse the frontmatter once for the name/description/final-segment checks.\n const frontmatter = content ? parseFrontmatter(content.text) : undefined;\n const fmName =\n typeof frontmatter?.name === 'string' ? frontmatter.name : undefined;\n const fmDescription =\n typeof frontmatter?.description === 'string'\n ? frontmatter.description\n : undefined;\n\n // === final-segment-equals-name (MUST) ===\n const uriName = skillNameFromManifestUri(manifestUri);\n if (fmName === undefined || uriName === undefined) {\n const missing =\n fmName === undefined\n ? `SKILL.md frontmatter has no string \"name\"${readError ? ` (${readError})` : ''}`\n : `could not derive the skill name from URI ${manifestUri}`;\n checks.push(\n untestableCheck(\n FINAL_SEGMENT_ID,\n FINAL_SEGMENT_ID,\n 'The final segment MUST equal the frontmatter name.',\n missing,\n [SEP_2640_REF],\n 'FAILURE'\n )\n );\n } else {\n checks.push(\n skillsCheck(\n FINAL_SEGMENT_ID,\n 'The final segment of the SKILL.md URI MUST equal the frontmatter name.',\n uriName === fmName ? 'SUCCESS' : 'FAILURE',\n uriName === fmName\n ? { details: { uri: manifestUri, name: fmName } }\n : {\n errorMessage: `final path segment \"${uriName}\" != frontmatter name \"${fmName}\"`\n }\n )\n );\n }\n\n // === skillmd-metadata-name (SHOULD) — needs the Resource metadata ===\n if (!manifestResource) {\n checks.push(\n untestableCheck(\n METADATA_NAME_ID,\n METADATA_NAME_ID,\n 'SKILL.md resource name SHOULD match the frontmatter name.',\n `SKILL.md ${manifestUri} is not listed in resources/list, so its Resource name metadata is not observable`,\n [SEP_2640_REF],\n 'WARNING'\n )\n );\n } else if (fmName === undefined) {\n checks.push(\n untestableCheck(\n METADATA_NAME_ID,\n METADATA_NAME_ID,\n 'SKILL.md resource name SHOULD match the frontmatter name.',\n `SKILL.md frontmatter has no string \"name\" to compare against${readError ? ` (${readError})` : ''}`,\n [SEP_2640_REF],\n 'WARNING'\n )\n );\n } else {\n checks.push(\n skillsCheck(\n METADATA_NAME_ID,\n 'The SKILL.md resource name SHOULD be set from the frontmatter name.',\n manifestResource.name === fmName ? 'SUCCESS' : 'WARNING',\n manifestResource.name === fmName\n ? { details: { name: fmName } }\n : {\n errorMessage: `resource name ${JSON.stringify(manifestResource.name)} != frontmatter name ${JSON.stringify(fmName)}`\n }\n )\n );\n }\n\n // === skillmd-metadata-description (SHOULD) — needs Resource metadata ===\n if (!manifestResource) {\n checks.push(\n untestableCheck(\n METADATA_DESCRIPTION_ID,\n METADATA_DESCRIPTION_ID,\n 'SKILL.md resource description SHOULD match the frontmatter description.',\n `SKILL.md ${manifestUri} is not listed in resources/list, so its Resource description metadata is not observable`,\n [SEP_2640_REF],\n 'WARNING'\n )\n );\n } else if (fmDescription === undefined) {\n checks.push(\n untestableCheck(\n METADATA_DESCRIPTION_ID,\n METADATA_DESCRIPTION_ID,\n 'SKILL.md resource description SHOULD match the frontmatter description.',\n `SKILL.md frontmatter has no string \"description\" to compare against${readError ? ` (${readError})` : ''}`,\n [SEP_2640_REF],\n 'WARNING'\n )\n );\n } else {\n checks.push(\n skillsCheck(\n METADATA_DESCRIPTION_ID,\n 'The SKILL.md resource description SHOULD be set from the frontmatter description.',\n manifestResource.description === fmDescription\n ? 'SUCCESS'\n : 'WARNING',\n manifestResource.description === fmDescription\n ? { details: { description: fmDescription } }\n : {\n errorMessage: `resource description ${JSON.stringify(manifestResource.description)} != frontmatter description ${JSON.stringify(fmDescription)}`\n }\n )\n );\n }\n\n // === meta-prefix (SHOULD, conditional on _meta keys being present) ===\n // Union the _meta of the read content and the resources/list Resource.\n const metaKeys = new Set([\n ...Object.keys(content?.meta ?? {}),\n ...Object.keys(manifestResource?._meta ?? {})\n ]);\n if (metaKeys.size === 0) {\n checks.push(\n skillsCheck(\n META_PREFIX_ID,\n 'When _meta keys are used for skill resources, they SHOULD use the io.modelcontextprotocol.skills/ reverse-domain prefix.',\n 'SUCCESS',\n { details: { note: 'skill resource exposes no _meta keys' } }\n )\n );\n } else {\n // Only bare (un-namespaced) keys are flagged: a key already carrying a\n // reverse-domain namespace is the intended shape, whichever vendor.\n const bareKeys = [...metaKeys].filter((k) => !isNamespacedMetaKey(k));\n checks.push(\n skillsCheck(\n META_PREFIX_ID,\n 'When _meta keys are used for skill resources, they SHOULD use the io.modelcontextprotocol.skills/ reverse-domain prefix.',\n bareKeys.length === 0 ? 'SUCCESS' : 'WARNING',\n bareKeys.length === 0\n ? { details: { metaKeys: [...metaKeys] } }\n : {\n errorMessage: `un-namespaced skill _meta keys SHOULD use the ${SKILLS_META_PREFIX} prefix: ${bareKeys.join(', ')}`\n }\n )\n );\n }\n\n return checks;\n } finally {\n await conn.close();\n }\n }\n}\n","deleted",false,"label",[47,48,49,50,24],"src","scenarios","server","skills","7dcb6042-d92f-40c5-9cc8-0f661f96e58b",["D",1789043604380],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","imageUrl","userId","f4518a30-f52b-4b12-891c-a8fffb7240f8","pinnedFileId","e6dd13e2-ad13-11f1-a612-1607ee4eb77e","pinPreview","pinMigrated","screenshotVersion","likeCount","orgId","01a07c12-b73a-76de-b96a-421ce8582af6","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_9":10,"_106":-5},"org",{"_9":10,"_100":101,"_102":-5,"_60":-5,"_103":104,"_105":44},"branch",{"_37":90,"_11":91,"_22":30,"_92":51,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":12,"_99":10},"isOwned",396,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","MCP Conformance","avatar","tier","free","canRestrictVals","profileImageUrl","ctx",{"_83":-5,"_140":141,"_142":143,"_144":145,"_146":44,"_147":44,"_148":44,"_149":34,"_150":-5,"_151":-7,"_152":-7,"_153":38,"_154":44,"_155":44,"_156":-5,"_157":44,"_158":44,"_159":44,"_160":-5},"ENV",{"_111":112,"_113":114,"_115":91,"_116":117,"_118":119,"_120":121,"_122":123,"_124":125,"_126":127,"_128":129,"_130":131,"_132":133,"_134":135,"_136":137,"_138":139},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5015b8df46402d8bba4f485ecc37aec202b0e06b","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town","orgs",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]