@openephemeris/mcp-server 3.17.0 → 3.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openephemeris/mcp-server",
-  "version": "3.17.0",
+  "version": "3.19.0",
   "description": "Model Context Protocol server for the Open Ephemeris astronomical computation API",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
     "test": "test"
   },
   "scripts": {
-    "build:ui": "cd src/ui/chart-wheel && npx vite build && cd ../../.. && cd src/ui/bodygraph && npx vite build && cd ../../.. && cd src/ui/bi-wheel && npx vite build && cd ../../.. && cd src/ui/transit-timeline && npx vite build && cd ../../.. && cd src/ui/moon-phase && npx vite build && cd ../../.. && cd src/ui/bazi && npx vite build && cd ../../.. && cd src/ui/vedic-chart && npx vite build",
+    "build:ui": "cd src/ui/chart-wheel && npx vite build && cd ../../.. && cd src/ui/bodygraph && npx vite build && cd ../../.. && cd src/ui/bi-wheel && npx vite build && cd ../../.. && cd src/ui/moon-phase && npx vite build",
     "build": "npm run build:ui && tsc -p tsconfig.build.json",
     "prebuild": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\"",
     "dev": "tsx watch src/index.ts",
@@ -33,6 +33,8 @@
     "validate:visual": "node scripts/visual-check.mjs",
     "test:integration": "tsx scripts/test-client.ts",
     "test:sse": "tsx scripts/test-sse-client.ts",
+    "test:published": "tsx scripts/test-published.ts",
+    "test:mcp-http": "tsx scripts/test-mcp-http.ts",
     "typecheck": "tsc --noEmit",
     "regen:dev-allowlist": "tsx scripts/dev-allowlist.ts --write",
     "check:dev-allowlist": "tsx scripts/dev-allowlist.ts --check",

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

@@ -1,23 +0,0 @@
-/**
- * bazi-app.ts — MCP App tool registration for the BaZi Four Pillars Explorer.
- *
- * Registers 1 tool:
- *   • explore_bazi_chart — primary entry point, returns data + UI resource [model]
- *
- * Batches three backend API calls in parallel:
- *   POST /chinese/bazi              → four pillars
- *   POST /chinese/bazi/ten-gods     → ten gods + hidden stems
- *   POST /chinese/bazi/element-balance → wu xing balance + yong shen
- *
- * Merges results into a single UI payload and returns it with a resource URI
- * so the iframe can render the interactive Four Pillars visualization.
- *
- * Also exports resource helpers (getBaziBundle, etc.) for use in
- * index.ts and server-sse.ts.
- */
-export declare const BAZI_RESOURCE_URI = "ui://openephemeris/bazi";
-export declare const BAZI_MIME_TYPE = "text/html;profile=mcp-app";
-/** Read the pre-built HTML bundle. Returns null if not yet built. */
-export declare function getBaziBundle(): string | null;
-/** Reset cache (useful in dev watch mode or tests). */
-export declare function clearBaziBundleCache(): void;

package/dist/tools/apps/bazi-app.js

@@ -1,226 +0,0 @@
-/**
- * bazi-app.ts — MCP App tool registration for the BaZi Four Pillars Explorer.
- *
- * Registers 1 tool:
- *   • explore_bazi_chart — primary entry point, returns data + UI resource [model]
- *
- * Batches three backend API calls in parallel:
- *   POST /chinese/bazi              → four pillars
- *   POST /chinese/bazi/ten-gods     → ten gods + hidden stems
- *   POST /chinese/bazi/element-balance → wu xing balance + yong shen
- *
- * Merges results into a single UI payload and returns it with a resource URI
- * so the iframe can render the interactive Four Pillars visualization.
- *
- * Also exports resource helpers (getBaziBundle, etc.) for use in
- * index.ts and server-sse.ts.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { registerTool, SERVER_VERSION } from "../index.js";
-import { getActiveClient } from "../../backend/client.js";
-import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
-// ── Constants ─────────────────────────────────────────────────────────────────
-export const BAZI_RESOURCE_URI = "ui://openephemeris/bazi";
-export const BAZI_MIME_TYPE = "text/html;profile=mcp-app";
-const here = path.dirname(fileURLToPath(import.meta.url));
-const BUNDLE_PATHS = [
-    path.resolve(here, "..", "..", "..", "dist", "ui", "bazi.html"),
-];
-function findBundlePath() {
-    for (const p of BUNDLE_PATHS) {
-        if (fs.existsSync(p))
-            return p;
-    }
-    return null;
-}
-let cachedBundle = null;
-/** Read the pre-built HTML bundle. Returns null if not yet built. */
-export function getBaziBundle() {
-    if (cachedBundle)
-        return cachedBundle;
-    const bundlePath = findBundlePath();
-    if (!bundlePath)
-        return null;
-    try {
-        cachedBundle = fs.readFileSync(bundlePath, "utf-8");
-        return cachedBundle;
-    }
-    catch {
-        return null;
-    }
-}
-/** Reset cache (useful in dev watch mode or tests). */
-export function clearBaziBundleCache() {
-    cachedBundle = null;
-}
-function parseBaziArgs(args) {
-    let { year, month, day, hour } = args;
-    if (args.datetime && (!year || !month || !day)) {
-        const dt = new Date(args.datetime);
-        if (!isNaN(dt.getTime())) {
-            year = dt.getUTCFullYear();
-            month = dt.getUTCMonth() + 1;
-            day = dt.getUTCDate();
-            if (hour == null)
-                hour = dt.getUTCHours();
-        }
-    }
-    if (!year || !month || !day) {
-        throw new Error("Provide year/month/day fields, or a datetime ISO string. " +
-            "Example: year=1987, month=7, day=15 OR datetime='1987-07-15T14:00:00Z'");
-    }
-    const out = { year, month, day };
-    if (hour != null)
-        out.hour = hour;
-    return out;
-}
-// ── Summary builder ──────────────────────────────────────────────────────────
-function buildBaziSummary(data) {
-    const chart = data.chart;
-    const balance = data.element_balance;
-    const tenGods = data.ten_gods;
-    const dm = chart?.day_master;
-    const dmStr = dm ? (dm.stem || "?") + " " + (dm.element || "?") : "Unknown";
-    let summary = "**BaZi Four Pillars** — Day Master: **" + dmStr + "**\n\n";
-    // Pillars summary
-    const keys = ["year", "month", "day", "hour"];
-    const labels = ["Year", "Month", "Day", "Hour"];
-    if (chart) {
-        summary += "| Pillar | Stem | Branch | Animal |\n|--------|------|--------|--------|\n";
-        for (let i = 0; i < keys.length; i++) {
-            const p = chart[keys[i]];
-            if (p) {
-                summary +=
-                    "| " + labels[i] +
-                        " | " + (p.stem?.name || "?") +
-                        " (" + (p.stem?.element || "") + ")" +
-                        " | " + (p.branch?.name || "?") +
-                        " | " + (p.branch?.animal || "") +
-                        " |\n";
-            }
-        }
-        summary += "\n";
-    }
-    // Element balance
-    if (balance?.elements) {
-        const strength = balance.day_master_strength || "unknown";
-        summary += "**Day Master Strength**: " + strength + "\n";
-        if (balance.yong_shen_element) {
-            summary += "**Useful God (用神)**: " + balance.yong_shen_element + "\n";
-        }
-        summary += "\n";
-    }
-    summary += "Click pillars on the chart for Ten Gods detail and interpretation.";
-    return summary;
-}
-// ── Tool: explore_bazi_chart ─────────────────────────────────────────────────
-registerTool({
-    name: "explore_bazi_chart",
-    description: "Generate an interactive BaZi Four Pillars (四柱命盘) visualization. " +
-        "Displays the Year, Month, Day, and Hour pillars with Heavenly Stems, " +
-        "Earthly Branches, Hidden Stems, Ten Gods analysis, and a weighted " +
-        "Wu Xing (Five Elements) balance bar.\n\n" +
-        "Returns a rich interactive chart with:\n" +
-        "  • Four-column pillar grid with Chinese characters and element colours\n" +
-        "  • Day Master emphasis and badge\n" +
-        "  • Hidden Stems with strength indicators (main/secondary/residual)\n" +
-        "  • Ten Gods classification for each pillar\n" +
-        "  • Wu Xing balance bar with percentages and Yong Shen (Useful God)\n" +
-        "  • Click pillars for detailed Ten Gods drawer\n\n" +
-        "CREDIT COST: 3 credits (batches three BaZi endpoints).\n\n" +
-        "Use this for a rich, interactive BaZi experience in MCP Apps-capable hosts (Claude Desktop). " +
-        "Falls back to a markdown table summary in other hosts.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            year: {
-                type: "integer",
-                description: "Gregorian birth year, e.g. 1987.",
-            },
-            month: {
-                type: "integer",
-                description: "Birth month (1–12).",
-            },
-            day: {
-                type: "integer",
-                description: "Birth day of month (1–31).",
-            },
-            hour: {
-                type: "integer",
-                description: "Birth hour (0–23). Optional, defaults to 12 (noon). " +
-                    "Chinese shí hours are 2-hour blocks — precision within a 2-hour window is sufficient.",
-            },
-            datetime: {
-                type: "string",
-                description: "Alternative to year/month/day: ISO 8601 datetime (e.g. '1987-07-15T14:00:00Z'). " +
-                    "year/month/day/hour are extracted automatically.",
-            },
-        },
-        required: [],
-        additionalProperties: false,
-    },
-    outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: {
-        title: "Interactive BaZi Four Pillars Explorer",
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-    _meta: {
-        ui: {
-            resourceUri: BAZI_RESOURCE_URI,
-            visibility: ["model", "app"],
-        },
-    },
-    handler: async (args) => {
-        const components = parseBaziArgs(args);
-        const client = getActiveClient();
-        const body = {
-            year: components.year,
-            month: components.month,
-            day: components.day,
-        };
-        if (components.hour != null)
-            body.hour = components.hour;
-        // Batch all three BaZi endpoints in parallel
-        const [chartResult, tenGodsResult, balanceResult] = await Promise.allSettled([
-            client.request("POST", "/chinese/bazi", { data: body }),
-            client.request("POST", "/chinese/bazi/ten-gods", { data: body }),
-            client.request("POST", "/chinese/bazi/element-balance", { data: body }),
-        ]);
-        const chartData = chartResult.status === "fulfilled"
-            ? chartResult.value
-            : { error: chartResult.reason?.message };
-        const tenGodsData = tenGodsResult.status === "fulfilled"
-            ? tenGodsResult.value
-            : { error: tenGodsResult.reason?.message };
-        const balanceData = balanceResult.status === "fulfilled"
-            ? balanceResult.value
-            : { error: balanceResult.reason?.message };
-        const uiPayload = {
-            chart: chartData,
-            ten_gods: tenGodsData,
-            element_balance: balanceData,
-            server_version: SERVER_VERSION,
-        };
-        const summary = buildBaziSummary(uiPayload);
-        const bundleAvailable = Boolean(getBaziBundle());
-        if (bundleAvailable) {
-            return {
-                content: [
-                    { type: "text", text: summary },
-                    { type: "text", text: JSON.stringify(uiPayload) },
-                ],
-                _meta: {
-                    "ui/resourceUri": BAZI_RESOURCE_URI,
-                    ui: { resourceUri: BAZI_RESOURCE_URI },
-                },
-            };
-        }
-        // Fallback: text summary only
-        return { content: [{ type: "text", text: summary }] };
-    },
-});

package/dist/tools/apps/transit-timeline-app.d.ts

@@ -1,20 +0,0 @@
-/**
- * transit-timeline-app.ts — MCP App tool registration for the Transit Timeline Explorer.
- *
- * Registers 1 tool:
- *   • explore_transit_timeline — primary entry point, returns data + UI resource [model]
- *
- * The timeline is rendered client-side from structured JSON — the tool reuses
- * the existing `ephemeris_transits` handler logic to compute natal chart positions
- * and search for transit events, then returns the data with a UI resource link
- * so the iframe can render a Gantt-style timeline.
- *
- * Also exports resource helpers (getTransitTimelineBundle, etc.) for use in
- * index.ts and server-sse.ts.
- */
-export declare const TRANSIT_TIMELINE_RESOURCE_URI = "ui://openephemeris/transit-timeline";
-export declare const TRANSIT_TIMELINE_MIME_TYPE = "text/html;profile=mcp-app";
-/** Read the pre-built HTML bundle. Returns null if not yet built. */
-export declare function getTransitTimelineBundle(): string | null;
-/** Reset cache (useful in dev watch mode or tests). */
-export declare function clearTransitTimelineBundleCache(): void;

package/dist/tools/apps/transit-timeline-app.js

@@ -1,295 +0,0 @@
-/**
- * transit-timeline-app.ts — MCP App tool registration for the Transit Timeline Explorer.
- *
- * Registers 1 tool:
- *   • explore_transit_timeline — primary entry point, returns data + UI resource [model]
- *
- * The timeline is rendered client-side from structured JSON — the tool reuses
- * the existing `ephemeris_transits` handler logic to compute natal chart positions
- * and search for transit events, then returns the data with a UI resource link
- * so the iframe can render a Gantt-style timeline.
- *
- * Also exports resource helpers (getTransitTimelineBundle, etc.) for use in
- * index.ts and server-sse.ts.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { registerTool, validateRequired, SERVER_VERSION } from "../index.js";
-import { getActiveClient } from "../../backend/client.js";
-import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
-// ── Constants ─────────────────────────────────────────────────────────────────
-export const TRANSIT_TIMELINE_RESOURCE_URI = "ui://openephemeris/transit-timeline";
-export const TRANSIT_TIMELINE_MIME_TYPE = "text/html;profile=mcp-app";
-const here = path.dirname(fileURLToPath(import.meta.url));
-const BUNDLE_PATHS = [
-    path.resolve(here, "..", "..", "..", "dist", "ui", "transit-timeline.html"),
-];
-function findBundlePath() {
-    for (const p of BUNDLE_PATHS) {
-        if (fs.existsSync(p))
-            return p;
-    }
-    return null;
-}
-let cachedBundle = null;
-/** Read the pre-built HTML bundle. Returns null if not yet built. */
-export function getTransitTimelineBundle() {
-    if (cachedBundle)
-        return cachedBundle;
-    const bundlePath = findBundlePath();
-    if (!bundlePath)
-        return null;
-    try {
-        cachedBundle = fs.readFileSync(bundlePath, "utf-8");
-        return cachedBundle;
-    }
-    catch {
-        return null;
-    }
-}
-/** Reset cache (useful in dev watch mode or tests). */
-export function clearTransitTimelineBundleCache() {
-    cachedBundle = null;
-}
-// ── Summary builder ──────────────────────────────────────────────────────────
-function buildTransitSummary(natalPositions, transitResult, aspectAngle, startDate, endDate) {
-    const transits = Array.isArray(transitResult)
-        ? transitResult
-        : (transitResult?.events ?? transitResult?.transits ?? transitResult?.results ?? []);
-    const count = transits.length;
-    const planets = [...new Set(transits.map((t) => String(t.planet ?? "")).filter(Boolean))];
-    const natalPoints = Object.keys(natalPositions);
-    const aspectLabel = aspectAngle === 0 ? "conjunction" : aspectAngle === 180 ? "opposition" : aspectAngle === 90 ? "square" : aspectAngle === 120 ? "trine" : aspectAngle + "°";
-    let summary = "**Transit Timeline — " + startDate + " to " + endDate + "**\n\n" +
-        count + " transit event" + (count !== 1 ? "s" : "") + " found";
-    if (aspectAngle !== 0) {
-        summary += " (" + aspectLabel + " aspect)";
-    }
-    summary += ".\n";
-    if (planets.length > 0) {
-        summary += "Transiting planets: " + planets.join(", ") + "\n";
-    }
-    if (natalPoints.length > 0) {
-        summary += "Natal points targeted: " + natalPoints.join(", ") + "\n";
-    }
-    summary += "\nClick any transit bar on the timeline for details and interpretation.";
-    return summary;
-}
-// ── Tool: explore_transit_timeline ────────────────────────────────────────────
-registerTool({
-    name: "explore_transit_timeline",
-    description: "Generate an interactive transit timeline visualization showing astrological transit events " +
-        "as a visual Gantt chart. Each transit appears as a colored bar on a time axis, grouped by " +
-        "transiting planet, with markers at exact aspect moments.\n\n" +
-        "This tool first calculates the natal chart to extract planetary longitudes, then searches " +
-        "for transiting planets crossing those degrees during the specified date range.\n\n" +
-        "SUPPORTED BODIES: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, " +
-        "Pluto, Chiron, Pholus, Ceres, Pallas, Juno, Vesta, MeanNode.\n\n" +
-        "ASPECT ANGLES: 0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine.\n\n" +
-        "Use this for a rich, interactive transit visualization in MCP Apps-capable hosts (Claude Desktop). " +
-        "Falls back to a text summary in other hosts.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            natal_datetime: {
-                type: "string",
-                description: "ISO 8601 birth datetime for the natal chart.",
-            },
-            natal_latitude: {
-                type: "number",
-                description: "Latitude of birth location in decimal degrees.",
-            },
-            natal_longitude: {
-                type: "number",
-                description: "Longitude of birth location in decimal degrees.",
-            },
-            start_date: {
-                type: "string",
-                description: "Start of the transit search window, ISO 8601 date or datetime.",
-            },
-            end_date: {
-                type: "string",
-                description: "End of the transit search window, ISO 8601 date or datetime.",
-            },
-            transiting_planets: {
-                type: "array",
-                items: { type: "string" },
-                description: "List of transiting planet IDs to search. Omit to search all outer planets.",
-            },
-            natal_points: {
-                type: "array",
-                items: { type: "string" },
-                description: "Natal point IDs whose longitudes should be targeted. Omit for all core points.",
-            },
-            aspect_angle: {
-                type: "number",
-                description: "Aspect angle in degrees. 0 = conjunction (default), 180 = opposition, 90 = square, 120 = trine.",
-            },
-        },
-        required: ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"],
-        additionalProperties: false,
-    },
-    outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: {
-        title: "Interactive Transit Timeline Explorer",
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-    _meta: {
-        ui: {
-            resourceUri: TRANSIT_TIMELINE_RESOURCE_URI,
-            visibility: ["model", "app"],
-        },
-    },
-    handler: async (args) => {
-        validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "start_date", "end_date"]);
-        const client = getActiveClient();
-        // Guard: reject excessively wide date ranges before hitting the backend.
-        // The Go backend clamps Explorer tier to 1 year, but larger tiers can still
-        // trigger compute-bound 45-second timeouts on very wide windows.
-        const startMs = new Date(args.start_date).getTime();
-        const endMs = new Date(args.end_date).getTime();
-        if (!isNaN(startMs) && !isNaN(endMs)) {
-            const spanDays = (endMs - startMs) / (1000 * 60 * 60 * 24);
-            if (spanDays > 5 * 365) {
-                throw new Error(`Date range too wide (${Math.round(spanDays / 365)} years). ` +
-                    `The transit timeline works best with windows under 2 years — try narrowing ` +
-                    `start_date and end_date to a 1–2 year window and re-run.`);
-            }
-        }
-        // Step 1: Compute natal chart to extract planetary longitudes
-        const natalBody = {
-            subject: {
-                name: "Transit Natal Subject",
-                birth_datetime: { iso: args.natal_datetime },
-                birth_location: {
-                    latitude: { decimal: args.natal_latitude },
-                    longitude: { decimal: args.natal_longitude },
-                },
-            },
-        };
-        const natalResult = await client.request("POST", "/ephemeris/natal-chart", { data: natalBody });
-        const targetDegrees = [];
-        const natalPositionMap = {};
-        const planets = natalResult?.planets || natalResult?.data?.planets || [];
-        const planetArray = Array.isArray(planets) ? planets : Object.values(planets);
-        // ── Core natal points to target (conjunction search) ─────────────────────
-        // When no natal_points filter is given, we limit to 7 core bodies to keep
-        // target_degrees count manageable. 4 outer planets × 10+ targets creates a
-        // combinatoric explosion (40+ serial SearchTransit calls on the backend).
-        const CORE_BODIES_DEFAULT = new Set([
-            "sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn",
-        ]);
-        const wantedPoints = args.natal_points
-            ? new Set(args.natal_points.map((p) => p.toLowerCase()))
-            : CORE_BODIES_DEFAULT;
-        for (const planet of planetArray) {
-            const name = (planet.name || planet.id || "").toLowerCase();
-            const lon = planet.longitude ?? planet.ecliptic_longitude ?? planet.lon;
-            if (typeof lon !== "number" || !isFinite(lon))
-                continue;
-            if (!wantedPoints.has(name))
-                continue;
-            targetDegrees.push(Math.round(lon * 100) / 100);
-            natalPositionMap[name] = lon;
-        }
-        // Extract angles (ASC, MC) — only if explicitly requested via natal_points
-        if (args.natal_points) {
-            const angles = natalResult?.angles || natalResult?.data?.angles;
-            if (angles) {
-                const angleEntries = Array.isArray(angles)
-                    ? angles
-                    : Object.entries(angles).map(([k, v]) => ({ name: k, ...(typeof v === "object" ? v : { longitude: v }) }));
-                for (const angle of angleEntries) {
-                    const name = (angle.name || angle.id || "").toLowerCase();
-                    const lon = angle.longitude ?? angle.ecliptic_longitude ?? angle.lon;
-                    if (typeof lon !== "number" || !isFinite(lon))
-                        continue;
-                    if (!wantedPoints.has(name))
-                        continue;
-                    targetDegrees.push(Math.round(lon * 100) / 100);
-                    natalPositionMap[name] = lon;
-                }
-            }
-        }
-        // Safety cap: never send more than 12 target degrees to the backend
-        // (prevents combinatoric timeouts when many planets + many targets overlap).
-        const MAX_TARGETS = 12;
-        if (targetDegrees.length > MAX_TARGETS) {
-            targetDegrees.splice(MAX_TARGETS);
-            // Prune natalPositionMap to match
-            const keepNames = new Set(Object.entries(natalPositionMap)
-                .filter(([, v]) => targetDegrees.includes(Math.round(v * 100) / 100))
-                .map(([k]) => k));
-            for (const k of Object.keys(natalPositionMap)) {
-                if (!keepNames.has(k))
-                    delete natalPositionMap[k];
-            }
-        }
-        if (targetDegrees.length === 0) {
-            throw new Error("Could not extract natal planet longitudes. Verify natal_datetime, natal_latitude, and natal_longitude.");
-        }
-        // Step 2: Search transits
-        let startStr = args.start_date;
-        if (/^\d{4}-\d{2}-\d{2}$/.test(startStr))
-            startStr += "T00:00:00Z";
-        let endStr = args.end_date;
-        if (/^\d{4}-\d{2}-\d{2}$/.test(endStr))
-            endStr += "T23:59:59Z";
-        const aspectAngle = typeof args.aspect_angle === "number" ? args.aspect_angle : 0;
-        let effectiveTargets = targetDegrees;
-        if (aspectAngle !== 0) {
-            effectiveTargets = targetDegrees.map((deg) => ((deg + aspectAngle) % 360 + 360) % 360);
-        }
-        const transitBody = {
-            start_date: startStr,
-            end_date: endStr,
-            target_degrees: effectiveTargets,
-        };
-        if (args.transiting_planets)
-            transitBody.planet_names = args.transiting_planets;
-        if (aspectAngle !== 0) {
-            transitBody.search_criteria = { aspect_angle: aspectAngle };
-        }
-        // Give the backend a 90s window — explorer tier allows 30s Go compute
-        // timeout, but the node-to-Fly round-trip including queuing can extend this.
-        const transitResult = await client.request("POST", "/predictive/transits/search", { data: transitBody, timeoutMs: 90_000 });
-        // Normalize the API response into a flat array so the iframe UI always
-        // receives an iterable — some backend response shapes wrap events in a
-        // container object rather than returning a bare array.
-        const transitArray = Array.isArray(transitResult)
-            ? transitResult
-            : (transitResult?.events ??
-                transitResult?.transits ??
-                transitResult?.results ??
-                []);
-        // Build payload
-        const payload = {
-            natal_positions: natalPositionMap,
-            target_degrees_used: effectiveTargets,
-            aspect_angle: aspectAngle,
-            transit_results: transitArray,
-            search_window: { start_date: args.start_date, end_date: args.end_date },
-            server_version: SERVER_VERSION,
-        };
-        const summary = buildTransitSummary(natalPositionMap, transitArray, aspectAngle, args.start_date, args.end_date);
-        const bundleAvailable = Boolean(getTransitTimelineBundle());
-        if (bundleAvailable) {
-            return {
-                content: [
-                    { type: "text", text: summary },
-                    { type: "text", text: JSON.stringify(payload) },
-                ],
-                _meta: {
-                    "ui/resourceUri": TRANSIT_TIMELINE_RESOURCE_URI,
-                    ui: { resourceUri: TRANSIT_TIMELINE_RESOURCE_URI },
-                },
-            };
-        }
-        // Fallback: text summary only
-        return { content: [{ type: "text", text: summary }] };
-    },
-});

package/dist/tools/apps/vedic-chart-app.d.ts

@@ -1,17 +0,0 @@
-/**
- * vedic-chart-app.ts — MCP App tool registration for the Vedic Jyotish Chart Explorer.
- *
- * Registers 1 tool:
- *   • explore_vedic_chart — primary entry point [model + app visible]
- *     Calls POST /vedic/chart and returns a data payload + UI resource URI
- *     so Claude Desktop can render the interactive South Indian Rashi grid.
- *
- * Also exports resource helpers (getVedicChartBundle, etc.) for use in
- * server-sse.ts resource listing and reading.
- */
-export declare const VEDIC_CHART_RESOURCE_URI = "ui://openephemeris/vedic-chart";
-export declare const VEDIC_CHART_MIME_TYPE = "text/html;profile=mcp-app";
-/** Read the pre-built HTML bundle. Returns null if not yet built. */
-export declare function getVedicChartBundle(): string | null;
-/** Reset cache (useful in dev watch mode or tests). */
-export declare function clearVedicChartBundleCache(): void;