@openephemeris/mcp-server 4.18.0 → 4.19.0

package/dist/tools/apps/ui-resources.d.ts

@@ -0,0 +1,22 @@
+export interface UiResourceEntry {
+    uri: string;
+    /** Short name used in the "bundle not found" error. */
+    label: string;
+    name: string;
+    description: string;
+    /** Tells the model what the widget already shows (ChatGPT openai/widgetDescription). */
+    widgetDescription: string;
+    getBundle: () => string | null;
+}
+export declare const UI_RESOURCES: UiResourceEntry[];
+/** resources/list — only bundles that are actually built. */
+export declare function listUiResources(): Array<Record<string, unknown>>;
+/**
+ * resources/read. Matches on the URI WITHOUT its `?v=` so a host holding an
+ * older (or unversioned) URI from a cached tools/list still gets the current
+ * bundle; the content item echoes the URI that was asked for. Returns null for
+ * a URI that is not one of ours.
+ */
+export declare function readUiResource(uri: string): {
+    contents: Array<Record<string, unknown>>;
+} | null;

package/dist/tools/apps/ui-resources.js

@@ -0,0 +1,105 @@
+/**
+ * ui-resources.ts — the resources/list + resources/read registry for the seven
+ * MCP App bundles, shared by BOTH transports (src/index.ts stdio and
+ * src/server-sse.ts HTTP). They used to carry copy-paste twins of the same
+ * seven if-blocks; one table keeps URI, name, description and `_meta` in step.
+ */
+import { UI_RESOURCE_MIME_TYPE, uiResourceBase, uiResourceMeta } from "./ui-resource.js";
+import { CHART_WHEEL_RESOURCE_URI, getChartWheelBundle } from "./chart-wheel-app.js";
+import { BODYGRAPH_RESOURCE_URI, getBodygraphBundle } from "./bodygraph-app.js";
+import { BI_WHEEL_RESOURCE_URI, getBiWheelBundle } from "./bi-wheel-app.js";
+import { MOON_PHASE_RESOURCE_URI, getMoonPhaseBundle } from "./moon-phase-app.js";
+import { TRANSIT_TIMELINE_RESOURCE_URI, getTransitTimelineBundle } from "./transit-timeline-app.js";
+import { VEDIC_CHART_RESOURCE_URI, getVedicChartBundle } from "./vedic-chart-app.js";
+import { BAZI_RESOURCE_URI, getBaziBundle } from "./bazi-app.js";
+export const UI_RESOURCES = [
+    {
+        uri: CHART_WHEEL_RESOURCE_URI,
+        label: "Chart Wheel",
+        name: "Chart Wheel Explorer",
+        description: "Interactive natal chart wheel with clickable planets, houses, and aspects.",
+        widgetDescription: "Shows the full natal chart wheel — every planet, house cusp and aspect line — and lets the user click any of them for a reading. Don't repeat the placements as a list; highlight what stands out and invite them to explore the wheel.",
+        getBundle: getChartWheelBundle,
+    },
+    {
+        uri: BODYGRAPH_RESOURCE_URI,
+        label: "Bodygraph",
+        name: "Human Design Bodygraph Explorer",
+        description: "Interactive Human Design Bodygraph with clickable centers, gates, and channels.",
+        widgetDescription: "Shows the Human Design bodygraph with type, profile and authority, and lets the user click centers, channels and gates for their meaning. Don't redraw or list the whole chart; interpret the key points and point them to the graph.",
+        getBundle: getBodygraphBundle,
+    },
+    {
+        uri: BI_WHEEL_RESOURCE_URI,
+        label: "Bi-Wheel",
+        name: "Bi-Wheel Explorer",
+        description: "Interactive synastry or transit bi-wheel with cross-aspect lines and clickable planets.",
+        widgetDescription: "Shows two charts as a bi-wheel (natal inside, transits or a second person outside) with the cross-aspects drawn, each clickable. Don't list every cross-aspect; summarize the strongest contacts.",
+        getBundle: getBiWheelBundle,
+    },
+    {
+        uri: MOON_PHASE_RESOURCE_URI,
+        label: "Moon Phase",
+        name: "Moon Phase Explorer",
+        description: "Interactive lunar phase dial showing illumination, sign, and void-of-course status.",
+        widgetDescription: "Shows the current moon: phase, illumination, sign, void-of-course status, speed and the next new and full moon. Don't restate those numbers; add meaning or answer the user's question.",
+        getBundle: getMoonPhaseBundle,
+    },
+    {
+        uri: TRANSIT_TIMELINE_RESOURCE_URI,
+        label: "Transit Timeline",
+        name: "Transit Timeline Explorer",
+        description: "Interactive vertical timeline of upcoming transit hits grouped by month, with clickable events.",
+        widgetDescription: "Shows a dated timeline of upcoming transits to the natal chart, grouped by month, each clickable. Don't re-list the dates; call out the few that matter most.",
+        getBundle: getTransitTimelineBundle,
+    },
+    {
+        uri: VEDIC_CHART_RESOURCE_URI,
+        label: "Vedic Chart",
+        name: "Vedic Chart Explorer",
+        description: "Interactive Vedic (Jyotish) South Indian Rashi grid with clickable sign placements.",
+        widgetDescription: "Shows the sidereal South Indian Rashi chart with every graha in its sign, each clickable. Don't re-list placements; interpret the notable ones.",
+        getBundle: getVedicChartBundle,
+    },
+    {
+        uri: BAZI_RESOURCE_URI,
+        label: "BaZi",
+        name: "BaZi Four Pillars Explorer",
+        description: "Interactive BaZi (Four Pillars of Destiny) chart with clickable Year/Month/Day/Hour pillars.",
+        widgetDescription: "Shows the Four Pillars (year, month, day, hour stems and branches) with the Day Master, each pillar clickable. Don't re-list the pillars; interpret the balance.",
+        getBundle: getBaziBundle,
+    },
+];
+/** resources/list — only bundles that are actually built. */
+export function listUiResources() {
+    return UI_RESOURCES.filter((r) => r.getBundle()).map((r) => ({
+        uri: r.uri,
+        name: r.name,
+        description: r.description,
+        mimeType: UI_RESOURCE_MIME_TYPE,
+        _meta: uiResourceMeta(r.widgetDescription),
+    }));
+}
+/**
+ * resources/read. Matches on the URI WITHOUT its `?v=` so a host holding an
+ * older (or unversioned) URI from a cached tools/list still gets the current
+ * bundle; the content item echoes the URI that was asked for. Returns null for
+ * a URI that is not one of ours.
+ */
+export function readUiResource(uri) {
+    const base = uiResourceBase(uri);
+    const entry = UI_RESOURCES.find((r) => uiResourceBase(r.uri) === base);
+    if (!entry)
+        return null;
+    const bundle = entry.getBundle();
+    if (!bundle)
+        throw new Error(`${entry.label} UI bundle not found. Run \`npm run build:ui\` to build it.`);
+    return {
+        contents: [{
+                uri,
+                mimeType: UI_RESOURCE_MIME_TYPE,
+                text: bundle,
+                _meta: uiResourceMeta(entry.widgetDescription),
+            }],
+    };
+}

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

@@ -17,7 +17,7 @@
  * Also exports resource helpers (getVedicChartBundle, etc.) for use in
  * index.ts and server-sse.ts.
  */
-export declare const VEDIC_CHART_RESOURCE_URI = "ui://openephemeris/vedic-chart";
+export declare const VEDIC_CHART_RESOURCE_URI: string;
 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;

package/dist/tools/apps/vedic-chart-app.js

@@ -21,14 +21,15 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { registerTool, validateRequired, validateCoordinates, SERVER_VERSION } from "../index.js";
+import { UI_RESOURCE_MIME_TYPE, uiResourceUri } from "./ui-resource.js";
 import { getActiveClient } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 import { localToUtcIsoHistorical } from "../datetime-historical.js";
 import { coordsFromArgsOrLocation } from "./_location-resolver.js";
 import { RENDER_TOKEN_PROPERTY, renderTokenFromVisual, renderTokenHeaders } from "./_render-token.js";
 // ── Constants ─────────────────────────────────────────────────────────────────
-export const VEDIC_CHART_RESOURCE_URI = "ui://openephemeris/vedic-chart";
-export const VEDIC_CHART_MIME_TYPE = "text/html;profile=mcp-app";
+export const VEDIC_CHART_RESOURCE_URI = uiResourceUri("vedic-chart");
+export const VEDIC_CHART_MIME_TYPE = UI_RESOURCE_MIME_TYPE;
 const here = path.dirname(fileURLToPath(import.meta.url));
 const BUNDLE_PATHS = [
     path.resolve(here, "..", "..", "..", "dist", "ui", "vedic-chart.html"),