@openephemeris/mcp-server 4.15.1 → 4.17.0

package/dist/tools/specialized/transits.js

@@ -4,20 +4,21 @@ import { OUTPUT_SCHEMA_JSON } from "../output-schemas.js";
 import { DATETIME_DESC, WINDOW_DATE_DESC, timezoneProperty } from "../datetime.js";
 registerTool({
     name: "ephemeris_transits",
-    description: "Search for astrological transit events affecting a natal chart over a date range. " +
-        "Returns exact transit moments — when transiting planets form specified aspects " +
-        "to natal planet positions.\n\n" +
-        "EFFICIENCY TIP: Always specify both transiting_planets and natal_points to keep " +
-        "compute fast. Omitting both sends all outer planets against all core natal positions " +
-        "— a much heavier computation.\n\n" +
-        "ASPECT ANGLES: Use aspect_angle to search for specific aspects:\n" +
-        "  0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine.\n" +
-        "  Example: Saturn Return → transiting_planets=['saturn'], natal_points=['saturn'], aspect_angle=0\n" +
-        "  Example: Uranus Opposition → transiting_planets=['uranus'], natal_points=['uranus'], aspect_angle=180\n" +
-        "  Example: Outer planets to natal Sun/Moon → transiting_planets=['saturn','uranus','neptune','pluto'], natal_points=['sun','moon']\n\n" +
-        "DEFAULT natal_points (when omitted): sun, moon, mercury, venus, mars, jupiter, saturn.\n" +
-        "SEARCH RANGE LIMITS: Explorer/PayG tier → 1 year max; Pro → 5 years; Startup → 10 years.\n" +
-        "CREDIT COST: 5 credits per call.",
+    description: "Use this when the user asks 'when is my Saturn return', 'when does Pluto square my Sun', 'when " +
+        "will Jupiter conjunct my Moon', 'what transits do I have next year' — any " +
+        "WHEN-does-a-transit-hit question, as data. Returns the exact moments transiting planets form the " +
+        "requested aspect to natal points over a date range.\n\n" +
+        "ASPECT ANGLES (aspect_angle): 0 = conjunction/return (default), 180 = opposition, 90 = square, " +
+        "120 = trine. Saturn return → transiting_planets=['saturn'], natal_points=['saturn'], " +
+        "aspect_angle=0.\n" +
+        "EFFICIENCY: always pass transiting_planets and natal_points — omitting both sweeps all outer " +
+        "planets against all core points and is slow. DEFAULT natal_points: sun, moon, mercury, venus, " +
+        "mars, jupiter, saturn.\n" +
+        "SEARCH RANGE LIMITS: Explorer/PayG → 1 year; Pro → 5 years; Startup → 10 years.\n" +
+        "CREDIT COST: 6 credits per call (natal chart + search).\n\n" +
+        "Do not use when the user should SEE a forecast — use explore_transit_timeline; for the sky today " +
+        "with no birth data use electional_moment_analysis; for retrograde dates use " +
+        "electional_station_tracker.",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/specialized/vedic.js

@@ -5,13 +5,14 @@ import { DATETIME_DESC, TIMEZONE_PROPERTY } from "../datetime.js";
 import { localToUtcIsoHistorical } from "../datetime-historical.js";
 registerTool({
     name: "vedic_chart",
-    description: "Calculate a Vedic (Jyotish) natal chart with sidereal positions. Returns planet placements " +
-        "in rashis (sidereal signs), nakshatras with pada, navamsa placements, and bhavas (houses). " +
-        "Uses Whole Sign houses, sidereal zodiac with configurable ayanamsa.\n\n" +
-        "CREDIT COST: 1 credit per call.\n\n" +
+    description: "Use this when the Vedic / Jyotish chart is wanted as data — 'my sidereal placements as JSON', " +
+        "'nakshatra and pada for every planet as a table', 'my navamsa positions'. Takes coordinates, not " +
+        "a place name. Returns sidereal planet placements in rashis, nakshatras with pada, navamsa " +
+        "placements and bhavas (Whole Sign houses).\n\n" +
         "SUPPORTED AYANAMSA: lahiri (default), fagan_bradley, krishnamurti, raman, yukteshwar\n\n" +
-        "EXAMPLE: Vedic chart for someone born Jan 15, 1990 at 8:30 AM UTC in Mumbai:\n" +
-        "  datetime='1990-01-15T08:30:00Z', latitude=19.076, longitude=72.8777",
+        "CREDIT COST: 1 credit per call.\n\n" +
+        "Do not use for 'what's my nakshatra / rashi / lagna' or when the user should SEE the chart — use " +
+        "explore_vedic_chart; for a Western tropical chart use ephemeris_natal_chart.",
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/ui-meta.d.ts

@@ -1,30 +1,5 @@
-/**
- * src/tools/ui-meta.ts — the `_meta` block a tool carries when it renders an MCP App.
- *
- * One builder, used by both transports (stdio `src/index.ts`, remote
- * `src/server-sse.ts`), because the two had drifted into copy-paste twins of the
- * same object literal and only one of them would ever get updated.
- *
- * Three wire forms, all describing the same `ui://` resource:
- *
- *   1. `_meta.ui.{resourceUri,visibility}` — the canonical MCP Apps form
- *      (SEP-1865, first official MCP extension 2026-01-26, folded into the
- *      2026-07-28 spec). This is what the spec says hosts read.
- *   2. `_meta["ui/resourceUri"]` — the deprecated flat alias. The spec says it
- *      "will be removed before general availability"; kept only for pre-GA
- *      hosts still on the older shape. Drop it once those are gone.
- *   3. `_meta["openai/*"]` — ChatGPT's compatibility aliases. OpenAI co-authored
- *      SEP-1865 and its own reference documents `openai/outputTemplate` as an
- *      "optional/compatibility alias for `_meta.ui.resourceUri`", so a fully
- *      converged ChatGPT host needs nothing here. Emitting it anyway is a few
- *      bytes and removes the question of which side converged first.
- *
- * `openai/widgetAccessible` marks a tool the widget itself may invoke. That is
- * exactly what `visibility` already encodes: a tool visible to "app" is one the
- * iframe calls (the `*_recalculate` and `*_on_*_click` handlers), so the flag is
- * derived rather than hand-maintained on 92 tools.
- */
 export interface UiMetaSource {
+    name?: string;
     _meta?: {
         ui?: {
             resourceUri?: string;
@@ -33,7 +8,7 @@ export interface UiMetaSource {
     };
 }
 /**
- * Build the `_meta` wrapper for a tool, or `{}` when the tool renders no UI.
- * Spread the result into the tools/list entry.
+ * Build the `_meta` wrapper for a tool, or `{}` when the tool renders no UI
+ * and has no invocation status. Spread the result into the tools/list entry.
  */
 export declare function buildUiMeta(tool: UiMetaSource): Record<string, unknown>;

package/dist/tools/ui-meta.js

@@ -23,26 +23,35 @@
  * exactly what `visibility` already encodes: a tool visible to "app" is one the
  * iframe calls (the `*_recalculate` and `*_on_*_click` handlers), so the flag is
  * derived rather than hand-maintained on 92 tools.
+ *
+ * The same block also carries ChatGPT's invocation status text
+ * (`openai/toolInvocation/invoking` / `invoked`, from invocation-status.ts)
+ * for any tool that has an entry there, UI or not — so a tool without a
+ * widget still gets a sentence instead of the host's generic spinner.
  */
+import { INVOCATION_STATUS } from "./invocation-status.js";
 const DEFAULT_VISIBILITY = ["model", "app"];
 /**
- * Build the `_meta` wrapper for a tool, or `{}` when the tool renders no UI.
- * Spread the result into the tools/list entry.
+ * Build the `_meta` wrapper for a tool, or `{}` when the tool renders no UI
+ * and has no invocation status. Spread the result into the tools/list entry.
  */
 export function buildUiMeta(tool) {
+    const meta = {};
     const resourceUri = tool._meta?.ui?.resourceUri;
-    if (!resourceUri)
-        return {};
-    const visibility = tool._meta?.ui?.visibility ?? DEFAULT_VISIBILITY;
-    return {
-        _meta: {
-            // Deprecated flat form — pre-GA hosts only.
-            "ui/resourceUri": resourceUri,
-            // Canonical MCP Apps form.
-            ui: { resourceUri, visibility },
-            // ChatGPT compatibility aliases.
-            "openai/outputTemplate": resourceUri,
-            "openai/widgetAccessible": visibility.includes("app"),
-        },
-    };
+    if (resourceUri) {
+        const visibility = tool._meta?.ui?.visibility ?? DEFAULT_VISIBILITY;
+        // Deprecated flat form — pre-GA hosts only.
+        meta["ui/resourceUri"] = resourceUri;
+        // Canonical MCP Apps form.
+        meta.ui = { resourceUri, visibility };
+        // ChatGPT compatibility aliases.
+        meta["openai/outputTemplate"] = resourceUri;
+        meta["openai/widgetAccessible"] = visibility.includes("app");
+    }
+    const status = tool.name ? INVOCATION_STATUS[tool.name] : undefined;
+    if (status) {
+        meta["openai/toolInvocation/invoking"] = status.invoking;
+        meta["openai/toolInvocation/invoked"] = status.invoked;
+    }
+    return Object.keys(meta).length ? { _meta: meta } : {};
 }