@openephemeris/mcp-server 3.12.0 → 3.13.1

package/dist/tools/apps/bi-wheel-app.js

@@ -0,0 +1,459 @@
+/**
+ * bi-wheel-app.ts — MCP App tool registration for the Bi-Wheel Explorer.
+ *
+ * Registers 3 tools:
+ *   • explore_bi_wheel               — primary entry point: fetches two charts, computes
+ *                                      cross-aspects, returns data + UI resource [model]
+ *   • bi_wheel_on_cross_aspect_click — cross-aspect click handler [app-only]
+ *   • bi_wheel_on_planet_click       — planet click handler (inner or outer wheel) [app-only]
+ *
+ * Modes:
+ *   synastry — fetch two natal charts in parallel (person1 inner, person2 outer)
+ *   transit  — fetch one natal chart (inner) + one transit chart (outer)
+ *
+ * Cross-aspects are computed client-side (UI) AND server-side (for summary/fallback).
+ * The payload cross_aspects array is capped at 30 tightest-orb aspects.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { registerTool } from "../index.js";
+import { getActiveClient } from "../../backend/client.js";
+// ── Constants ─────────────────────────────────────────────────────────────────
+export const BI_WHEEL_RESOURCE_URI = "ui://openephemeris/bi-wheel";
+export const BI_WHEEL_MIME_TYPE = "text/html;profile=mcp-app";
+const here = path.dirname(fileURLToPath(import.meta.url));
+const BUNDLE_PATH = path.resolve(here, "..", "..", "..", "dist", "ui", "bi-wheel.html");
+let cachedBiWheelBundle = null;
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export function getBiWheelBundle() {
+    if (cachedBiWheelBundle)
+        return cachedBiWheelBundle;
+    if (!fs.existsSync(BUNDLE_PATH))
+        return null;
+    try {
+        cachedBiWheelBundle = fs.readFileSync(BUNDLE_PATH, "utf-8");
+        return cachedBiWheelBundle;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearBiWheelBundleCache() {
+    cachedBiWheelBundle = null;
+}
+// ── House system helpers (shared with chart-wheel) ────────────────────────────
+const HOUSE_SYSTEM_MAP = {
+    placidus: "P", whole_sign: "W", equal: "E", koch: "K",
+    campanus: "C", regiomontanus: "R",
+};
+function buildNatalBody(datetime, lat, lon, timezone) {
+    const body = {
+        subject: {
+            name: "MCP Request",
+            birth_datetime: { iso: datetime },
+            birth_location: {
+                latitude: { decimal: lat ?? 0 },
+                longitude: { decimal: lon ?? 0 },
+            },
+        },
+        configuration: {
+            house_system: HOUSE_SYSTEM_MAP["placidus"],
+        },
+    };
+    if (timezone) {
+        body.subject.birth_location.timezone = { iana_name: timezone };
+    }
+    return body;
+}
+function buildTransitBody(transitDate, natalDatetime, lat, lon, timezone) {
+    return {
+        subject: {
+            name: "MCP Request",
+            birth_datetime: { iso: natalDatetime },
+            birth_location: {
+                latitude: { decimal: lat ?? 0 },
+                longitude: { decimal: lon ?? 0 },
+            },
+        },
+        transit_datetime: { iso: transitDate },
+        ...(timezone ? { timezone: { iana_name: timezone } } : {}),
+        configuration: { house_system: HOUSE_SYSTEM_MAP["placidus"] },
+    };
+}
+const CROSS_ASPECT_DEFS = [
+    { type: "conjunction", angle: 0, orb: 8 },
+    { type: "opposition", angle: 180, orb: 8 },
+    { type: "trine", angle: 120, orb: 6 },
+    { type: "square", angle: 90, orb: 5 }, // tightened from 6° per Ptolemaic convention
+    { type: "sextile", angle: 60, orb: 4 },
+];
+export function computeCrossAspects(planets1, planets2) {
+    const results = [];
+    for (const p1 of planets1) {
+        for (const p2 of planets2) {
+            let diff = Math.abs(p1.longitude - p2.longitude) % 360;
+            if (diff > 180)
+                diff = 360 - diff;
+            for (const asp of CROSS_ASPECT_DEFS) {
+                const orb = Math.abs(diff - asp.angle);
+                if (orb <= asp.orb) {
+                    const applying = ((p1.speed ?? 1) - (p2.speed ?? 0)) < 0
+                        ? diff < asp.angle
+                        : diff > asp.angle;
+                    results.push({
+                        planet1: p1.name,
+                        wheel1: "inner",
+                        planet2: p2.name,
+                        wheel2: "outer",
+                        type: asp.type,
+                        angle: asp.angle,
+                        orb: Math.round(orb * 100) / 100,
+                        applying,
+                    });
+                    break;
+                }
+            }
+        }
+    }
+    // Sort by orb tightness, cap at 30
+    return results.sort((a, b) => a.orb - b.orb).slice(0, 30);
+}
+// ── Planet normalisation ───────────────────────────────────────────────────────
+const CLASSICAL_PLANETS = new Set([
+    "sun", "moon", "mercury", "venus", "mars",
+    "jupiter", "saturn", "uranus", "neptune", "pluto",
+    "chiron", "north_node", "south_node", "true_node", "asc", "mc",
+]);
+function normalizePlanets(raw) {
+    if (Array.isArray(raw))
+        return raw;
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        return Object.entries(raw)
+            .filter(([k]) => CLASSICAL_PLANETS.has(k.toLowerCase()))
+            .map(([name, p]) => ({
+            name: name.toLowerCase(),
+            longitude: (p.longitude ?? p.lon ?? 0),
+            speed: (p.longitude_speed ?? p.speed),
+            retrograde: Boolean(p.is_retrograde ?? p.retrograde),
+            sign: (p.sign_name ?? p.sign),
+            house: p.house,
+        }));
+    }
+    return [];
+}
+function normalizeHouses(raw) {
+    if (Array.isArray(raw))
+        return raw;
+    return [];
+}
+// ── Payload builder ────────────────────────────────────────────────────────────
+function buildBiWheelPayload(innerData, outerData, mode, params1, params2) {
+    const innerPlanets = normalizePlanets(innerData.planets);
+    const outerPlanets = normalizePlanets(outerData.planets);
+    const innerHouses = normalizeHouses(innerData.houses);
+    const outerHouses = normalizeHouses(outerData.houses);
+    const crossAspects = computeCrossAspects(innerPlanets, outerPlanets);
+    return {
+        mode,
+        inner: innerPlanets,
+        outer: outerPlanets,
+        inner_houses: innerHouses,
+        outer_houses: outerHouses,
+        cross_aspects: crossAspects,
+        _birth_params_inner: params1,
+        _birth_params_outer: params2,
+    };
+}
+// ── Summary builder ────────────────────────────────────────────────────────────
+function capitalize(s) {
+    return s.replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function zodSignFromLon(lon) {
+    const signs = ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
+        "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces"];
+    return signs[Math.floor(((lon % 360) + 360) % 360 / 30)];
+}
+function buildBiWheelSummary(innerPlanets, outerPlanets, crossAspects, mode, location1, location2) {
+    const getKey = (planets, name) => planets.find((p) => p.name === name.toLowerCase());
+    // Inner wheel basics
+    const innerSun = getKey(innerPlanets, "sun");
+    const innerMoon = getKey(innerPlanets, "moon");
+    const innerAsc = getKey(innerPlanets, "asc");
+    const innerBasics = [innerSun, innerMoon, innerAsc]
+        .filter(Boolean)
+        .map((p) => `${capitalize(p.name)} in ${zodSignFromLon(p.longitude)}`)
+        .join(", ");
+    // Top 5 cross-aspects by orb
+    const ASPECT_SYMBOL = {
+        conjunction: "☌", opposition: "☍", trine: "△",
+        square: "□", sextile: "⚹",
+    };
+    const top5 = crossAspects.slice(0, 5).map((ca) => `• ${capitalize(ca.planet1)} ${ASPECT_SYMBOL[ca.type] ?? ca.type} ${capitalize(ca.planet2)} (${ca.orb.toFixed(1)}° orb${ca.applying ? ", applying" : ""})`);
+    const modeLabel = mode === "synastry" ? "Synastry" : "Transit";
+    const label1 = mode === "synastry" ? "Person 1 (inner)" : "Natal (inner)";
+    const label2 = mode === "synastry" ? "Person 2 (outer)" : "Transit (outer)";
+    return (`**${modeLabel} Bi-Wheel**\n\n` +
+        `${label1}: ${location1} — ${innerBasics || "chart loaded"}\n` +
+        `${label2}: ${location2}\n\n` +
+        `**Top Cross-Aspects:**\n${top5.join("\n") || "No major cross-aspects within orb."}\n\n` +
+        "Click any planet or cross-aspect line in the bi-wheel for interpretation.");
+}
+// ── Tool: explore_bi_wheel ─────────────────────────────────────────────────────
+registerTool({
+    name: "explore_bi_wheel",
+    description: "Generate an interactive bi-wheel chart for synastry (two natal charts) or transit analysis " +
+        "(natal chart + transiting planets). In synastry mode, the inner wheel shows Person 1's natal " +
+        "chart and the outer ring shows Person 2's natal chart. In transit mode, the inner wheel shows " +
+        "the natal chart and the outer ring shows transiting planets for the given date. " +
+        "Cross-aspects between both wheels are computed and displayed as coloured dashed lines. " +
+        "Click any planet or cross-aspect line for interpretation.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            person1_datetime: {
+                type: "string",
+                description: "ISO 8601 datetime for Person 1 / Natal chart (e.g. '1990-04-15T14:30:00-05:00').",
+            },
+            person1_latitude: { type: "number", description: "Birth latitude for Person 1 (decimal degrees, positive = North)." },
+            person1_longitude: { type: "number", description: "Birth longitude for Person 1 (decimal degrees, positive = East)." },
+            person1_timezone: { type: "string", description: "IANA timezone for Person 1 (e.g. 'America/New_York')." },
+            person1_name: {
+                type: "string",
+                description: "Display name for Person 1 / Natal chart (e.g. 'Alice'). Used in the badge and summary.",
+            },
+            person2_datetime: {
+                type: "string",
+                description: "ISO 8601 datetime for Person 2 (synastry) or the transit date (transit mode). Required.",
+            },
+            person2_latitude: { type: "number", description: "Birth latitude for Person 2 / transit location (decimal degrees)." },
+            person2_longitude: { type: "number", description: "Birth longitude for Person 2 / transit location (decimal degrees)." },
+            person2_timezone: { type: "string", description: "IANA timezone for Person 2 / transit (e.g. 'America/Chicago')." },
+            person2_name: {
+                type: "string",
+                description: "Display name for Person 2 / Transit chart (e.g. 'Bob'). Used in the badge and summary.",
+            },
+            location: {
+                type: "string",
+                description: "Label for Person 1 / Natal location (display only, e.g. 'New York, NY').",
+            },
+            mode: {
+                type: "string",
+                enum: ["synastry", "transit"],
+                description: "Chart mode: 'synastry' (two natal charts) or 'transit' (natal + transits). Defaults to 'synastry'.",
+            },
+        },
+        required: ["person1_datetime", "person2_datetime",
+            "person1_latitude", "person1_longitude",
+            "person2_latitude", "person2_longitude"],
+    },
+    annotations: {
+        title: "Interactive Bi-Wheel Explorer",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (args) => {
+        const client = getActiveClient();
+        const mode = args.mode ?? "synastry";
+        const dt1 = String(args.person1_datetime);
+        const lat1 = args.person1_latitude;
+        const lon1 = args.person1_longitude;
+        const tz1 = args.person1_timezone;
+        const dt2 = String(args.person2_datetime);
+        const lat2 = args.person2_latitude;
+        const lon2 = args.person2_longitude;
+        const tz2 = args.person2_timezone;
+        const loc1 = String(args.person1_name ?? args.location ?? `${lat1 ?? "?"},${lon1 ?? "?"}`);
+        const loc2 = mode === "transit"
+            ? `Transit ${dt2.slice(0, 10)}`
+            : String(args.person2_name ?? `${lat2 ?? ""},${lon2 ?? ""}`);
+        // Fetch both charts in parallel
+        let innerData;
+        let outerData;
+        if (mode === "synastry") {
+            [innerData, outerData] = await Promise.all([
+                client.post("/ephemeris/natal-chart", buildNatalBody(dt1, lat1, lon1, tz1)),
+                client.post("/ephemeris/natal-chart", buildNatalBody(dt2, lat2, lon2, tz2)),
+            ]);
+        }
+        else {
+            // Transit mode: inner = natal (dt1), outer = transits for dt2 at natal location
+            [innerData, outerData] = await Promise.all([
+                client.post("/ephemeris/natal-chart", buildNatalBody(dt1, lat1, lon1, tz1)),
+                client.post("/ephemeris/natal-chart", buildNatalBody(dt2, lat2 ?? lat1, lon2 ?? lon1, tz2 ?? tz1)),
+            ]);
+        }
+        const innerPlanets = normalizePlanets(innerData.planets);
+        const outerPlanets = normalizePlanets(outerData.planets);
+        const crossAspects = computeCrossAspects(innerPlanets, outerPlanets);
+        const summary = buildBiWheelSummary(innerPlanets, outerPlanets, crossAspects, mode, loc1, loc2);
+        const params1 = { datetime: dt1, timezone: tz1 ?? null, latitude: lat1 ?? null, longitude: lon1 ?? null, location: loc1 };
+        const params2 = { datetime: dt2, timezone: tz2 ?? null, latitude: lat2 ?? null, longitude: lon2 ?? null, location: loc2 };
+        const payload = buildBiWheelPayload(innerData, outerData, mode, params1, params2);
+        const bundleAvailable = Boolean(getBiWheelBundle());
+        if (bundleAvailable) {
+            return {
+                content: [
+                    { type: "text", text: summary },
+                    { type: "text", text: JSON.stringify(payload) },
+                    {
+                        type: "resource",
+                        resource: {
+                            uri: BI_WHEEL_RESOURCE_URI,
+                            mimeType: BI_WHEEL_MIME_TYPE,
+                            text: getBiWheelBundle(),
+                        },
+                    },
+                ],
+                _meta: {
+                    ui: { resourceUri: BI_WHEEL_RESOURCE_URI },
+                },
+            };
+        }
+        // Fallback: text summary only
+        return { content: [{ type: "text", text: summary }] };
+    },
+});
+// ── Tool: bi_wheel_on_cross_aspect_click ──────────────────────────────────────
+registerTool({
+    name: "bi_wheel_on_cross_aspect_click",
+    description: "Event handler called when the user clicks a cross-aspect line in the bi-wheel. " +
+        "Returns a synastry or transit interpretation of that aspect between the two wheels. " +
+        "This tool is called automatically by the bi-wheel UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            planet1: { type: "string", description: "Planet name from the inner (natal) wheel" },
+            wheel1: { type: "string", enum: ["inner", "outer"], description: "Which wheel planet1 belongs to" },
+            planet2: { type: "string", description: "Planet name from the outer (synastry/transit) wheel" },
+            wheel2: { type: "string", enum: ["inner", "outer"], description: "Which wheel planet2 belongs to" },
+            aspect_type: { type: "string", description: "Aspect type: conjunction, opposition, trine, square, sextile" },
+            orb: { type: "number", description: "Orb in degrees" },
+            applying: { type: "boolean", description: "True if the aspect is applying (tightening)" },
+            mode: { type: "string", enum: ["synastry", "transit"], description: "Chart mode (synastry or transit). Determines interpretation style." },
+        },
+        required: ["planet1", "planet2", "aspect_type"],
+    },
+    annotations: { title: "Cross-Aspect Interpretation", readOnlyHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: BI_WHEEL_RESOURCE_URI, visibility: ["app"] } },
+    handler: async (args) => {
+        const p1 = capitalize(String(args.planet1));
+        const p2 = capitalize(String(args.planet2));
+        const type = String(args.aspect_type ?? "aspect");
+        const orb = args.orb != null ? ` (${Number(args.orb).toFixed(1)}° orb)` : "";
+        const dir = args.applying != null
+            ? (args.applying ? " — applying" : " — separating")
+            : "";
+        return {
+            content: [{
+                    type: "text",
+                    text: `**${p1} ${capitalize(type)} ${p2}${orb}${dir}** *(Cross-Wheel)*\n\n` +
+                        interpretCrossAspect(String(args.planet1), String(args.planet2), type, Boolean(args.applying), args.mode ?? "synastry"),
+                }],
+        };
+    },
+});
+// ── Tool: bi_wheel_on_planet_click ────────────────────────────────────────────
+registerTool({
+    name: "bi_wheel_on_planet_click",
+    description: "Event handler called when the user clicks a planet in the bi-wheel. " +
+        "Returns the planet's meaning in context — e.g. 'Your Sun conjuncts their Moon'. " +
+        "This tool is called automatically by the bi-wheel UI; you do not need to call it directly.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            planet: { type: "string", description: "Planet name (e.g. 'saturn')" },
+            wheel: { type: "string", enum: ["inner", "outer"], description: "Which wheel (inner=natal/person1, outer=synastry/transit)" },
+            longitude: { type: "number", description: "Ecliptic longitude in degrees" },
+            sign: { type: "string", description: "Zodiac sign" },
+            house: { type: "number", description: "House number (1–12) if available" },
+            retrograde: { type: "boolean", description: "Whether the planet is retrograde" },
+            mode: { type: "string", enum: ["synastry", "transit"], description: "Chart mode" },
+        },
+        required: ["planet", "wheel", "longitude"],
+    },
+    annotations: { title: "Bi-Wheel Planet Interpretation", readOnlyHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: BI_WHEEL_RESOURCE_URI, visibility: ["app"] } },
+    handler: async (args) => {
+        const planet = String(args.planet);
+        const wheel = args.wheel ?? "inner";
+        const sign = args.sign ? String(args.sign) : zodSignFromLon(Number(args.longitude));
+        const houseNum = args.house != null ? Number(args.house) : null;
+        const house = houseNum != null && houseNum > 0 ? ` in the ${ordinal(houseNum)} house` : "";
+        const wheelLabel = wheel === "inner" ? "Natal / Person 1" : "Synastry / Transit";
+        const deg = `${Math.floor(Number(args.longitude) % 30)}° ${sign}`;
+        return {
+            content: [{
+                    type: "text",
+                    text: `**${capitalize(planet)} at ${deg}${house}** *(${wheelLabel})*\n\n` +
+                        interpretBiWheelPlanet(planet, sign, houseNum ?? 0, wheel, Boolean(args.retrograde)),
+                }],
+        };
+    },
+});
+// ── Interpretation helpers ─────────────────────────────────────────────────────
+function ordinal(n) {
+    const s = ["th", "st", "nd", "rd"];
+    const v = n % 100;
+    return n + (s[(v - 20) % 10] || s[v] || s[0]);
+}
+const PLANET_THEMES = {
+    sun: "identity and conscious self-expression",
+    moon: "emotional nature and instinctive responses",
+    mercury: "thinking style, communication, and mental patterns",
+    venus: "love language, values, and relational style",
+    mars: "drive, desire, action, and assertiveness",
+    jupiter: "expansion, optimism, philosophy, and generosity",
+    saturn: "structure, discipline, karmic lessons, and boundaries",
+    uranus: "awakening, innovation, and sudden disruption",
+    neptune: "dreams, idealism, compassion, and dissolution",
+    pluto: "transformation, power dynamics, and profound change",
+    chiron: "the wounded healer — deep vulnerability, mastery through pain, and the gift of empathy forged in suffering",
+    north_node: "soul direction and karmic growth edge; the evolutionary path forward in this lifetime",
+    south_node: "accumulated karma and innate past-life gifts; the comfort zone that must be transcended",
+    true_node: "soul direction and karmic growth edge; the evolutionary path forward in this lifetime",
+    asc: "the rising sign and outer personality mask; the social self, physical appearance, and the lens through which life is encountered",
+    mc: "public vocation, highest ambition, and the world's face; the pinnacle of achievement this person strives toward",
+};
+const HOUSE_AREAS = {
+    1: "self and identity", 2: "values and resources",
+    3: "communication", 4: "home and roots",
+    5: "creativity and joy", 6: "work and health",
+    7: "partnerships", 8: "shared depth and transformation",
+    9: "beliefs and expansion", 10: "career and public life",
+    11: "community and hopes", 12: "solitude and the unconscious",
+};
+function interpretBiWheelPlanet(planet, sign, house, wheel, retrograde = false) {
+    const theme = PLANET_THEMES[planet.toLowerCase()] ?? "a deep archetypal force";
+    const houseCtx = house ? ` This energy operates in the sphere of ${HOUSE_AREAS[house] ?? "life experience"}.` : "";
+    const retroCtx = retrograde
+        ? ` Note: this planet is **retrograde** — its energy tends to be more internalized, reflective, or nonconforming in its expression.`
+        : "";
+    const wheelCtx = wheel === "inner"
+        ? "This is a **natal planet** — a core, stable part of this person's identity."
+        : "This is an **outer planet** — a transiting or synastry energy currently activating the inner wheel.";
+    return (`${capitalize(planet)} represents ${theme}. In ${capitalize(sign)}, this energy is expressed through the qualities of that sign.${houseCtx}${retroCtx}\n\n${wheelCtx}`);
+}
+const CROSS_ASPECT_NATURE = {
+    conjunction: "creates a powerful merging of these two planetary energies across the chart boundary. What one person (or the natal chart) embodies, the other amplifies — this can feel fated, intense, and highly activating.",
+    opposition: "creates a magnetic pull-and-push dynamic. The two energies are drawn to each other yet challenge each other to grow. In synastry, this often manifests as fascination and tension; in transit, as external pressure to integrate.",
+    trine: "creates an easy, harmonious flow of energy between the two charts. This aspect supports mutual understanding, natural rapport, and a sense of ease — gifts arrive without much effort.",
+    square: "creates productive friction between the two charts. Growth and evolution are required. In synastry, this generates passion and drive; in transit, it signals action and adjustment.",
+    sextile: "creates a gentle, supportive connection that rewards intentional effort. Opportunities arise where these two energies meet, but initiative is needed to activate them fully.",
+};
+function interpretCrossAspect(p1, p2, type, applying, mode) {
+    const nature = CROSS_ASPECT_NATURE[type.toLowerCase()] ?? "creates a notable connection across the two charts.";
+    let timing;
+    if (mode === "transit") {
+        timing = applying
+            ? "This aspect is **applying** — its influence is building and moving toward maximum expression."
+            : "This aspect is **separating** — its peak has passed; integration of its themes is underway.";
+    }
+    else {
+        // In synastry, both charts are frozen — applying/separating has no temporal meaning.
+        timing = "As a synastry aspect, this connection exists as a permanent feature of this relationship dynamic — neither building nor fading, but always present as a foundational thread between these two charts.";
+    }
+    return (`The ${type} between ${capitalize(p1)} and ${capitalize(p2)} ${nature}\n\n${timing}`);
+}

package/dist/tools/apps/bodygraph-app.d.ts

@@ -0,0 +1,22 @@
+/**
+ * bodygraph-app.ts — MCP App tool registration for the Human Design Bodygraph Explorer.
+ *
+ * Registers 4 tools:
+ *   • explore_human_design      — primary entry point, returns data + UI resource [model]
+ *   • hd_on_center_click        — center click handler [app-only]
+ *   • hd_on_gate_click          — gate click handler [app-only]
+ *   • hd_on_channel_click       — channel click handler [app-only]
+ *
+ * The bodygraph is rendered client-side from structured JSON — no SVG endpoint
+ * is called, keeping latency at zero and the architecture consistent with
+ * the chart-wheel-app approach.
+ *
+ * Also exports resource helpers (getBodygraphBundle, etc.) for use in
+ * index.ts and server-sse.ts.
+ */
+export declare const BODYGRAPH_RESOURCE_URI = "ui://openephemeris/bodygraph";
+export declare const BODYGRAPH_MIME_TYPE = "text/html;profile=mcp-app";
+/** Read the pre-built HTML bundle. Returns null if not yet built. */
+export declare function getBodygraphBundle(): string | null;
+/** Reset cache (useful in dev watch mode or tests). */
+export declare function clearBodygraphBundleCache(): void;