[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8},"actionData","errors","root",{"_106":107,"_108":109},"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/hosted/markdown.ts","project",{"_22":49,"_11":12,"_35":50,"_51":-5,"_52":44,"_53":54,"_55":54,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":34,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":-5,"_70":-5,"_71":-5,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":83,"_84":85,"_86":87,"_88":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/hosted/markdown.ts","extension","id","4f71dcde-3bb0-4a2b-ac5e-a5364b88aa0b","markdown.ts","fileId","120be2d0-afbe-11f1-9c16-1607ee4eb77e","parentId","11abc952-e3be-41e6-ac33-6929c3af1284","branchId","fdc11199-683b-41f1-a3c5-d5ac53972f86","branchVersion",390,"latest",true,"createdAt",["D",1789379127984],"version",4,"fileType","script","content","/**\n * The run report as Markdown, for pasting into an issue or a chat: who the\n * client is, the score, what went wrong once per cause, and per revision a\n * table of what needs a look, what the client has not tried and what passed\n * (see groupColumn()), each failure marked as the client's or the scenario's\n * own; then, once each, the scenarios this deployment cannot start. Anything\n * that came from traffic (client names, check\n * messages) goes through mdText() or mdCode(), so it cannot open a link, a\n * tag, a code span or a new table cell when the Markdown is rendered.\n */\n\nimport {\n groupColumn,\n unavailableScenarios,\n type CellReport,\n type CellState,\n type CheckSummary,\n type ColumnReport,\n type RunReport\n} from './report.ts';\nimport { NOT_REACHED, type Cause, type Finding } from './findings.ts';\nimport type { ClientIdentity } from './identity.ts';\nimport { buildText } from './build.ts';\n\nexport const STATE_LABEL: Record = {\n pass: 'pass',\n fail: 'fail',\n waiting: 'waiting',\n stopped: 'stopped',\n 'in-progress': 'in progress',\n incomplete: 'incomplete',\n 'not-tried': 'not tried',\n 'not-startable': 'not startable',\n 'n/a': 'n/a'\n};\n\n/**\n * A glyph per state, shown with its word, so no state is told by colour\n * alone (the pages; the Markdown keeps the words).\n */\nexport const STATE_GLYPH: Record = {\n pass: '✓',\n fail: '✗',\n waiting: '◔',\n stopped: '■',\n 'in-progress': '◑',\n incomplete: '◒',\n 'not-tried': '○',\n 'not-startable': '⊘',\n 'n/a': '–'\n};\n\n/** States of a cell the client reached. */\nexport const REACHED: readonly CellState[] = [\n 'pass',\n 'fail',\n 'waiting',\n 'stopped',\n 'in-progress',\n 'incomplete'\n];\n\nexport const BY_LABEL: Record = {\n client: 'client',\n scenario: 'not seen'\n};\n\n/** How many causes' cells to name before \"and N more\". */\nconst CELLS_NAMED = 6;\n\n/** One line of plain text, with the characters that start markup escaped. */\nexport function mdText(s: string): string {\n return s\n .replace(/\\s+/g, ' ')\n .trim()\n .replace(/[\\\\`*[\\]<>|]/g, (c) => `\\\\${c}`);\n}\n\n/** An identifier as a code span; `|` escaped so it stays in its table cell. */\nexport function mdCode(s: string): string {\n return '`' + s.replace(/[`\\s]+/g, ' ').replace(/\\|/g, '\\\\|') + '`';\n}\n\n/** `2026-09-13T21:47:05.123Z` → `2026-09-13 21:47 UTC`. */\nexport function utcMinute(iso: string): string {\n return `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC`;\n}\n\nexport function identityText(\n identities: readonly ClientIdentity[],\n text: (s: string) => string = mdText\n): string {\n if (!identities.length) return 'no client seen yet';\n return identities\n .map((i) => {\n const who = i.name\n ? `${i.name}${i.version ? ` ${i.version}` : ''}`\n : 'unnamed client';\n const proto = i.protocolVersions.length\n ? ` (protocol ${i.protocolVersions.join(', ')})`\n : '';\n return text(who + proto);\n })\n .join('; ');\n}\n\n/** \"3 pass, 1 fail, 2 in progress\" over the states given. */\nexport function countsText(\n counts: RunReport['columns'][number]['counts'],\n states: readonly CellState[]\n): string {\n return states\n .filter((s) => counts[s])\n .map((s) => `${counts[s]} ${STATE_LABEL[s]}`)\n .join(', ');\n}\n\n/**\n * A cell's counts as its page leads with them: \"1 passed, 0 failed, 6 not\n * seen\". Only SUCCESS rows are passes; INFO rows (request logs) never count.\n */\nexport function countsLine(s: CheckSummary): string {\n const parts = [`${s.passed} passed`, `${s.failed} failed`];\n if (s.notSeen) parts.push(`${s.notSeen} not seen`);\n if (s.warnings) {\n parts.push(`${s.warnings} warning${s.warnings === 1 ? '' : 's'}`);\n }\n return parts.join(', ');\n}\n\n/** 1-based number of each cause, for \"(cause 2)\" references. */\nexport function causeNumbers(causes: readonly Cause[]): Map {\n return new Map(causes.map((c, i) => [c.key, i + 1]));\n}\n\n/**\n * The cause a cell's row should point at: the one that stopped it, or a\n * finding's when that cause covers other cells too.\n */\nfunction causeRef(\n key: string | undefined,\n causes: ReadonlyMap,\n numbers: ReadonlyMap\n): string {\n if (!key) return '';\n const cause = causes.get(key);\n if (!cause || cause.cells.length < 2) return '';\n return ` (cause ${numbers.get(key)})`;\n}\n\n/** One thing a waiting or in-progress cell has not seen yet. */\nexport interface Unmet {\n reason: string;\n /** The steps it covers, when the reason is only NOT_REACHED. */\n checks?: string[];\n}\n\n/**\n * What a waiting or in-progress cell has not seen yet: each distinct reason\n * once, and \"the flow did not reach this step\" as the steps it covers.\n */\nexport function waitingFor(cell: CellReport): Unmet[] {\n const unmet = (cell.findings ?? []).filter(\n (f) => cell.state === 'in-progress' || f.by === 'scenario'\n );\n const out: Unmet[] = [];\n for (const f of unmet) {\n if (f.reason === NOT_REACHED) {\n const steps = out.find((u) => u.checks);\n if (steps) steps.checks!.push(f.check);\n else out.push({ reason: f.reason, checks: [f.check] });\n } else if (!out.some((u) => u.reason === f.reason)) {\n out.push({ reason: f.reason });\n }\n }\n return out;\n}\n\n/** Whether a cell's row shows its pass / fail / warn counts. */\nexport function showsCounts(cell: CellReport): boolean {\n return ['pass', 'fail', 'waiting', 'stopped'].includes(cell.state);\n}\n\n/**\n * How text taken from traffic is written: as escaped Markdown, or as plain\n * text for a chat that renders no Markdown table (Slack), where it only has\n * to stay on one line.\n */\ninterface Style {\n text(s: string): string;\n code(s: string): string;\n}\n\nconst MARKDOWN: Style = { text: mdText, code: mdCode };\n\nconst PLAIN: Style = {\n text: (s) => s.replace(/\\s+/g, ' ').trim(),\n code: (s) => '`' + s.replace(/[`\\s]+/g, ' ') + '`'\n};\n\n/** \"the flow has not reached `a`, `b`\", or the reason. */\nfunction unmetText(u: Unmet, st: Style): string {\n return u.checks\n ? `the flow has not reached ${u.checks.map(st.code).join(', ')}`\n : st.text(u.reason);\n}\n\n/** What a passing cell's row says. */\nexport const NO_FINDINGS = 'no failures or warnings';\n\n/**\n * Why an incomplete cell stopped: its note without the tail about the\n * failures its own page lists (incompleteNote() joins the two with \"; \").\n */\nexport function stopNote(cell: CellReport): string {\n return (cell.note ?? '').split('; ')[0];\n}\n\n/** A reached cell's \"what happened\", one line per item. */\nfunction happened(\n cell: CellReport,\n causes: ReadonlyMap,\n numbers: ReadonlyMap,\n st: Style\n): string[] {\n const findings = cell.findings ?? [];\n if (cell.state === 'in-progress') {\n return [\n findings.length\n ? `waiting for: ${waitingFor(cell)\n .map((u) => unmetText(u, st))\n .join('; ')}`\n : st.text(cell.note ?? '')\n ];\n }\n if (cell.state === 'incomplete') {\n return [st.text(stopNote(cell)) + causeRef(cell.cause, causes, numbers)];\n }\n // A waiting (or stopped) cell's own expectations are what it waits for;\n // anything the client did (a warning) is listed as on any other row.\n const waits = cell.state === 'waiting' || cell.state === 'stopped';\n const listed = waits ? findings.filter((f) => f.by === 'client') : findings;\n const lines = listed.map(\n (f) =>\n `${f.status === 'WARNING' ? 'warning, ' : ''}${BY_LABEL[f.by]}: ` +\n `${st.code(f.check)} ${st.text(f.reason)}${causeRef(f.cause, causes, numbers)}`\n );\n if (waits) {\n lines.unshift(\n `${st.text(cell.note ?? '')}; not seen yet: ${waitingFor(cell)\n .map((u) => unmetText(u, st))\n .join('; ')}`\n );\n }\n return lines.length ? lines : [NO_FINDINGS];\n}\n\nexport interface MarkdownLinks {\n /** The live report. */\n live: string;\n /** This frozen copy, when the report is one. */\n snapshot?: string;\n}\n\n/**\n * A revision's score, led by what a person could run here and keeping the\n * requirement set's scored total: \"13 of the 15 scored cells you can run\n * here pass · 18 are scored for 2025-11-25; the other 3 cannot start on\n * this deployment (see Unavailable below)\". The numbers are the column's\n * `scored` fields.\n */\nexport function scoreText(\n col: Pick\n): string {\n const { passed, total, startable } = col.scored;\n if (total === 0) return `no cells are scored for ${col.revision}`;\n if (startable === total) return `${passed} of the ${total} scored cells pass`;\n const other = total - startable;\n const lead =\n startable === 0\n ? 'none of the scored cells can run here'\n : `${passed} of the ${startable} scored cells you can run here pass`;\n return (\n `${lead} · ${total} are scored for ${col.revision}; the other ${other} ` +\n `cannot start on this deployment (see ${UNAVAILABLE_HEADING} below)`\n );\n}\n\n/** The lines both forms open with: when, who, and the score per revision. */\nfunction summaryLines(\n report: RunReport,\n links: MarkdownLinks,\n st: Style,\n bullet: string\n): string[] {\n const out = [\n report.frozenAt && links.snapshot\n ? `${bullet}Frozen ${utcMinute(report.frozenAt)}: ${links.snapshot} (live report: ${links.live})`\n : `${bullet}As of ${utcMinute(report.generatedAt)}: ${links.live}`,\n `${bullet}Client: ${identityText(report.identities, st.text)}`,\n `${bullet}Server: ${st.text(buildText(report.server))}`\n ];\n for (const col of report.columns) {\n const reached = countsText(col.counts, REACHED);\n const notTried = col.counts['not-tried'] ?? 0;\n out.push(\n `${bullet}${col.revision}: ${scoreText(col)}. ` +\n `Reached: ${reached || 'none'}` +\n (notTried ? `; ${notTried} not tried.` : '.')\n );\n }\n return out;\n}\n\n/** Each cause once, numbered, with the cells it covers. */\nfunction causeLines(report: RunReport, st: Style): string[] {\n return report.causes.map((c, i) => {\n const cells = c.cells.slice(0, CELLS_NAMED).map(st.text).join(', ');\n const more =\n c.cells.length > CELLS_NAMED\n ? ` and ${c.cells.length - CELLS_NAMED} more`\n : '';\n const who = c.by === 'client' ? 'Client' : 'Not seen';\n return (\n `${i + 1}. ${who}: ${c.check ? `${st.code(c.check)} ` : ''}${st.text(c.text)} ` +\n `(${c.cells.length === 1 ? cells : `${c.cells.length} cells: ${cells}${more}`})`\n );\n });\n}\n\nfunction anyReached(report: RunReport): boolean {\n return report.columns.some((col) =>\n col.cells.some((c) => REACHED.includes(c.state))\n );\n}\n\nfunction countsOf(cell: CellReport): string {\n const s = cell.summary;\n return s && showsCounts(cell)\n ? `${s.passed} / ${s.failed} / ${s.warnings}`\n : '–';\n}\n\nconst LEGEND =\n '\"client\" failures were seen in the client’s traffic; \"not seen\" ones are ' +\n 'the scenario’s own expectations that nothing has met yet.';\n\n/**\n * A revision's not-tried group, headed plainly. When the client reached\n * nothing at the revision the page folds the group (it is every cell).\n */\nexport function notTriedHeading(n: number, reachedAny: boolean): string {\n return reachedAny\n ? `Not tried yet (${n}): your client never connected to these`\n : `Not tried yet (${n}): your client never connected to any cell at this revision`;\n}\n\nexport const NOT_TRIED_WHY =\n 'Common reasons: the client was not given the cell’s URL; it does not ' +\n 'support what the cell tests; or it is an auth cell, which needs a URL of ' +\n 'its own (a composite URL leaves auth cells out).';\n\nexport function passedHeading(n: number): string {\n return `Passed (${n})`;\n}\n\nexport const UNAVAILABLE_HEADING = 'Unavailable on this deployment';\n\nexport const UNAVAILABLE_WHY =\n 'This deployment cannot start these cells, so no client can reach them ' +\n 'here, and the lists above leave them out. A scored one still counts in ' +\n 'the number scored for its revision.';\n\n/** A not-tried cell's line: where to point the client, and what it must do. */\nfunction notTriedText(cell: CellReport, st: Style): string {\n const parts: string[] = [];\n if (cell.mcpUrl) parts.push(`MCP URL ${st.code(cell.mcpUrl)}`);\n parts.push(\n cell.hint\n ? `the client must ${st.text(cell.hint)}`\n : 'nothing reached this cell'\n );\n return parts.join('; ');\n}\n\n/** \"Unavailable on this deployment (N)\", why, and a line per scenario. */\nfunction unavailableLines(\n report: RunReport,\n st: Style,\n heading: (s: string) => string,\n bullet: string\n): string[] {\n const list = unavailableScenarios(report);\n if (!list.length) return [];\n return [\n '',\n heading(`${UNAVAILABLE_HEADING} (${list.length})`),\n UNAVAILABLE_WHY,\n ...list.map(\n (u) =>\n `${bullet}${st.code(u.scenario)} (${u.revisions.join(', ')}): ${st.text(u.reason)}`\n )\n ];\n}\n\n/**\n * One revision as Markdown: a table of what needs a look, then what the\n * client has not tried, then what passed. A revision the client reached\n * nothing at is one line.\n */\nfunction revisionMarkdown(\n col: ColumnReport,\n causes: ReadonlyMap,\n numbers: ReadonlyMap\n): string[] {\n const { problems, notTried, passed } = groupColumn(col);\n const rev = `**${mdText(col.revision)}**`;\n if (!problems.length && !passed.length) {\n return notTried.length\n ? ['', `${rev} — ${notTriedHeading(notTried.length, false)}.`]\n : [];\n }\n const row = (cell: CellReport) =>\n `| [${mdText(`${cell.revision} ${cell.scenario}`)}](${cell.resultsUrl}) ` +\n `| ${STATE_LABEL[cell.state]} | ${countsOf(cell)} | ` +\n `${\n cell.state === 'not-tried'\n ? notTriedText(cell, MARKDOWN)\n : happened(cell, causes, numbers, MARKDOWN).join('
')\n } |`;\n const out = [\n '',\n rev,\n '',\n '| Cell | Result | Pass / fail / warn | What happened |',\n '| --- | --- | --- | --- |',\n ...problems.map(row)\n ];\n if (notTried.length) {\n out.push(\n `| **${notTriedHeading(notTried.length, true)}** | | | ${NOT_TRIED_WHY} |`,\n ...notTried.map(row)\n );\n if (passed.length)\n out.push(`| **${passedHeading(passed.length)}** | | | |`);\n }\n out.push(...passed.map(row));\n return out;\n}\n\nexport function reportMarkdown(\n report: RunReport,\n links: MarkdownLinks\n): string {\n const causes = new Map(report.causes.map((c) => [c.key, c]));\n const numbers = causeNumbers(report.causes);\n const scope = report.revision ? ` at ${report.revision}` : '';\n const out = [\n `**MCP conformance: run ${mdCode(report.runId)}${scope}**`,\n '',\n ...summaryLines(report, links, MARKDOWN, '- ')\n ];\n if (report.causes.length) {\n out.push(\n '',\n '**What went wrong, by cause**',\n ...causeLines(report, MARKDOWN)\n );\n }\n const reached = anyReached(report);\n if (!reached) out.push('', 'No cell has been reached yet.');\n for (const col of report.columns) {\n out.push(...revisionMarkdown(col, causes, numbers));\n }\n if (reached) out.push('', LEGEND);\n out.push(...unavailableLines(report, MARKDOWN, (s) => `**${s}**`, '- '));\n return out.join('\\n') + '\\n';\n}\n\n/** One revision as plain lines, in the same groups as revisionMarkdown(). */\nfunction revisionText(\n col: ColumnReport,\n causes: ReadonlyMap,\n numbers: ReadonlyMap\n): string[] {\n const { problems, notTried, passed } = groupColumn(col);\n if (!problems.length && !passed.length) {\n return notTried.length\n ? ['', `${col.revision} — ${notTriedHeading(notTried.length, false)}.`]\n : [];\n }\n const bullet = (cell: CellReport) =>\n cell.state === 'not-tried'\n ? [\n `• ${cell.revision} ${cell.scenario}: ${STATE_LABEL[cell.state]} — ${cell.resultsUrl}`,\n ` ◦ ${notTriedText(cell, PLAIN)}`\n ]\n : [\n `• ${cell.revision} ${cell.scenario}: ${STATE_LABEL[cell.state]}, ${countsOf(cell)} — ${cell.resultsUrl}`,\n ...happened(cell, causes, numbers, PLAIN).map((l) => ` ◦ ${l}`)\n ];\n const out = [\n '',\n `${col.revision} (pass / fail / warn)`,\n ...problems.flatMap(bullet)\n ];\n if (notTried.length) {\n out.push(\n notTriedHeading(notTried.length, true),\n NOT_TRIED_WHY,\n ...notTried.flatMap(bullet)\n );\n if (passed.length) out.push(passedHeading(passed.length));\n }\n out.push(...passed.flatMap(bullet));\n return out;\n}\n\n/**\n * The same report as plain lines, for a chat that shows a Markdown table as\n * raw pipes (Slack): the summary, the causes, then each revision's groups,\n * one bullet per cell with what happened under it.\n */\nexport function reportText(report: RunReport, links: MarkdownLinks): string {\n const causes = new Map(report.causes.map((c) => [c.key, c]));\n const numbers = causeNumbers(report.causes);\n const scope = report.revision ? ` at ${report.revision}` : '';\n const out = [\n `MCP conformance: run ${report.runId}${scope}`,\n ...summaryLines(report, links, PLAIN, '• ')\n ];\n if (report.causes.length) {\n out.push('', 'What went wrong, by cause', ...causeLines(report, PLAIN));\n }\n const reached = anyReached(report);\n if (!reached) out.push('', 'No cell has been reached yet.');\n for (const col of report.columns) {\n out.push(...revisionText(col, causes, numbers));\n }\n if (reached) out.push('', LEGEND);\n out.push(...unavailableLines(report, PLAIN, (s) => s, '• '));\n return out.join('\\n') + '\\n';\n}\n","deleted",false,"label",[47,48,24],"src","hosted","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",0,"orgId","01a07c12-b73a-76de-b96a-421ce8582af6","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_9":10,"_105":-5},"org",{"_9":10,"_99":100,"_101":-5,"_58":-5,"_102":103,"_104":44},"branch",{"_37":89,"_11":90,"_22":30,"_91":49,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":12,"_98":10},"isOwned",396,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","MCP Conformance","avatar","tier","free","canRestrictVals","profileImageUrl","ctx",{"_82":-5,"_139":140,"_141":142,"_143":144,"_145":44,"_146":44,"_147":44,"_148":34,"_149":-5,"_150":-7,"_151":-7,"_152":66,"_153":44,"_154":44,"_155":-5,"_156":44,"_157":44,"_158":44,"_159":-5},"ENV",{"_110":111,"_112":113,"_114":90,"_115":116,"_117":118,"_119":120,"_121":122,"_123":124,"_125":126,"_127":128,"_129":130,"_131":132,"_133":134,"_135":136,"_137":138},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","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"]