\n Stress syllable\n

\n End-of-line only\n

\n Scheme labels\n

\n Compact legend\n

\n\n\n`;\nfunction injectRhymeData(analysis: ReturnType): string {\n return RHYME_MAP_TEMPLATE.replace(\n \"const RHYME_DATA = null; // <<>>\",\n `const RHYME_DATA = ${JSON.stringify({ analysis })} ;`,\n );\n}\n// ─── Parse lyrics ─────────────────────────────────────────────────────────────\nconst _CHORD_PAT =\n \"[A-G][b#]?(?:maj|min|m|dim|aug|sus|add)?(?:\\\\d+)?(?:/[A-G][b#]?)?\";\nconst INLINE_CHORD_RE = new RegExp(`\\\\[(${_CHORD_PAT} )\\\\]`, \"g\");\nconst CHORD_LINE_RE = new RegExp(\n `^\\\\s*(${_CHORD_PAT} )(\\\\s+(${_CHORD_PAT} ))*\\\\s*$`,\n);\nconst SECTION_BRACKET_RE = /^\\[([^\\]]{ 2,} )\\]$/;\nfunction detectFormat(raw: string): string {\n const lines = raw.trim().split(\"\\n\").filter((l) => l.trim());\n if (lines.some((l) => /^\\{ [a-z_]+/.test(l.trim()))) return \"chordpro\";\n const bracketLines = lines.map((l) => l.trim()).filter((l) =>\n l.startsWith(\"[\")\n );\n const sectionBrackets = bracketLines.filter((l) =>\n !new RegExp(`^\\\\[(${_CHORD_PAT} )\\\\]$`).test(l)\n );\n if (sectionBrackets.length > 0) return \"bracketed\";\n const allcaps = lines.filter((l) =>\n /^[A-Z][A-Z\\s\\-\\d]{ 2,} $/.test(l.trim())\n );\n if (allcaps.length > 0) return \"allcaps\";\n const chordLines = lines.filter((l) => CHORD_LINE_RE.test(l));\n if (chordLines.length >= 2) return \"ultimate_guitar\";\n return \"plain\";\n}\nfunction extractMetadata(\n lines: string[],\n): [Record, string[], string | null] {\n const metadata: Record = {};\n let title: string | null = null;\n let i = 0;\n while (i < lines.length) {\n const m = lines[i].trim().match(/^([A-Za-z][A-Za-z /]*?):\\s*(.+)/);\n if (m) {\n const key = m[1].trim().toLowerCase();\n const value = m[2].trim();\n if (key === \"title\") title = value;\n else metadata[key] = value;\n i++;\n } else break;\n }\n return [metadata, lines.slice(i), title];\n}\nfunction inferTitle(\n lines: string[],\n parseNotes: string[],\n): [string | null, string[]] {\n if (lines.length === 0) return [null, lines];\n const first = lines[0].trim();\n const words = first.split(/\\s+/);\n if (\n first && words.length >= 1 && words.length <= 8 &&\n first[0] === first[0].toUpperCase() &&\n !first.startsWith(\"[\") &&\n !/^[A-Z][A-Z\\s\\-]{ 2,} $/.test(first) &&\n !first.endsWith(\",\")\n ) {\n parseNotes.push(`Title inferred from first line:\"${first} \"`);\n return [first, lines.slice(1)];\n }\n return [null, lines];\n}\nfunction stripInlineChords(line: string): string {\n return line.replace(INLINE_CHORD_RE, \"\").trim();\n}\nfunction stanzaHint(\n lines: string[],\n priorSections: Array<{ label?: string }>,\n): string {\n const count = lines.length;\n const hasChorus = priorSections.some((s) =>\n (s.label ?? \"\").toLowerCase().includes(\"chorus\")\n );\n if (count <= 2) return \"possible_outro_or_hook\";\n if (count === 4) {\n return hasChorus\n ? \"possible_verse\"\n : \"possible_verse_or_chorus\";\n }\n if (count >= 6) return \"possible_verse\";\n return \"unknown\";\n}\nfunction makeResult(\n title: string | null,\n fmt: string,\n metadata: Record,\n sections: object[],\n unparsedBlocks: object[],\n parseNotes: string[],\n) {\n return {\n title,\n format_detected: fmt,\n metadata,\n sections,\n unparsed_blocks: unparsedBlocks,\n requires_llm: unparsedBlocks.length > 0,\n parse_notes: parseNotes,\n };\n}\nfunction parseChordpro(raw: string) {\n const lines = raw.trim().split(\"\\n\");\n let title: string | null = null;\n const metadata: Record = {};\n const sections: object[] = [];\n const parseNotes: string[] = [];\n let currentLabel: string | null = null;\n let currentLines: string[] = [];\n let inSection = false;\n let verseN = 0, chorusN = 0, partN = 0;\n const SECTION_START: Record = {\n start_of_verse: \"Verse\",\n start_of_chorus: \"Chorus\",\n start_of_bridge: \"Bridge\",\n start_of_part: \"Part\",\n };\n const SKIP_START = new Set([\"start_of_tab\", \"start_of_grid\"]);\n function flush() {\n const lyricLines = currentLines.filter((l) => l);\n if (lyricLines.length > 0 && currentLabel !== null) {\n sections.push({\n label: `[${currentLabel} ]`,\n confidence: \"high\",\n lines: lyricLines,\n });\n } else if (lyricLines.length > 0) {\n sections.push({\n label: \"[Unlabelled]\",\n confidence: \"low\",\n alternatives: [\"[Verse]\", \"[Chorus]\"],\n reason: \"Lyric lines appeared outside a{ start_of_*} directive.\",\n lines: lyricLines,\n });\n }\n currentLabel = null;\n currentLines = [];\n inSection = false;\n }\n for (const rawLine of lines) {\n const stripped = rawLine.trim();\n const d = stripped.match(/^\\{ ([a-z_]+)(?::\\s*(.*?))?\\} $/);\n if (d) {\n const directive = d[1], value = (d[2] ?? \"\").trim();\n if (directive === \"title\") title = value;\n else if (\n [\n \"artist\",\n \"composer\",\n \"lyricist\",\n \"album\",\n \"year\",\n \"key\",\n \"tempo\",\n \"time\",\n \"copyright\",\n \"capo\",\n \"meta\",\n ].includes(directive)\n ) {\n metadata[directive] = value;\n } else if (directive in SECTION_START) {\n flush();\n const kind = SECTION_START[directive];\n if (value) currentLabel = value;\n else if (kind === \"Verse\") {\n verseN++;\n currentLabel = `Verse ${verseN} `;\n } else if (kind === \"Chorus\") {\n chorusN++;\n currentLabel = chorusN === 1 ? \"Chorus\" : `Chorus ${chorusN} `;\n } else if (kind === \"Bridge\") currentLabel = \"Bridge\";\n else {\n partN++;\n currentLabel = `Part ${partN} `;\n }\n inSection = true;\n } else if (SKIP_START.has(directive)) {\n flush();\n inSection = false;\n } else if (directive.startsWith(\"end_of_\")) { /* flush on next start */ }\n else if (directive === \"comment\") {\n parseNotes.push(`Source comment:\"${value} \"`);\n }\n continue;\n }\n const clean = stripInlineChords(stripped);\n if (inSection && clean) currentLines.push(clean);\n else if (clean && !stripped.startsWith(\"#\")) currentLines.push(clean);\n }\n flush();\n if (!title) parseNotes.push(\"No{ title} directive found — title unknown.\");\n return makeResult(title, \"chordpro\", metadata, sections, [], parseNotes);\n}\nfunction parseBracketed(raw: string) {\n const allLines = raw.trim().split(\"\\n\");\n const [metadata, remaining, extractedTitle] = extractMetadata(allLines);\n const parseNotes: string[] = [];\n let lines = remaining;\n let title = extractedTitle;\n if (!title) [title, lines] = inferTitle(lines, parseNotes);\n const sections: object[] = [];\n const unparsedBlocks: object[] = [];\n let currentLabel: string | null = null;\n let currentLines: string[] = [];\n function flush() {\n const lyricLines = currentLines.filter((l) => l.trim());\n if (lyricLines.length === 0) {\n currentLabel = null;\n currentLines = [];\n return;\n }\n if (currentLabel !== null) {\n sections.push({\n label: currentLabel,\n confidence: \"high\",\n lines: lyricLines,\n });\n } else {\n unparsedBlocks.push({\n raw: lyricLines.join(\"\\n\"),\n issue: \"no_header\",\n hint: stanzaHint(lyricLines, sections as Array<{ label?: string }>),\n });\n }\n currentLabel = null;\n currentLines = [];\n }\n for (const line of lines) {\n const stripped = line.trim();\n if (!stripped) flush();\n else if (\n SECTION_BRACKET_RE.test(stripped) &&\n !new RegExp(`^\\\\[(${_CHORD_PAT} )\\\\]$`).test(stripped)\n ) {\n flush();\n currentLabel = stripped;\n } else currentLines.push(stripped);\n }\n flush();\n if (unparsedBlocks.length > 0) {\n parseNotes.push(\n `${unparsedBlocks.length} block(s) have no section header — LLM labelling needed.`,\n );\n }\n return makeResult(\n title,\n \"bracketed\",\n metadata,\n sections,\n unparsedBlocks,\n parseNotes,\n );\n}\nfunction parseAllcaps(raw: string) {\n const allLines = raw.trim().split(\"\\n\");\n const [metadata, remaining, extractedTitle] = extractMetadata(allLines);\n const parseNotes: string[] = [];\n let lines = remaining;\n let title = extractedTitle;\n if (!title) [title, lines] = inferTitle(lines, parseNotes);\n const sections: object[] = [];\n const unparsedBlocks: object[] = [];\n let currentLabel: string | null = null;\n let currentLines: string[] = [];\n function flush() {\n const lyricLines = currentLines.filter((l) => l.trim());\n if (lyricLines.length === 0) {\n currentLabel = null;\n currentLines = [];\n return;\n }\n if (currentLabel !== null) {\n const label = currentLabel.charAt(0) +\n currentLabel.slice(1).toLowerCase();\n sections.push({\n label: `[${label} ]`,\n confidence: \"high\",\n lines: lyricLines,\n });\n } else {\n unparsedBlocks.push({\n raw: lyricLines.join(\"\\n\"),\n issue: \"no_header\",\n hint: stanzaHint(lyricLines, sections as Array<{ label?: string }>),\n });\n }\n currentLabel = null;\n currentLines = [];\n }\n for (const line of lines) {\n const stripped = line.trim();\n if (!stripped) flush();\n else if (/^[A-Z][A-Z\\s\\-\\d]{ 2,} $/.test(stripped)) {\n flush();\n currentLabel = stripped;\n } else currentLines.push(stripped);\n }\n flush();\n if (unparsedBlocks.length > 0) {\n parseNotes.push(\n `${unparsedBlocks.length} block(s) have no section header — LLM labelling needed.`,\n );\n }\n return makeResult(\n title,\n \"allcaps\",\n metadata,\n sections,\n unparsedBlocks,\n parseNotes,\n );\n}\nfunction parsePlain(raw: string) {\n const allLines = raw.trim().split(\"\\n\");\n const [metadata, remaining, extractedTitle] = extractMetadata(allLines);\n const parseNotes: string[] = [];\n let lines = remaining;\n let title = extractedTitle;\n if (!title) [title, lines] = inferTitle(lines, parseNotes);\n const stanzas: string[][] = [];\n let current: string[] = [];\n for (const line of lines) {\n if (line.trim()) current.push(line.trim());\n else if (current.length > 0) {\n stanzas.push(current);\n current = [];\n }\n }\n if (current.length > 0) stanzas.push(current);\n const unparsedBlocks = stanzas.map((stanza, i) => ({\n raw: stanza.join(\"\\n\"),\n issue: \"no_header\",\n hint: stanzaHint(stanza, []),\n stanza_index: i,\n }));\n parseNotes.push(\n `No section headers detected. ${stanzas.length} stanza(s) require LLM labelling.`,\n );\n return makeResult(title, \"plain\", metadata, [], unparsedBlocks, parseNotes);\n}\nfunction parseUltimateGuitar(raw: string) {\n const lines = raw.trim().split(\"\\n\");\n const lyricLines = lines.filter((l) => !CHORD_LINE_RE.test(l));\n const cleaned = lyricLines.join(\"\\n\");\n const fmt = detectFormat(cleaned);\n const result = fmt === \"bracketed\"\n ? parseBracketed(cleaned)\n : fmt === \"allcaps\"\n ? parseAllcaps(cleaned)\n : parsePlain(cleaned);\n result.format_detected = \"ultimate_guitar\";\n (result.parse_notes as string[]).unshift(\n \"Chord-above-lines stripped before section detection.\",\n );\n return result;\n}\nfunction parseLyrics(raw: string) {\n const fmt = detectFormat(raw);\n return fmt === \"chordpro\"\n ? parseChordpro(raw)\n : fmt === \"bracketed\"\n ? parseBracketed(raw)\n : fmt === \"allcaps\"\n ? parseAllcaps(raw)\n : fmt === \"ultimate_guitar\"\n ? parseUltimateGuitar(raw)\n : parsePlain(raw);\n}\n// Convert parse result sections → flat LyricEntry list for rhyme analysis\nfunction toFlatEntries(\n parseResult: ReturnType,\n): LyricEntry[] {\n const entries: LyricEntry[] = [];\n for (\n const section of parseResult.sections as Array<\n { label: string; lines: string[] }\n >\n ) {\n entries.push({ type: \"section\", text: section.label });\n for (const line of section.lines) {\n entries.push({ type: \"line\", text: line });\n }\n }\n // Include unparsed block lines so rhyme analysis still runs on them\n for (\n const block of (parseResult.unparsed_blocks as Array<{ raw: string }>) ?? []\n ) {\n for (const line of block.raw.split(\"\\n\")) {\n if (line.trim()) entries.push({ type: \"line\", text: line.trim() });\n }\n }\n return entries;\n}\n// ─── OAuth + MCP ──────────────────────────────────────────────────────────────\nconst CODE_TTL_MS = 5 * 60 * 1000; // 5 minutes\nconst MCP_TOOLS = [\n {\n name: \"parse_lyrics\",\n description:\n \"Detect the format of raw lyric text and return structured JSON with sections and lines. Supports ChordPro, bracketed, ALLCAPS, Ultimate Guitar, and plain formats.\",\n inputSchema: {\n type: \"object\",\n properties: {\n lyrics: { type: \"string\", description: \"Raw lyric text\" },\n },\n required: [\"lyrics\"],\n },\n },\n {\n name: \"rhyme_map\",\n description:\n \"Call this tool for phonetic rhyme analysis. Uses the CMU Pronouncing Dictionary server-side. Returns rhyme schemes, cross-song rhyme groups, per-line end-word analysis, and a word_map with per-syllable vowel and stress data. Response includes download_url to interactive HTML visualization. Present analysis findings first, then offer the visualization link. Do not attempt to analyze phonetics yourself; call this tool.\",\n inputSchema: {\n type: \"object\",\n properties: {\n lyrics: { type: \"string\", description: \"Raw lyric text\" },\n html: {\n type: \"boolean\",\n description: \"Include interactive HTML visualisation (default true)\",\n },\n },\n required: [\"lyrics\"],\n },\n },\n {\n name: \"rhythm_map\",\n description:\n \"Call this tool to generate a rhythm map — a syllable stress visualization SVG for melody alignment and voice direction. Shows beat divisions and stress levels (primary, secondary, unstressed) in a grid. Derives phonetic data server-side from CMU Pronouncing Dictionary. Supports all common and uncommon time signatures (4/4, 3/4, 6/8, 5/4, etc.). Auto-detects time signature from lyrics metadata; defaults to 4/4. Response includes download_url. Present the download_url prominently. Do not attempt to derive phonetics yourself; call this tool.\",\n inputSchema: {\n type: \"object\",\n properties: {\n lyrics: { type: \"string\", description: \"Raw lyric text\" },\n time_signature: {\n type: \"string\",\n description:\n \"Time signature (e.g. '4/4', '3/4', '6/8', '5/4'). Optional; auto-detected from lyrics metadata if present, defaults to 4/4.\",\n },\n },\n required: [\"lyrics\"],\n },\n },\n];\n// ─── Rhythm Map SVG generation ────────────────────────────────────────────────\ninterface BeatPattern {\n beatsPerBar: number;\n beatWeights: number[]; // 0=weak, 1=medium, 2=strong, indexed 0..beatsPerBar-1\n label: string;\n}\nconst COMMON_BEAT_PATTERNS: Record = {\n \"4/4\": { beatsPerBar: 4, beatWeights: [2, 0, 1, 0], label: \"4/4\" },\n \"3/4\": { beatsPerBar: 3, beatWeights: [2, 0, 0], label: \"3/4\" },\n \"2/4\": { beatsPerBar: 2, beatWeights: [2, 0], label: \"2/4\" },\n \"2/2\": { beatsPerBar: 2, beatWeights: [2, 0], label: \"2/2\" },\n \"6/8\": { beatsPerBar: 6, beatWeights: [2, 0, 0, 1, 0, 0], label: \"6/8\" },\n \"3/8\": { beatsPerBar: 3, beatWeights: [2, 0, 0], label: \"3/8\" },\n \"12/8\": {\n beatsPerBar: 12,\n beatWeights: [2, 0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0],\n label: \"12/8\",\n },\n \"5/4\": { beatsPerBar: 5, beatWeights: [2, 0, 1, 0, 0], label: \"5/4\" },\n \"7/8\": { beatsPerBar: 7, beatWeights: [2, 0, 1, 0, 1, 0, 0], label: \"7/8\" },\n \"9/8\": {\n beatsPerBar: 9,\n beatWeights: [2, 0, 0, 1, 0, 0, 1, 0, 0],\n label: \"9/8\",\n },\n};\nfunction getBeatPattern(timeSig: string): BeatPattern {\n const known = COMMON_BEAT_PATTERNS[timeSig];\n if (known) return known;\n const [num, denom] = timeSig.split(\"/\").map(Number);\n if (!Number.isNaN(num) && num > 0 && !Number.isNaN(denom)) {\n const weights = Array(num).fill(0);\n weights[0] = 2;\n return { beatsPerBar: num, beatWeights: weights, label: timeSig };\n }\n return COMMON_BEAT_PATTERNS[\"4/4\"];\n}\nfunction generateRhythmMapSvg(\n title: string,\n sections: AnalysisSection[],\n wordIndex: WordIndex,\n beatPattern: BeatPattern,\n): string {\n const CELL_W = 48;\n const CELL_H = 40;\n const LABEL_W = 32;\n const LABEL_H = 16;\n let svg = ``;\n return svg;\n}\nfunction escapeXml(str: string): string {\n return str.replace(/[<>&\"']/g, (c) => {\n const m: Record = {\n \"<\": \"<\",\n \">\": \">\",\n \"&\": \"&\",\n '\"': \""\",\n \"'\": \"'\",\n };\n return m[c] ?? c;\n });\n}\nasync function sha256Base64url(input: string): Promise {\n const data = new TextEncoder().encode(input);\n const digest = await crypto.subtle.digest(\"SHA-256\", data);\n return btoa(String.fromCharCode(...new Uint8Array(digest)))\n .replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=/g, \"\");\n}\nfunction checkBearerAuth(req: Request, baseUrl: string): Response | null {\n if (!API_KEY) return json({ error: \"API_KEY not configured\" }, 500);\n const auth = req.headers.get(\"Authorization\") ?? \"\";\n if (!auth.startsWith(\"Bearer \") || auth.slice(7) !== API_KEY) {\n return new Response(JSON.stringify({ error: \"Unauthorized\" }), {\n status: 401,\n headers: {\n \"Content-Type\": \"application/json\",\n \"WWW-Authenticate\":\n `Bearer resource_metadata=\"${baseUrl} /.well-known/oauth-protected-resource\"`,\n \"Access-Control-Allow-Origin\": \"*\",\n },\n });\n }\n return null;\n}\nfunction oauthMeta(baseUrl: string) {\n return {\n issuer: baseUrl,\n authorization_endpoint: `${baseUrl} /oauth/authorize`,\n token_endpoint: `${baseUrl} /oauth/token`,\n registration_endpoint: `${baseUrl} /oauth/register`,\n code_challenge_methods_supported: [\"S256\"],\n grant_types_supported: [\"authorization_code\"],\n response_types_supported: [\"code\"],\n token_endpoint_auth_methods_supported: [\"none\"],\n scopes_supported: [\"mcp\"],\n };\n}\nasync function handleRegister(req: Request): Promise {\n let body: Record = {};\n try {\n body = await req.json();\n } catch { /* ignore — body is optional */ }\n const redirectUris = (body.redirect_uris as string[]) ?? [];\n return new Response(\n JSON.stringify({\n client_id: crypto.randomUUID(),\n client_id_issued_at: Math.floor(Date.now() / 1000),\n redirect_uris: redirectUris,\n grant_types: [\"authorization_code\"],\n response_types: [\"code\"],\n token_endpoint_auth_method: \"none\",\n }),\n {\n status: 201,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n },\n },\n );\n}\nfunction resourceMeta(baseUrl: string) {\n return {\n resource: `${baseUrl} /mcp`,\n authorization_servers: [baseUrl],\n };\n}\nasync function handleAuthorize(req: Request, url: URL): Promise {\n if (req.method === \"GET\") {\n const challenge = url.searchParams.get(\"code_challenge\") ?? \"\";\n const redirectUri = url.searchParams.get(\"redirect_uri\") ?? \"\";\n const state = url.searchParams.get(\"state\") ?? \"\";\n const clientId = url.searchParams.get(\"client_id\") ?? \"\";\n const esc = (s: string) => s.replace(/&/g, \"&\").replace(/\"/g, \""\");\n return new Response(\n `\n\n\nLyric Analysis — Authorize\n\n

Lyric Analysis

Claude is requesting access to the phonetic rhyme analysis tools.

\n\n

`,\n { headers: { \"Content-Type\": \"text/html\" } },\n );\n }\n if (req.method === \"POST\") {\n const form = new URLSearchParams(await req.text());\n const challenge = form.get(\"code_challenge\") ?? \"\";\n const redirectUri = form.get(\"redirect_uri\") ?? \"\";\n const state = form.get(\"state\") ?? \"\";\n if (!challenge || !redirectUri) {\n return new Response(\"Missing parameters\", { status: 400 });\n }\n const code = crypto.randomUUID();\n await blob.setJSON(`oauth_code_${code} `, {\n challenge,\n expires: Date.now() + CODE_TTL_MS,\n });\n const dest = new URL(redirectUri);\n dest.searchParams.set(\"code\", code);\n if (state) dest.searchParams.set(\"state\", state);\n return Response.redirect(dest.toString(), 302);\n }\n return new Response(\"Method not allowed\", { status: 405 });\n}\nasync function handleToken(req: Request): Promise {\n const form = new URLSearchParams(await req.text());\n const grantType = form.get(\"grant_type\");\n const code = form.get(\"code\") ?? \"\";\n const verifier = form.get(\"code_verifier\") ?? \"\";\n if (grantType !== \"authorization_code\") {\n return Response.json({ error: \"unsupported_grant_type\" }, { status: 400 });\n }\n if (!code || !verifier) {\n return Response.json({\n error: \"invalid_request\",\n error_description: \"code and code_verifier required\",\n }, { status: 400 });\n }\n const stored = await blob.getJSON(`oauth_code_${code} `) as {\n challenge: string;\n expires: number;\n } | null;\n if (!stored) {\n return Response.json({\n error: \"invalid_grant\",\n error_description: \"Unknown or expired code\",\n }, { status: 400 });\n }\n if (Date.now() > stored.expires) {\n await blob.delete(`oauth_code_${code} `);\n return Response.json({\n error: \"invalid_grant\",\n error_description: \"Code expired\",\n }, { status: 400 });\n }\n const computed = await sha256Base64url(verifier);\n if (computed !== stored.challenge) {\n return Response.json({\n error: \"invalid_grant\",\n error_description: \"PKCE verification failed\",\n }, { status: 400 });\n }\n await blob.delete(`oauth_code_${code} `);\n return Response.json({\n access_token: API_KEY,\n token_type: \"Bearer\",\n expires_in: 86400,\n });\n}\nfunction mcpResponse(id: unknown, result: unknown): Response {\n return new Response(JSON.stringify({ jsonrpc: \"2.0\", id, result }), {\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n },\n });\n}\nfunction mcpError(id: unknown, code: number, message: string): Response {\n return new Response(\n JSON.stringify({ jsonrpc: \"2.0\", id, error: { code, message } }),\n {\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n },\n },\n );\n}\nfunction handleMcp(body: Record, baseUrl: string): Response {\n const method = body.method as string;\n const id = body.id ?? null;\n const params = (body.params ?? {}) as Record;\n if (method?.startsWith(\"notifications/\")) {\n return new Response(null, { status: 202 });\n }\n if (method === \"initialize\") {\n return mcpResponse(id, {\n protocolVersion: \"2024-11-05\",\n capabilities: { tools: {} },\n serverInfo: { name: \"lyric-analysis\", version: \"1.0\" },\n });\n }\n if (method === \"tools/list\") return mcpResponse(id, { tools: MCP_TOOLS });\n if (method === \"tools/call\") {\n const name = params.name as string;\n const args = (params.arguments ?? {}) as Record;\n const lyrics = args.lyrics as string;\n if (!lyrics) return mcpError(id, -32602, \"lyrics argument required\");\n if (name === \"parse_lyrics\") {\n return mcpResponse(id, {\n content: [{ type: \"text\", text: JSON.stringify(parseLyrics(lyrics)) }],\n });\n }\n if (name === \"rhyme_map\") {\n const parseResult = parseLyrics(lyrics);\n const title = parseResult.title ?? \"Untitled\";\n const parsed = toFlatEntries(parseResult);\n const wordIndex = buildWordIndex(parsed);\n const analysis = buildAnalysis(title, parsed, wordIndex);\n const download_url = `${baseUrl} /rhyme-map?key=${\n encodeURIComponent(API_KEY)\n } &format=html&lyrics=${encodeURIComponent(lyrics)} `;\n return mcpResponse(id, {\n content: [{\n type: \"text\",\n text: JSON.stringify({ analysis, download_url }),\n }],\n });\n }\n if (name === \"rhythm_map\") {\n const parseResult = parseLyrics(lyrics);\n const title = parseResult.title ?? \"Untitled\";\n const parsed = toFlatEntries(parseResult);\n const wordIndex = buildWordIndex(parsed);\n const analysis = buildAnalysis(title, parsed, wordIndex);\n // Resolve time signature:parameter → metadata → default 4/4\n let timeSig = (args.time_signature as string | undefined) || undefined;\n if (!timeSig && parseResult.metadata) {\n timeSig = parseResult.metadata.time ||\n parseResult.metadata.time_signature;\n }\n const resolvedTimeSig = timeSig || \"4/4\";\n const isDefault = !timeSig;\n const beatPattern = getBeatPattern(resolvedTimeSig);\n generateRhythmMapSvg(\n title,\n analysis.sections,\n analysis.word_map,\n beatPattern,\n ); // Generate to ensure phonetic_stream is used\n // Build download URL with time signature if non-default\n const urlParams = new URLSearchParams({\n key: API_KEY,\n format: \"svg\",\n lyrics: lyrics,\n });\n if (resolvedTimeSig !== \"4/4\") {\n urlParams.set(\"time_signature\", resolvedTimeSig);\n }\n const download_url = `${baseUrl} /rhythm-map?${urlParams.toString()} `;\n let responseText = JSON.stringify({\n download_url,\n title,\n sections: analysis.sections.length,\n });\n if (isDefault) {\n responseText = JSON.stringify({\n download_url,\n title,\n sections: analysis.sections.length,\n note:\n \"Time signature not specified — defaulting to 4/4. Add{ time:3/4} to your lyrics or pass time_signature parameter to change.\",\n });\n }\n return mcpResponse(id, {\n content: [{ type: \"text\", text: responseText }],\n });\n }\n return mcpError(id, -32601, `Unknown tool:${name} `);\n }\n return mcpError(id, -32601, `Method not found:${method} `);\n}\n// ─── HTTP handler ─────────────────────────────────────────────────────────────\nfunction json(body: unknown, status = 200): Response {\n return new Response(JSON.stringify(body), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Headers\": \"Content-Type, X-API-Key\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n },\n });\n}\nexport default async function handler(req: Request): Promise {\n const url = new URL(req.url);\n const baseUrl = `${url.protocol} //${url.host} `;\n // CORS preflight\n if (req.method === \"OPTIONS\") {\n return new Response(null, {\n status: 204,\n headers: {\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Headers\":\n \"Content-Type, X-API-Key, Authorization\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n },\n });\n }\n // Health / root (no auth)\n if (\n req.method === \"GET\" && (url.pathname === \"/health\" || url.pathname === \"/\")\n ) {\n return json({\n status: \"ok\",\n name: \"lyric-analysis-api\",\n mcp: `${baseUrl} /mcp`,\n });\n }\n // OAuth metadata (no auth)\n if (url.pathname === \"/.well-known/oauth-authorization-server\") {\n return json(oauthMeta(baseUrl));\n }\n if (url.pathname === \"/.well-known/oauth-protected-resource\") {\n return json(resourceMeta(baseUrl));\n }\n // OAuth endpoints\n if (url.pathname === \"/oauth/authorize\") return handleAuthorize(req, url);\n if (req.method === \"POST\" && url.pathname === \"/oauth/token\") {\n return handleToken(req);\n }\n if (req.method === \"POST\" && url.pathname === \"/oauth/register\") {\n return handleRegister(req);\n }\n // MCP endpoint (Bearer auth)\n if (url.pathname === \"/mcp\") {\n const bearerError = checkBearerAuth(req, baseUrl);\n if (bearerError) return bearerError;\n if (req.method !== \"POST\") {\n return new Response(JSON.stringify({ error: \"Method not allowed\" }), {\n status: 405,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n },\n });\n }\n let mcpBody: Record;\n try {\n mcpBody = await req.json();\n } catch {\n return json({ error: \"Invalid JSON\" }, 400);\n }\n return handleMcp(mcpBody, baseUrl);\n }\n // All other routes require auth\n const authError = checkAuth(req);\n if (authError) return authError;\n // GET /parse-lyrics?lyrics=\n if (req.method === \"GET\" && url.pathname === \"/parse-lyrics\") {\n const lyrics = url.searchParams.get(\"lyrics\");\n if (!lyrics) return json({ error: \"lyrics query param required\" }, 400);\n return json(parseLyrics(lyrics));\n }\n // GET /rhyme-map?lyrics=[&format=html]\n if (req.method === \"GET\" && url.pathname === \"/rhyme-map\") {\n const lyrics = url.searchParams.get(\"lyrics\");\n if (!lyrics) return json({ error: \"lyrics query param required\" }, 400);\n const parseResult = parseLyrics(lyrics);\n const title = parseResult.title ?? \"Untitled\";\n const parsed = toFlatEntries(parseResult);\n const wordIndex = buildWordIndex(parsed);\n const analysis = buildAnalysis(title, parsed, wordIndex);\n if (url.searchParams.get(\"format\") === \"html\") {\n const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, \"-\").replace(\n /^-|-$/g,\n \"\",\n );\n return new Response(injectRhymeData(analysis), {\n headers: {\n \"Content-Type\": \"text/html; charset=utf-8\",\n \"Content-Disposition\":\n `attachment; filename=\"${slug} -rhyme-map.html\"`,\n \"Access-Control-Allow-Origin\": \"*\",\n },\n });\n }\n return json({ analysis });\n }\n // GET /rhythm-map?lyrics=[&time_signature=][&format=svg]\n if (req.method === \"GET\" && url.pathname === \"/rhythm-map\") {\n const lyrics = url.searchParams.get(\"lyrics\");\n if (!lyrics) return json({ error: \"lyrics query param required\" }, 400);\n const parseResult = parseLyrics(lyrics);\n const title = parseResult.title ?? \"Untitled\";\n const parsed = toFlatEntries(parseResult);\n const wordIndex = buildWordIndex(parsed);\n const analysis = buildAnalysis(title, parsed, wordIndex);\n // Resolve time signature from query param, metadata, or default\n let timeSig = url.searchParams.get(\"time_signature\") || undefined;\n if (!timeSig && parseResult.metadata) {\n timeSig = parseResult.metadata.time ||\n parseResult.metadata.time_signature;\n }\n const resolvedTimeSig = timeSig || \"4/4\";\n const beatPattern = getBeatPattern(resolvedTimeSig);\n const svg = generateRhythmMapSvg(\n title,\n analysis.sections,\n analysis.word_map,\n beatPattern,\n );\n if (url.searchParams.get(\"format\") === \"svg\") {\n const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, \"-\").replace(\n /^-|-$/g,\n \"\",\n );\n return new Response(svg, {\n headers: {\n \"Content-Type\": \"image/svg+xml; charset=utf-8\",\n \"Content-Disposition\":\n `attachment; filename=\"${slug} -rhythm-map.svg\"`,\n \"Access-Control-Allow-Origin\": \"*\",\n },\n });\n }\n const dlParams = new URLSearchParams({\n key: API_KEY,\n format: \"svg\",\n lyrics,\n });\n if (resolvedTimeSig !== \"4/4\") {\n dlParams.set(\"time_signature\", resolvedTimeSig);\n }\n return json({\n download_url: `${\n new URL(req.url).origin\n } /rhythm-map?${dlParams.toString()} `,\n });\n }\n if (req.method !== \"POST\") return json({ error: \"Method not allowed\" }, 405);\n let body: Record;\n try {\n body = await req.json();\n } catch {\n return json({ error: \"Invalid JSON body\" }, 400);\n }\n // POST /parse-lyrics\n if (url.pathname === \"/parse-lyrics\") {\n const lyrics = body.lyrics as string;\n if (!lyrics) return json({ error: \"lyrics field required\" }, 400);\n return json(parseLyrics(lyrics));\n }\n // POST /rhyme-map\n if (url.pathname === \"/rhyme-map\") {\n const lyrics = body.lyrics as string;\n if (!lyrics) return json({ error: \"lyrics field required\" }, 400);\n const parseResult = parseLyrics(lyrics);\n let title = (body.title as string) ?? null;\n if (!title) title = parseResult.title ?? \"Untitled\";\n const parsed = toFlatEntries(parseResult);\n const wordIndex = buildWordIndex(parsed);\n const analysis = buildAnalysis(title, parsed, wordIndex);\n return json({ analysis });\n }\n return json({ error: \"Not found\" }, 404);\n}","deleted","label","lyric",[114],"pulls",1,"forks","envVars",{"_137":131,"_139":54},"connections",{"_137":54,"_138":54},"count","unfilledCount","emptyCount",{"_20":113,"_13":114,"_115":48,"_116":-5,"_117":21,"_118":30,"_119":50,"_22":141,"_29":121,"_122":123,"_124":125,"_126":38,"_127":128,"_142":143,"_90":144},["D",1776813333237],"children",[],[114],["D",1776171189300],{"_11":12,"_88":84},{"_11":12,"_82":-5,"_83":84,"_45":46,"_85":86,"_87":38},{"_29":30,"_13":26,"_20":21,"_27":28,"_31":-5,"_32":-5,"_77":-5,"_78":-5,"_79":-5,"_80":14,"_81":12},"ctx",{"_70":-5,"_109":182,"_183":184,"_185":186,"_187":38,"_188":38,"_189":38,"_190":50,"_191":-5,"_192":-7,"_193":-7,"_194":54,"_195":38,"_196":38,"_197":-5,"_198":38,"_199":38,"_200":38,"_201":-5},"ENV",{"_153":154,"_155":156,"_157":26,"_158":159,"_160":161,"_162":163,"_164":165,"_166":167,"_168":169,"_170":171,"_172":173,"_174":175,"_176":177,"_178":179,"_180":181},"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",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Branches1

Branches
1