[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8},"actionData","errors","root",{"_105":106,"_107":108},"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/cell-page.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":38,"_66":67,"_68":-5,"_69":-5,"_70":-5,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":82,"_83":84,"_85":86,"_87":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/cell-page.ts","extension","id","6b2a9304-c59d-4b03-b8a1-69af0578d0f1","cell-page.ts","fileId","03539db0-b021-11f1-b92e-1607ee4eb77e","parentId","11abc952-e3be-41e6-ac33-6929c3af1284","branchId","fdc11199-683b-41f1-a3c5-d5ac53972f86","branchVersion",388,"latest",true,"createdAt",["D",1789379126125],"version",0,"fileType","script","content","/**\n * The page about one cell, at its results path and its config path alike:\n * for the author of one client, debugging one failing test and running it\n * again, and for a server author reading that client's traffic.\n *\n * 1. the verdict, in a shape, a glyph and a word, and the attempt it is\n * from, with \"Reset this cell\" and the earlier attempts folded;\n * 2. for a failing or stopped cell, what to fix: the failing check in\n * words, the spec sentence, and the exchange that caused it, with the\n * offending field marked and expected against actual where the check\n * says both;\n * 3. the scenario's steps as a checklist, each tied to its exchanges;\n * 4. the traffic, one numbered list, with a gutter of three lanes (the\n * cell's MCP endpoint, metadata at its origin, its sign-in server);\n * 5. the passed checks, folded.\n *\n * The set-up (the MCP URL, the steps, the credentials and the env) is\n * folded below; client config files are the run page's. A frozen copy of\n * the cell renders the same data without the live parts.\n */\n\nimport type { CheckStatus, ConformanceCheck } from '../types.ts';\nimport { describeStep, type Step } from '../steps/index.ts';\nimport type { CellConfig, CellStatus } from './server.ts';\nimport type { CellRef } from './session.ts';\nimport type { CellState, Verdict } from './report.ts';\nimport type { ClientIdentity } from './identity.ts';\nimport type { ShownCheck } from './shown.ts';\nimport { STATE_GLYPH, STATE_LABEL, countsLine, utcMinute } from './markdown.ts';\nimport { summarize } from './report.ts';\nimport { isStatefulVersion } from '../connection/versions.ts';\nimport {\n connectionNumbers,\n exchangeFor,\n REFUSED_TEXT,\n type Exchange,\n type Lane\n} from './traffic.ts';\nimport {\n STATUS_STYLE,\n about,\n authSteps,\n copyScript,\n credentials,\n envPre,\n escapeHtml as esc,\n handNote,\n identityLine,\n liveNote,\n liveScript,\n page,\n prose,\n stepsOpen\n} from './html.ts';\nimport type { BuildInfo } from './build.ts';\nimport { configPicker, pickerScript } from './config-picker.ts';\nimport { serverName } from './client-config.ts';\n\nconst CHECK_GLYPH: Record = {\n SUCCESS: '✓',\n FAILURE: '✗',\n WARNING: '!',\n SKIPPED: '–',\n INFO: 'i'\n};\n\n/** An attempt before the current one, as its line on the page says it. */\nexport interface EarlierSummary {\n attempt: number;\n /** When a reset started it; absent for the first. */\n startedAt?: string;\n /** Its first and last request. */\n firstRequestAt?: string;\n lastRequestAt?: string;\n verdict: Verdict;\n state: CellState;\n /** What decided it, in one line: its first failure, or its note. */\n cause?: string;\n}\n\n/** What a cell's page shows; what a frozen copy of the cell stores. */\nexport interface CellPageData {\n ref: CellRef;\n /** The scenario's description. */\n description: string;\n status: CellStatus;\n shown: ShownCheck[];\n identities: ClientIdentity[];\n /** The current attempt (1 until the cell is reset). */\n attempt: number;\n /** When a reset started the current attempt. */\n resetAt?: string;\n earlier: EarlierSummary[];\n /** The current attempt's traffic, in time order. */\n traffic: { exchanges: Exchange[]; omitted: number };\n /** The MCP URL the client is given. */\n mcpUrl?: string;\n steps?: readonly Step[];\n}\n\n/** What only the live page has. */\nexport interface CellPageLive {\n /** The cell's config: the set-up section. */\n config?: CellConfig;\n /** Whether \"Reset this cell\" is offered. */\n resettable: boolean;\n}\n\n/** What only a frozen copy has. */\nexport interface CellPageFrozen {\n snapshotId: string;\n frozenAt: string;\n}\n\n/** Log rows the traffic list replaces: the scenarios' own request logs. */\nexport const LOG_ROW = /^(incoming|outgoing)-(auth-)?(request|response)$/;\n\n/** Hosted-layer bookkeeping never listed as a check (identity has its line). */\nconst UNLISTED = new Set(['hosted-client-identity']);\n\nconst LANE_TITLE: Record = {\n mcp: 'the cell’s MCP endpoint',\n metadata: 'metadata at the cell’s origin',\n 'sign-in': 'the sign-in server'\n};\n\nconst LANES: readonly Lane[] = ['mcp', 'metadata', 'sign-in'];\n\nconst cellCss = `\n .glyph{font-weight:700}\n .verdict{border-left:5px solid #d1d5db;padding:.5rem .75rem;margin:.75rem 0;\n border-radius:6px;background:#f9fafb}\n .verdict.fail{border-left-color:#dc2626}.verdict.pass{border-left-color:#16a34a}\n .verdict.waiting,.verdict.stopped,.verdict.incomplete,.verdict.in-progress{border-left-color:#d97706}\n .verdict .big{font-size:16px;font-weight:600}\n .attempts{border:1px solid #e5e7eb;border-radius:8px;padding:.5rem .75rem;margin:.5rem 0;background:#f9fafb}\n .fix{border:1px solid #fca5a5;border-radius:8px;padding:.5rem .75rem;margin:.75rem 0}\n .fix h2{margin:.2rem 0 .4rem}\n blockquote{margin:.4rem 0;padding:.2rem .75rem;border-left:3px solid #d1d5db}\n pre mark{background:#fee2e2;color:#991b1b;font-weight:700}\n ul.checklist{list-style:none;padding-left:0}\n ul.checklist li{margin:.25rem 0}\n table.traffic td,table.traffic th{font-size:12px;padding:.25rem .4rem}\n table.traffic td.lane{width:10px;padding:.25rem 1px;text-align:center;color:#6b7280}\n table.traffic td.lane.on{color:#111}\n table.traffic tr.bad td{background:#fef2f2}\n table.traffic tr.note td{color:#6b7280;font-style:italic;background:#fff}\n table.traffic td.t{white-space:nowrap;font-variant-numeric:tabular-nums}\n table.traffic tr:target td{background:#fef9c3}\n table.xa{width:auto}\n ul.urls{margin:.3rem 0;padding-left:1.25rem}\n .picker select{font:inherit;padding:1px 6px}\n .picker [data-pick]{margin-top:.4rem}\n`;\n\nfunction time(iso: string): string {\n return `${iso.slice(11, 23)}`;\n}\n\n/** \"2 minutes 10 seconds\". */\nfunction gapText(ms: number): string {\n const s = Math.round(ms / 1000);\n const m = Math.floor(s / 60);\n const parts: string[] = [];\n if (m) parts.push(`${m} minute${m === 1 ? '' : 's'}`);\n if (s % 60) parts.push(`${s % 60} second${s % 60 === 1 ? '' : 's'}`);\n return parts.join(' ') || '0 seconds';\n}\n\n/** A pause this long between two exchanges is said in words. */\nconst GAP_MS = 30_000;\n\nfunction statusText(status: number | undefined): string {\n return status === undefined ? 'stream open' : String(status);\n}\n\nfunction rpcText(e: Exchange): string {\n const rpc = e.rpc ?? [];\n if (!rpc.length) return '';\n return rpc\n .map((m) =>\n m.method\n ? `${m.method}${m.id !== undefined ? ` (id ${JSON.stringify(m.id)})` : ''}`\n : `response${m.id !== undefined ? ` to id ${JSON.stringify(m.id)}` : ''}`\n )\n .join(', ');\n}\n\nfunction pretty(text: string | undefined): string {\n if (!text) return '';\n try {\n return JSON.stringify(JSON.parse(text), null, 2);\n } catch {\n return text;\n }\n}\n\n/**\n * An exchange as text: the request line, its headers and body, then the\n * answer. Lines naming one of `fields` are marked; a field the request\n * should have carried and did not is added, marked, as \"missing\".\n */\nfunction exchangeText(\n e: Exchange,\n fields: readonly string[] = [],\n missing: readonly string[] = []\n): string {\n const lines: string[] = [`${e.method} ${e.path}`];\n for (const [k, v] of Object.entries(e.headers)) lines.push(`${k}: ${v}`);\n lines.push(\n `authorization: ${e.authorization}${\n e.refused === 'token' ? ' (issued before the reset; withheld)' : ''\n }`\n );\n if (e.body !== undefined) {\n lines.push('', ...pretty(e.body).split('\\n'));\n if (e.bodyBytes) lines.push(`… cut at 8 KB of ${e.bodyBytes} bytes`);\n }\n for (const f of missing) lines.push(`${f}: missing`);\n const answer: string[] = ['', `← ${statusText(e.status)}`];\n for (const [k, v] of Object.entries(e.responseHeaders ?? {}))\n answer.push(`${k}: ${v}`);\n if (e.responseBody !== undefined) {\n answer.push('', ...pretty(e.responseBody).split('\\n'));\n if (e.responseBytes)\n answer.push(`… cut at 8 KB of ${e.responseBytes} bytes`);\n }\n const marked = (line: string, i: number) => {\n const hit =\n i < lines.length &&\n (missing.some((f) => line === `${f}: missing`) ||\n fields.some((f) => {\n const lower = line.toLowerCase();\n const name = f.toLowerCase();\n return (\n lower.includes(`\"${name}\"`) ||\n lower.startsWith(`${name}:`) ||\n lower.includes(`${name}=`)\n );\n }));\n return hit ? `${esc(line)}` : esc(line);\n };\n return `

${[...lines, ...answer].map(marked).join('\\n')}

`;\n}\n\n/** Details keys that say nothing about which field was at fault. */\nconst GENERIC_KEYS = new Set([\n 'message',\n 'method',\n 'path',\n 'reason',\n 'errorMessage',\n 'untestable',\n 'token',\n 'scopes',\n 'mcpMethod',\n 'statusCode',\n 'headers',\n 'body'\n]);\n\nconst MISSING_VALUES = new Set(['(omitted)', '(missing)', 'missing', 'absent']);\n\n/** The fields a check's details point at, and which of them were missing. */\nfunction faultFields(c: ConformanceCheck): {\n fields: string[];\n missing: string[];\n} {\n const fields: string[] = [];\n const missing: string[] = [];\n for (const [k, v] of Object.entries(c.details ?? {})) {\n if (GENERIC_KEYS.has(k) || VALUE_KEY.test(k)) continue;\n if (typeof v === 'object' && v !== null) continue;\n if (/protocol.?version/i.test(k)) fields.push('mcp-protocol-version');\n else fields.push(k);\n if (typeof v === 'string' && MISSING_VALUES.has(v)) missing.push(k);\n }\n // A header the check names in words (\"Mcp-Method header value …\").\n const said = `${c.errorMessage ?? ''} ${c.description ?? ''}`;\n for (const m of said.matchAll(\n /\\b(mcp-[a-z]+(?:-[a-z]+)*|mcp-protocol-version)\\b/gi\n ))\n fields.push(m[1].toLowerCase());\n return { fields: Array.from(new Set(fields)), missing };\n}\n\n/** Details keys that hold a value compared, not a field's name. */\nconst VALUE_KEY = /^(expected|actual|received|got|sent)/i;\n\n/** Expected against actual, when the check's details say both. */\nfunction expectedActual(\n c: ConformanceCheck\n): Array<[string, unknown, unknown]> {\n const d = c.details ?? {};\n const out: Array<[string, unknown, unknown]> = [];\n for (const [k, v] of Object.entries(d)) {\n const m = /^expected(.*)$/i.exec(k);\n if (!m) continue;\n const rest = m[1];\n const lower = rest ? rest[0].toLowerCase() + rest.slice(1) : '';\n const candidates = rest\n ? [\n `actual${rest}`,\n `received${rest}`,\n `got${rest}`,\n lower,\n `${lower}Sent`\n ]\n : ['actual', 'received', 'got'];\n // Else the one \"actual…\" (or \"received…\") value the details give.\n const others = Object.keys(d).filter(\n (x) => x !== k && /^(actual|received|got)/i.test(x)\n );\n const found =\n candidates.find((x) => x in d && x !== k) ??\n (others.length === 1 ? others[0] : undefined);\n if (found) out.push([rest ? lower : 'value', v, d[found]]);\n }\n return out;\n}\n\n/** The spec references of a check that are about the cell's revision. */\nfunction referencesFor(c: ConformanceCheck, revision: string) {\n const refs = c.specReferences ?? [];\n const at = refs.filter((r) => r.url?.includes(`/specification/${revision}/`));\n if (at.length) return at;\n return refs.filter(\n (r) => !/\\/specification\\/\\d{4}-\\d{2}-\\d{2}\\//.test(r.url ?? '')\n );\n}\n\nfunction refsHtml(c: ConformanceCheck, revision: string): string {\n return referencesFor(c, revision)\n .map((r) =>\n r.url\n ? `${esc(r.id)}`\n : `${esc(r.id)}`\n )\n .join(' · ');\n}\n\n/** The check's requirement as the spec words it, when its description does. */\nfunction specSentence(c: ConformanceCheck): string | undefined {\n const d = c.description ?? '';\n return /\\b(MUST|SHOULD|SHALL|REQUIRED|MAY)\\b/.test(d) ? d : undefined;\n}\n\nfunction exchangeLink(i: number | undefined, exchanges: readonly Exchange[]) {\n if (i === undefined) return '';\n const e = exchanges[i];\n return ` exchange ${i + 1}`;\n}\n\nfunction verdictLine(data: CellPageData): string {\n const { status, shown } = data;\n const state = status.state;\n const glyph = STATE_GLYPH[state];\n const counted = shown.filter(\n (c) => c.status === 'SUCCESS' || (c.status === 'FAILURE' && !c.notSeen)\n );\n const failed = counted.filter((c) => c.status === 'FAILURE').length;\n const warnings = shown.filter((c) => c.status === 'WARNING').length;\n let text: string;\n if (state === 'pass') {\n text = `all ${counted.length} check${counted.length === 1 ? '' : 's'} passed${\n warnings ? `, with ${warnings} warning${warnings === 1 ? '' : 's'}` : ''\n }`;\n } else if (state === 'fail') {\n text = `${failed} of ${counted.length} checks failed`;\n } else if (status.verdict === 'n/a') {\n text = `the scenario does not apply to this revision: ${status.reason ?? ''}`;\n } else if (status.startable === false) {\n text = `not startable here: ${status.startReason ?? ''}`;\n } else {\n // The label says the state; the note need not say it again.\n text = (status.note ?? '').replace(/^stopped: /, '');\n }\n // Skipped checks are said apart: nothing was checked, so they are\n // neither a pass nor a failure.\n const counts = summarize(shown);\n // A pass or a fail already said its counts, unless there is more to say.\n const more = counts.notSeen + counts.warnings + counts.skipped > 0;\n const countsHtml =\n shown.length && (more || (state !== 'pass' && state !== 'fail'))\n ? `

${esc(countsLine(counts))}${\n counts.skipped\n ? ` · ${counts.skipped} skipped: the client did nothing they check`\n : ''\n }

`\n : '';\n return (\n `

` +\n `${esc(STATE_LABEL[state])}${text ? `: ${esc(text)}` : ''}` +\n countsHtml +\n `

Client: ${identityLine(data.identities)}

`\n );\n}\n\n/** \"Attempt 2 · started 06:50:12 by a reset\", the reset button, and earlier ones. */\nfunction attemptsBlock(\n data: CellPageData,\n resetUrl: string | undefined\n): string {\n const started = data.resetAt\n ? ` · started ${esc(time(data.resetAt))} UTC by a reset`\n : '';\n const head = `Attempt ${data.attempt}${started}`;\n const button = resetUrl\n ? ` ` +\n `

Keeps the MCP URL. Your client’s next request starts attempt ${data.attempt + 1}; ` +\n `what this attempt recorded stays, listed under it. On a sign-in cell it also forgets the ` +\n `registrations, codes and tokens this cell issued, so your client has to sign in again.

`\n : '';\n const earlier = data.earlier.length\n ? `

${data.earlier.length} earlier attempt${\n data.earlier.length === 1 ? '' : 's'\n }

Attempt ${a.attempt}${when ? ` · ${esc(time(when))} UTC` : ''} · ` +\n ` ${esc(\n STATE_LABEL[a.state]\n )}${a.cause ? ` — ${esc(a.cause)}` : ''}

`\n : '';\n if (data.attempt === 1 && !button && !earlier) return '';\n return `

${head}${button}${earlier}

`;\n}\n\n/** Each check's exchange, by index into the traffic. */\nfunction linker(exchanges: readonly Exchange[]) {\n const cache = new Map();\n return (c: ConformanceCheck) => {\n if (!cache.has(c)) cache.set(c, exchangeFor(c.timestamp, exchanges));\n return cache.get(c);\n };\n}\n\nfunction fixBlock(\n data: CellPageData,\n at: (c: ConformanceCheck) => number | undefined\n): string {\n const { exchanges } = data.traffic;\n const revision = data.ref.revision;\n if (data.status.state === 'stopped') {\n const last = exchanges.length - 1;\n const waiting = data.shown.filter((c) => c.notSeen);\n return (\n `

What to fix

Your client stopped${\n last >= 0\n ? ` after exchange ${last + 1} (${esc(\n `${exchanges[last].method} ${exchanges[last].path}`\n )} at ${esc(time(exchanges[last].at))} UTC)`\n : ''\n } and has sent nothing since. The flow was still waiting for:

${esc(c.id)} ${esc(c.reason ?? '')}

` +\n (last >= 0 ? exchangeText(exchanges[last]) : '') +\n `

Check your client’s log for an error after that request, then run it again` +\n ` (Reset this cell first to start clean).

`\n );\n }\n if (data.status.state !== 'fail') return '';\n const failures = data.shown.filter(\n (c) => c.status === 'FAILURE' && !c.notSeen\n );\n const shownHere = failures.slice(0, 3);\n const items = shownHere.map((c) => {\n const i = at(c);\n // Quoted when it says more than the reason already does.\n const requirement = specSentence(c);\n const sentence =\n requirement && !(c.reason ?? '').includes(requirement)\n ? requirement\n : undefined;\n const refs = refsHtml(c, revision);\n const { fields, missing } = faultFields(c);\n const pairs = expectedActual(c);\n const e = i === undefined ? undefined : exchanges[i];\n return (\n `

${esc(c.reason ?? c.name)} ` +\n `${esc(c.id)}

` +\n (sentence\n ? `

${esc(sentence)}

${refs ? `

${refs}

` : ''}`\n : refs\n ? `

${refs}

`\n : '') +\n (pairs.length\n ? `${pairs\n .map(\n ([k, want, got]) =>\n ``\n )\n .join('')}

	expected	your client sent
${esc(k)}	`${esc(JSON.stringify(want))}`	`${esc(\n JSON.stringify(got) ?? 'nothing'\n )}`

`\n : '') +\n (e\n ? `

It was decided by exchange ${i! + 1} (${esc(\n `${e.method} ${e.path}`\n )} at ${esc(time(e.at))} UTC):

${exchangeText(e, fields, missing)}`\n : `

No recorded exchange carries it${\n data.traffic.omitted ? ' (some traffic was not kept)' : ''\n }.

`)\n );\n });\n const more =\n failures.length > shownHere.length\n ? `

and ${failures.length - shownHere.length} more failing check${\n failures.length - shownHere.length === 1 ? '' : 's'\n } below.

`\n : '';\n return `

What to fix

${items.join('

')}${more}

`;\n}\n\ninterface StepLine {\n text: string;\n exchanges: number[];\n}\n\n/** The generic sign-in, as steps a client takes, each with its exchanges. */\nfunction authStepLines(\n scenario: string,\n exchanges: readonly Exchange[]\n): StepLine[] {\n const where = (pred: (e: Exchange) => boolean) =>\n exchanges.flatMap((e, i) => (pred(e) ? [i] : []));\n const route = (e: Exchange) => e.path.split('?')[0];\n const noSignIn = /^auth\\/(client-credentials-|wif-|enterprise-managed-)/.test(\n scenario\n );\n const lines: StepLine[] = [\n {\n text: 'ask for the MCP endpoint without a token; the cell answers 401',\n exchanges: where(\n (e) =>\n e.lane === 'mcp' && e.authorization === 'absent' && e.status === 401\n )\n },\n {\n text: 'find the protected-resource metadata',\n exchanges: where((e) =>\n route(e).startsWith('/.well-known/oauth-protected-resource')\n )\n },\n {\n text: 'find the sign-in server’s metadata',\n exchanges: where(\n (e) => e.lane === 'sign-in' && route(e).includes('/.well-known/')\n )\n }\n ];\n if (!noSignIn) {\n lines.push(\n {\n text: 'register the client, unless it has an id already',\n exchanges: where(\n (e) => e.lane === 'sign-in' && route(e).endsWith('/register')\n )\n },\n {\n text: 'send the person to sign in (the test server approves at once)',\n exchanges: where(\n (e) => e.lane === 'sign-in' && route(e).endsWith('/authorize')\n )\n }\n );\n }\n lines.push(\n {\n text: noSignIn\n ? 'get a token with the credentials the cell gives'\n : 'exchange the code for a token',\n exchanges: where(\n (e) => e.lane === 'sign-in' && route(e).endsWith('/token')\n )\n },\n {\n text: 'call the MCP endpoint with the token',\n exchanges: where(\n (e) =>\n e.lane === 'mcp' &&\n e.authorization === 'present' &&\n !e.refused &&\n (e.status ?? 0) < 400\n )\n }\n );\n return lines;\n}\n\nfunction methodsOf(e: Exchange): string[] {\n return (e.rpc ?? []).flatMap((m) => (m.method ? [m.method] : []));\n}\n\nfunction stepLines(\n data: CellPageData,\n exchanges: readonly Exchange[]\n): StepLine[] {\n if (data.ref.scenarioName.startsWith('auth/'))\n return authStepLines(data.ref.scenarioName, exchanges);\n const where = (pred: (e: Exchange) => boolean) =>\n exchanges.flatMap((e, i) => (pred(e) ? [i] : []));\n // The stateless wire has no handshake: a client may start with any call.\n const lines: StepLine[] = isStatefulVersion(data.ref.revision)\n ? [\n {\n text: 'connect (initialize)',\n exchanges: where((e) => methodsOf(e).includes('initialize'))\n }\n ]\n : [];\n for (const step of data.steps ?? []) {\n if (step.op === 'wait' || step.op === 'disconnect') {\n lines.push({ text: describeStep(step), exchanges: [] });\n continue;\n }\n lines.push({\n text: describeStep(step),\n exchanges: where(\n (e) =>\n methodsOf(e).includes(step.op) &&\n (step.op !== 'tools/call' ||\n (e.body ?? '').includes(`\"name\":\"${step.name}\"`) ||\n e.headers['mcp-name'] === step.name)\n )\n });\n }\n return lines;\n}\n\nfunction checklist(data: CellPageData, failedAt: ReadonlySet): string {\n const { exchanges } = data.traffic;\n const lines = stepLines(data, exchanges);\n if (!lines.length) return '';\n const items = lines.map((line) => {\n const bad = line.exchanges.some((i) => failedAt.has(i));\n const done = line.exchanges.length > 0;\n const glyph = bad ? '✗' : done ? '✓' : '○';\n const word = bad ? 'failed' : done ? 'seen' : 'not seen yet';\n const links = line.exchanges\n .slice(0, 8)\n .map((i) => `#${i + 1}`)\n .join(', ');\n const more =\n line.exchanges.length > 8 ? ` and ${line.exchanges.length - 8} more` : '';\n return (\n `

${word}: ` +\n `${esc(line.text)}${links ? ` ${links}${more}` : ''}

`\n );\n });\n return (\n `

Steps of this scenario

What a client does here, each tied to the ` +\n `exchanges that did it. A step your client skips may be fine: the checks decide.

` +\n `

${items.join('')}`\n );\n}\n\nfunction trafficTable(\n data: CellPageData,\n failedAt: ReadonlyMap,\n trafficUrl: string | undefined\n): string {\n const { exchanges, omitted } = data.traffic;\n const download = trafficUrl\n ? ` Download traffic (JSON lines)`\n : '';\n if (!exchanges.length) {\n return (\n `

Traffic

No request has reached this ` +\n `attempt yet.${download}

`\n );\n }\n const conns = connectionNumbers(exchanges);\n const rows: string[] = [];\n let prev: Exchange | undefined;\n const opened = new Set();\n exchanges.forEach((e, i) => {\n if (prev) {\n const gap = Date.parse(e.at) - Date.parse(prev.at) - (prev.ms ?? 0);\n if (gap >= GAP_MS)\n rows.push(\n `${esc(gapText(gap))} with no request.`\n );\n }\n const n = e.conn !== undefined ? conns.get(e.conn) : undefined;\n if (n !== undefined && !opened.has(n)) {\n opened.add(n);\n if (conns.size > 1)\n rows.push(\n `Connection ${n} opens${\n e.conn?.startsWith('s:')\n ? ` (MCP session ${esc(e.conn.slice(2, 14))})`\n : ''\n }.`\n );\n }\n const lanes = LANES.map(\n (l) =>\n `${\n l === e.lane ? '●' : '·'\n }`\n ).join('');\n const rpc = rpcText(e);\n const failed = failedAt.get(i);\n const marks = [\n failed ? `✗ check failed here ${esc(failed)}` : '',\n e.refused\n ? `↺ ${esc(REFUSED_TEXT[e.refused])} issued before the reset, refused`\n : '',\n e.repeats ? `×${e.repeats + 1}` : ''\n ].filter(Boolean);\n const summary =\n `${esc(e.method)} ${esc(e.path.length > 90 ? e.path.slice(0, 90) + '…' : e.path)}` +\n (rpc ? ` · ${esc(rpc)}` : '') +\n (e.role && e.role !== 'as'\n ? ` (${esc(e.role)})`\n : '');\n rows.push(\n `${i + 1}${lanes}` +\n `${esc(time(e.at))}${n ?? '–'}` +\n `

${summary}

${exchangeText(e)}

` +\n `${marks.length ? `

${marks.join(' · ')}

` : ''}` +\n `${esc(e.headers['mcp-protocol-version'] ?? '–')}` +\n `${esc(e.authorization)}${esc(statusText(e.status))}`\n );\n prev = e;\n });\n const cut = omitted\n ? `

${omitted} more exchange${omitted === 1 ? ' was' : 's were'} not kept: ` +\n `a cell keeps at most 150 per process and attempt.

`\n : '';\n const lanesKey = LANES.map((l) => `● ${esc(LANE_TITLE[l])}`).join(' · ');\n return (\n `

Traffic: ${exchanges.length} exchange${exchanges.length === 1 ? '' : 's'}` +\n `${conns.size > 1 ? ` on ${conns.size} connections` : ''}

` +\n `

Every request your client sent this cell, in order. The three columns after # say ` +\n `where it went, left to right: ${lanesKey}. Authorization only ever reads present or absent, ` +\n `never its value. Open a row for its headers and bodies.${download}

` +\n `` +\n `` +\n rows.join('') +\n `

#	to			time (UTC)	conn	request	MCP-Protocol-Version	Authorization	status

${cut}`\n );\n}\n\nfunction checkItem(\n c: ShownCheck,\n data: CellPageData,\n at: (c: ConformanceCheck) => number | undefined\n): string {\n const glyph = c.notSeen ? '○' : CHECK_GLYPH[c.status];\n const word = c.notSeen ? 'not seen' : c.status.toLowerCase();\n const refs = refsHtml(c, data.ref.revision);\n const said = c.reason ?? c.description;\n return (\n `

` +\n ` ${esc(word)} ${esc(c.id)} ` +\n `${esc(said ?? '')}${c.repeats ? ` recorded ${c.repeats} times` : ''}` +\n `${exchangeLink(at(c), data.traffic.exchanges)}${refs ? ` ${refs}` : ''}` +\n // A row led by its reason keeps what the check is about below it.\n (c.reason && about(c) ? `

${about(c)}

` : '') +\n (c.details || c.errorMessage\n ? `

details

${esc(\n          JSON.stringify(\n            { errorMessage: c.errorMessage, ...c.details },\n            null,\n            2\n          )\n        )}

`\n : '') +\n `

`\n );\n}\n\nfunction checkSections(\n data: CellPageData,\n at: (c: ConformanceCheck) => number | undefined\n): string {\n const listed = data.shown.filter(\n (c) => !LOG_ROW.test(c.id) && !UNLISTED.has(c.id)\n );\n const list = (rows: ShownCheck[]) =>\n `

${rows.map((c) => checkItem(c, data, at)).join('')}`;\n const failing = listed.filter((c) => c.status === 'FAILURE' && !c.notSeen);\n const waiting = listed.filter((c) => c.notSeen);\n const warnings = listed.filter((c) => c.status === 'WARNING' && !c.notSeen);\n const passed = listed.filter((c) => c.status === 'SUCCESS');\n const other = listed.filter(\n (c) => c.status === 'SKIPPED' || c.status === 'INFO'\n );\n const out: string[] = [];\n if (failing.length) out.push(`

Failed checks

${list(failing)}`);\n if (waiting.length)\n out.push(\n `

Not seen yet

The scenario still expects these; nothing ` +\n `your client did has failed them.

${list(waiting)}`\n );\n if (warnings.length) out.push(`

Warnings

${list(warnings)}`);\n if (passed.length)\n out.push(\n `

✓ ${passed.length} passed check${\n passed.length === 1 ? '' : 's'\n }

${list(passed)}

`\n );\n if (other.length)\n out.push(\n `

${other.length} note${\n other.length === 1 ? '' : 's'\n } and skipped check${other.length === 1 ? '' : 's'}

${list(other)}

`\n );\n return out.join('');\n}\n\nfunction setupSection(data: CellPageData, live: CellPageLive): string {\n const cell = live.config;\n const runPage = `/s/${esc(data.ref.runId)}`;\n if (!cell) {\n return `

Set-up

${esc(\n data.status.startReason ??\n data.status.reason ??\n 'This cell cannot be started here.'\n )}

`;\n }\n const steps = cell.steps\n ? `

Steps

What to make the client do here. A generic client reads the same steps from MCP_CONFORMANCE_CONTEXT.steps.

${stepsOpen(\n cell.steps\n )}`\n : authSteps(data.ref.scenarioName)\n .replace(/

/g, '

')\n .replace(/<\\/h2>/g, '

');\n const picker = configPicker(\n [{ name: serverName(cell.revision, cell.scenario), url: cell.url }],\n {\n urlPanel: `

${esc(cell.url)}

`\n }\n );\n return (\n `

Set-up: the MCP URL, steps and credentials

` +\n `

MCP endpoint

${picker}` +\n `

Every cell of the run, and composites that carry several, are on ` +\n `the run page.

` +\n handNote(data.ref.scenarioName) +\n credentials(cell)\n .replace(/

/g, '

')\n .replace(/<\\/h2>/g, '

') +\n steps +\n `

Environment

What the CLI runner would set for a scripted client.

${envPre(cell)}` +\n `

`\n );\n}\n\n/** The cell's page, live (`live`) or as a frozen copy (`frozen`). */\nexport function renderCell(\n data: CellPageData,\n opts: {\n live?: CellPageLive;\n frozen?: CellPageFrozen;\n build?: BuildInfo | null;\n }\n): string {\n const { ref } = data;\n const run = esc(ref.runId);\n const cellPath = `${esc(ref.runId)}/${esc(ref.revision)}/${esc(ref.scenarioName)}`;\n const at = linker(data.traffic.exchanges);\n const failedAt = new Map();\n for (const c of data.shown) {\n if (c.status !== 'FAILURE' || c.notSeen) continue;\n const i = at(c);\n if (i !== undefined && !failedAt.has(i)) failedAt.set(i, c.id);\n }\n const frozen = opts.frozen;\n const live = opts.live;\n const reportUrl = frozen\n ? `/results/${run}/snapshot/${esc(frozen.snapshotId)}`\n : `/results/${run}`;\n const trafficUrl = frozen\n ? `/results/${run}/snapshot/${esc(frozen.snapshotId)}/${esc(ref.revision)}/${esc(ref.scenarioName)}/traffic.jsonl`\n : `/results/${cellPath}/traffic.jsonl`;\n const crumbs =\n `

run ${run} › ` +\n `results${frozen ? ` (frozen ${esc(utcMinute(frozen.frozenAt))})` : ''} › ` +\n `${esc(ref.revision)} › ${esc(ref.scenarioName)}

`;\n const url = data.mcpUrl\n ? `

MCP URL ${esc(data.mcpUrl)} ${live ? ' set-up and steps ↓' : ''}

`\n : '';\n const frozenNote = frozen\n ? `

A frozen copy of this cell, taken ${esc(utcMinute(frozen.frozenAt))}: ` +\n `later traffic does not change it. The live page has anything since.

`\n : '';\n const resetUrl =\n live?.resettable && !frozen ? `/results/${cellPath}/reset` : undefined;\n const body =\n `

`${esc(ref.scenarioName)}` at ${esc(ref.revision)}

` +\n crumbs +\n `

${prose(data.description, true)}

` +\n url +\n frozenNote +\n (frozen ? '' : liveNote) +\n `

` +\n attemptsBlock(data, resetUrl) +\n verdictLine(data) +\n fixBlock(data, at) +\n checklist(data, new Set(failedAt.keys())) +\n trafficTable(data, failedAt, trafficUrl) +\n checkSections(data, at) +\n `

` +\n (live ? setupSection(data, live) + pickerScript : '') +\n (frozen ? '' : liveScript) +\n copyScript;\n return page(\n `${ref.scenarioName} at ${ref.revision} — ${ref.runId}`,\n `${body}`,\n opts.build\n );\n}\n\n/** An earlier attempt's cause in one line: its first failure, or its note. */\nexport function earlierCause(\n shown: readonly ShownCheck[],\n note: string | undefined\n): string | undefined {\n const failure = shown.find((c) => c.status === 'FAILURE' && !c.notSeen);\n if (failure) return `${failure.id}: ${failure.reason ?? failure.name}`;\n return note;\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","orgId","01a07c12-b73a-76de-b96a-421ce8582af6","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_9":10,"_104":-5},"org",{"_9":10,"_98":99,"_100":-5,"_58":-5,"_101":102,"_103":44},"branch",{"_37":88,"_11":89,"_22":30,"_90":49,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":12,"_97":10},"isOwned",396,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","MCP Conformance","avatar","tier","free","canRestrictVals","profileImageUrl","ctx",{"_81":-5,"_138":139,"_140":141,"_142":143,"_144":44,"_145":44,"_146":44,"_147":34,"_148":-5,"_149":-7,"_150":-7,"_151":38,"_152":44,"_153":44,"_154":-5,"_155":44,"_156":44,"_157":44,"_158":-5},"ENV",{"_109":110,"_111":112,"_113":89,"_114":115,"_116":117,"_118":119,"_120":121,"_122":123,"_124":125,"_126":127,"_128":129,"_130":131,"_132":133,"_134":135,"_136":137},"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"]

What to fix

What to fix

Steps of this scenario

Traffic

Traffic: ${exchanges.length} exchange${exchanges.length === 1 ? '' : 's'}` +\n `${conns.size > 1 ? ` on ${conns.size} connections` : ''}

Failed checks

Not seen yet

Warnings

Steps

/g, '

')\n .replace(/<\\/h2>/g, '

MCP endpoint

/g, '

')\n .replace(/<\\/h2>/g, '

Environment

${esc(ref.scenarioName)} at ${esc(ref.revision)}

`${esc(ref.scenarioName)}` at ${esc(ref.revision)}