@openephemeris/mcp-server 4.8.0 → 4.10.0

package/dist/tools/specialized/bazi.js

@@ -2,7 +2,7 @@ import { registerTool } from "../index.js";
 import { getActiveClient } from "../../backend/client.js";
 import { OUTPUT_SCHEMA_IMAGE_AND_JSON } from "../output-schemas.js";
 export function parseBaziArgs(args, datetimeField = "datetime") {
-    let { year, month, day, hour } = args;
+    let { year, month, day, hour, minute } = args;
     const datetime = args[datetimeField];
     if (datetime && (!year || !month || !day)) {
         const parts = baziLocalComponents(datetime, args.timezone, datetimeField);
@@ -11,6 +11,8 @@ export function parseBaziArgs(args, datetimeField = "datetime") {
         day = parts.day;
         if (hour == null)
             hour = parts.hour;
+        if (minute == null)
+            minute = parts.minute;
     }
     if (!year || !month || !day) {
         throw new Error("Provide year/month/day fields, or a datetime ISO string. " +
@@ -19,8 +21,48 @@ export function parseBaziArgs(args, datetimeField = "datetime") {
     const out = { year, month, day };
     if (hour != null)
         out.hour = hour;
+    if (minute != null)
+        out.minute = minute;
     return out;
 }
+/**
+ * Build the optional BaZi convention fields (year_boundary, day_boundary,
+ * true_solar_time, latitude, longitude, timezone) to spread into a request
+ * body. `timezone` is wrapped to the API's `TimezoneInput` object shape.
+ *
+ * Kept separate from `parseBaziArgs`/`BaziComponents`: these fields frame
+ * which convention resolves the pillars rather than naming the birth moment
+ * itself, and bazi_compatibility needs the same set built twice under a
+ * `chart_a_`/`chart_b_` prefix.
+ */
+export function buildBaziConventionFields(args) {
+    const fields = {};
+    if (args.year_boundary != null)
+        fields.year_boundary = args.year_boundary;
+    if (args.day_boundary != null)
+        fields.day_boundary = args.day_boundary;
+    if (args.true_solar_time != null)
+        fields.true_solar_time = args.true_solar_time;
+    if (args.latitude != null)
+        fields.latitude = args.latitude;
+    if (args.longitude != null)
+        fields.longitude = args.longitude;
+    if (typeof args.timezone === "string" && args.timezone.trim() !== "") {
+        fields.timezone = { iana_name: args.timezone };
+    }
+    return fields;
+}
+/** `buildBaziConventionFields`, reading `<prefix>_<field>` args — used by bazi_compatibility. */
+export function buildBaziConventionFieldsPrefixed(args, prefix) {
+    return buildBaziConventionFields({
+        year_boundary: args[`${prefix}_year_boundary`],
+        day_boundary: args[`${prefix}_day_boundary`],
+        true_solar_time: args[`${prefix}_true_solar_time`],
+        latitude: args[`${prefix}_latitude`],
+        longitude: args[`${prefix}_longitude`],
+        timezone: args[`${prefix}_timezone`],
+    });
+}
 /**
  * Extract the LOCAL calendar/clock components a BaZi chart is built from.
  *
@@ -50,7 +92,7 @@ function baziLocalComponents(datetime, timezone, field) {
             hour: "2-digit", minute: "2-digit",
         }).formatToParts(new Date(value));
         const get = (t) => Number(parts.find((p) => p.type === t)?.value);
-        return { year: get("year"), month: get("month"), day: get("day"), hour: get("hour") % 24 };
+        return { year: get("year"), month: get("month"), day: get("day"), hour: get("hour") % 24, minute: get("minute") };
     }
     const m = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2}))?/.exec(value);
     if (!m) {
@@ -62,6 +104,7 @@ function baziLocalComponents(datetime, timezone, field) {
         month: Number(m[2]),
         day: Number(m[3]),
         hour: m[4] != null ? Number(m[4]) : undefined,
+        minute: m[5] != null ? Number(m[5]) : undefined,
     };
 }
 // Shared datetime input schema fragment — used across all BaZiRequest tools.
@@ -83,6 +126,10 @@ const DATETIME_PROPERTIES = {
         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.",
     },
+    minute: {
+        type: "integer",
+        description: "Birth minute (0–59). Optional, defaults to 0. Only matters under true_solar_time or near a boundary.",
+    },
     datetime: {
         type: "string",
         description: "Alternative to year/month/day: ISO 8601 datetime read as LOCAL wall-clock time at the " +
@@ -93,11 +140,49 @@ const DATETIME_PROPERTIES = {
     },
     timezone: {
         type: "string",
-        description: "IANA timezone name for the birth place, e.g. 'Asia/Shanghai'. Only needed when " +
-            "`datetime` carries a 'Z' or ±HH:MM offset, to convert that instant back to the local " +
-            "clock the pillars are built from.",
+        description: "IANA timezone name for the birth place, e.g. 'Asia/Shanghai'. Required to convert a " +
+            "zoned `datetime` back to local clock; also passed to the API to frame the year/month " +
+            "solar-term boundary at the true birth instant instead of naive local clock.",
+    },
+};
+// Optional convention fields, shared across every BaZiRequest-shaped tool —
+// see BaZiRequest in the Go API. Kept terse: core tool-surface budget is
+// near its ceiling (test/tool-surface-budget.test.ts).
+export const CONVENTION_PROPERTIES = {
+    year_boundary: {
+        type: "string",
+        enum: ["lichun", "cny"],
+        description: "Year-pillar cutover convention. Default lichun.",
+    },
+    day_boundary: {
+        type: "string",
+        enum: ["zi_hour", "midnight"],
+        description: "Day-pillar cutover convention. Default zi_hour.",
+    },
+    true_solar_time: {
+        type: "boolean",
+        description: "Apply true solar time correction (needs latitude+longitude).",
+    },
+    latitude: {
+        type: "number",
+        description: "Birth latitude, decimal degrees (north+).",
+    },
+    longitude: {
+        type: "number",
+        description: "Birth longitude, decimal degrees (east+).",
     },
 };
+/** CONVENTION_PROPERTIES (+ minute) under a `chart_a_`/`chart_b_` prefix — used by bazi_compatibility. */
+function chartConventionProperties(label) {
+    return {
+        [`chart_${label.toLowerCase()}_minute`]: { type: "integer", description: `Chart ${label} minute (0–59).` },
+        [`chart_${label.toLowerCase()}_year_boundary`]: { type: "string", enum: ["lichun", "cny"], description: `Chart ${label} year-pillar cutover.` },
+        [`chart_${label.toLowerCase()}_day_boundary`]: { type: "string", enum: ["zi_hour", "midnight"], description: `Chart ${label} day-pillar cutover.` },
+        [`chart_${label.toLowerCase()}_true_solar_time`]: { type: "boolean", description: `Chart ${label}: true solar time correction.` },
+        [`chart_${label.toLowerCase()}_latitude`]: { type: "number", description: `Chart ${label} latitude (decimal degrees, north+).` },
+        [`chart_${label.toLowerCase()}_longitude`]: { type: "number", description: `Chart ${label} longitude (decimal degrees, east+).` },
+    };
+}
 // Shared visual input schema fragment — mirrors natal.ts pattern.
 const VISUAL_PROPERTIES = {
     include_visual: {
@@ -153,14 +238,15 @@ registerTool({
         type: "object",
         properties: {
             ...DATETIME_PROPERTIES,
+            ...CONVENTION_PROPERTIES,
             ...VISUAL_PROPERTIES,
         },
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Four Pillars Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Four Pillars Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
-        const body = { ...parseBaziArgs(args) };
+        const body = { ...parseBaziArgs(args), ...buildBaziConventionFields(args) };
         applyVisualConfig(body, args);
         return await getActiveClient().request("POST", "/chinese/bazi", { data: body });
     },
@@ -190,14 +276,15 @@ registerTool({
         type: "object",
         properties: {
             ...DATETIME_PROPERTIES,
+            ...CONVENTION_PROPERTIES,
             ...VISUAL_PROPERTIES,
         },
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Ten Gods", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Ten Gods", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
-        const body = { ...parseBaziArgs(args) };
+        const body = { ...parseBaziArgs(args), ...buildBaziConventionFields(args) };
         applyVisualConfig(body, args);
         return await getActiveClient().request("POST", "/chinese/bazi/ten-gods", { data: body });
     },
@@ -225,14 +312,15 @@ registerTool({
         type: "object",
         properties: {
             ...DATETIME_PROPERTIES,
+            ...CONVENTION_PROPERTIES,
             ...VISUAL_PROPERTIES,
         },
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Element Balance", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Element Balance", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
-        const body = { ...parseBaziArgs(args) };
+        const body = { ...parseBaziArgs(args), ...buildBaziConventionFields(args) };
         applyVisualConfig(body, args);
         return await getActiveClient().request("POST", "/chinese/bazi/element-balance", { data: body });
     },
@@ -261,6 +349,7 @@ registerTool({
         type: "object",
         properties: {
             ...DATETIME_PROPERTIES,
+            ...CONVENTION_PROPERTIES,
             gender: {
                 type: "string",
                 enum: ["male", "female"],
@@ -273,16 +362,21 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Luck Pillars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Luck Pillars", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         if (!args.gender) {
             throw new Error("gender is required for luck pillar calculation. " +
                 "Provide 'male' or 'female' — the direction of Da Yun depends on gender and year polarity.");
         }
-        const { year, month, day, hour } = parseBaziArgs(args);
-        const body = { year, month, day, gender: args.gender };
+        const { year, month, day, hour, minute } = parseBaziArgs(args);
+        const body = {
+            year, month, day, gender: args.gender,
+            ...buildBaziConventionFields(args),
+        };
         if (hour != null)
             body.hour = hour;
+        if (minute != null)
+            body.minute = minute;
         return await getActiveClient().request("POST", "/chinese/bazi/luck-pillars", { data: body });
     },
 });
@@ -316,7 +410,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Annual Pillar", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Annual Pillar", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         if (!args.year) {
             throw new Error("year is required. Provide a Gregorian year (1–9999), e.g. year=2025.");
@@ -362,9 +456,10 @@ registerTool({
             },
             chart_a_timezone: {
                 type: "string",
-                description: "IANA timezone for Chart A's birth place, e.g. 'Asia/Shanghai'. Only needed when " +
-                    "chart_a_datetime carries a 'Z' or ±HH:MM offset.",
+                description: "IANA timezone for Chart A's birth place, e.g. 'Asia/Shanghai'. Needed when " +
+                    "chart_a_datetime carries a 'Z' or ±HH:MM offset; also frames Chart A's year/month boundary.",
             },
+            ...chartConventionProperties("A"),
             // Chart B
             chart_b_year: { type: "integer", description: "Chart B birth year." },
             chart_b_month: { type: "integer", description: "Chart B birth month (1–12)." },
@@ -378,20 +473,22 @@ registerTool({
             },
             chart_b_timezone: {
                 type: "string",
-                description: "IANA timezone for Chart B's birth place, e.g. 'Asia/Shanghai'. Only needed when " +
-                    "chart_b_datetime carries a 'Z' or ±HH:MM offset.",
+                description: "IANA timezone for Chart B's birth place, e.g. 'Asia/Shanghai'. Needed when " +
+                    "chart_b_datetime carries a 'Z' or ±HH:MM offset; also frames Chart B's year/month boundary.",
             },
+            ...chartConventionProperties("B"),
         },
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Compatibility", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Compatibility", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         const chartAComponents = parseBaziArgs({
             year: args.chart_a_year,
             month: args.chart_a_month,
             day: args.chart_a_day,
             hour: args.chart_a_hour,
+            minute: args.chart_a_minute,
             datetime: args.chart_a_datetime,
             timezone: args.chart_a_timezone,
         });
@@ -400,13 +497,14 @@ registerTool({
             month: args.chart_b_month,
             day: args.chart_b_day,
             hour: args.chart_b_hour,
+            minute: args.chart_b_minute,
             datetime: args.chart_b_datetime,
             timezone: args.chart_b_timezone,
         });
         return await getActiveClient().request("POST", "/chinese/bazi/compatibility", {
             data: {
-                chart_a: chartAComponents,
-                chart_b: chartBComponents,
+                chart_a: { ...chartAComponents, ...buildBaziConventionFieldsPrefixed(args, "chart_a") },
+                chart_b: { ...chartBComponents, ...buildBaziConventionFieldsPrefixed(args, "chart_b") },
             },
         });
     },
@@ -434,6 +532,7 @@ registerTool({
         type: "object",
         properties: {
             ...DATETIME_PROPERTIES,
+            ...CONVENTION_PROPERTIES,
             theme: {
                 type: "string",
                 enum: ["light", "dark", "mono"],
@@ -447,9 +546,9 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "BaZi Chart (Visual)", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "BaZi Chart (Visual)", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
-        const { year, month, day, hour } = parseBaziArgs(args);
+        const { year, month, day, hour, minute } = parseBaziArgs(args);
         const body = {
             year, month, day,
             visual_config: {
@@ -457,9 +556,12 @@ registerTool({
                 theme: args.theme ?? "light",
                 size: args.size ?? 800,
             },
+            ...buildBaziConventionFields(args),
         };
         if (hour != null)
             body.hour = hour;
+        if (minute != null)
+            body.minute = minute;
         return await getActiveClient().request("POST", "/chinese/bazi/chart", { data: body });
     },
 });

package/dist/tools/specialized/bi_wheel.js

@@ -40,7 +40,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE,
-    annotations: { title: "Bi-Wheel Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Bi-Wheel Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime_a", "latitude_a", "longitude_a", "datetime_b", "latitude_b", "longitude_b"]);
         assertZonedDatetime("datetime_a", args.datetime_a, args.timezone_a, "timezone_a");

package/dist/tools/specialized/chart_wheel.js

@@ -45,7 +45,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE,
-    annotations: { title: "Chart Wheel SVG", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Chart Wheel SVG", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         assertZonedDatetime("datetime", args.datetime, args.timezone);

package/dist/tools/specialized/comparative.js

@@ -51,7 +51,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Davison Relationship Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Davison Relationship Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -99,7 +99,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Midpoint Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Midpoint Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -147,7 +147,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Synastry House Overlay", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Synastry House Overlay", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, [
             "person_a_datetime", "person_a_latitude", "person_a_longitude",
@@ -193,7 +193,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Transits to Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Transits to Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude"]);
         assertPersonZoned("natal", args);

package/dist/tools/specialized/eclipse.js

@@ -42,7 +42,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Eclipse Finder", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Eclipse Finder", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["eclipse_type"]);
         validateCoordinates(args, "latitude", "longitude");

package/dist/tools/specialized/electional.js

@@ -59,7 +59,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Electional Timing Window", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Electional Timing Window", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["start_date", "end_date", "latitude", "longitude"]);
         const query = {
@@ -110,7 +110,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Moment Quality Analysis", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Moment Quality Analysis", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         const query = {};
         if (args.date)
@@ -164,7 +164,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Retrograde Station Tracker", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Retrograde Station Tracker", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         const query = {};
         // Map human-readable planet names to IDs if needed
@@ -224,7 +224,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Active Aspects Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Active Aspects Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         const query = {};
         if (args.date)
@@ -302,7 +302,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Angle Crossing Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Angle Crossing Search", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["latitude", "longitude"]);
         const query = {

package/dist/tools/specialized/ephemeris_core.js

@@ -40,7 +40,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Planet Position", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Planet Position", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["planet_id", "datetime"]);
         const body = {
@@ -89,7 +89,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "House Cusps", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "House Cusps", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         const body = {

package/dist/tools/specialized/ephemeris_extended.js

@@ -56,7 +56,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Natal Batch Charts", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Natal Batch Charts", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["subjects"]);
         args.subjects.forEach((s, i) => assertZonedDatetime(`subjects[${i}].datetime`, s?.datetime, s?.timezone, `subjects[${i}].timezone`));
@@ -82,7 +82,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Essential Dignities", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Essential Dignities", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         return await getActiveClient().post("/ephemeris/dignities", {
@@ -122,7 +122,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Retrograde Status", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Retrograde Status", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const client = getActiveClient();
@@ -173,7 +173,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Midpoints", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Midpoints", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/midpoints", {
@@ -219,7 +219,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Fixed Stars", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Fixed Stars", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         // A lone latitude would silently drop the angles from the scan, which is
@@ -262,7 +262,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Hermetic Lots", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Hermetic Lots", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/hermetic-lots", {
@@ -290,7 +290,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Angles & Points", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Angles & Points", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         return await getActiveClient().post("/ephemeris/angles-points", {
@@ -319,7 +319,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Aspect Check", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Aspect Check", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["longitude_1", "longitude_2"]);
         // Backend field names are longitude1 / longitude2 (no underscore)

package/dist/tools/specialized/hd_bodygraph.js

@@ -49,7 +49,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Human Design Bodygraph", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Human Design Bodygraph", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {

package/dist/tools/specialized/hd_cycles.js

@@ -58,7 +58,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "HD Planetary Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "HD Planetary Return", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "return_year"]);
         return await getActiveClient().request("POST", "/human-design/cycles/return", {
@@ -112,7 +112,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "HD Opposition Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "HD Opposition Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["planet", "datetime", "target_year"]);
         return await getActiveClient().request("POST", "/human-design/cycles/opposition", {

package/dist/tools/specialized/hd_group.js

@@ -53,7 +53,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "HD Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "HD Composite Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["person_a_datetime", "person_b_datetime"]);
         const body = {
@@ -123,7 +123,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "HD Penta Group Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "HD Penta Group Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["group_name", "members"]);
         const members = await Promise.all(args.members.map(async (m, i) => ({

package/dist/tools/specialized/human_design.js

@@ -62,7 +62,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "Human Design Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Human Design Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime"]);
         const body = {

package/dist/tools/specialized/moon.js

@@ -39,7 +39,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Moon Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Moon Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateCoordinates(args, "latitude", "longitude");
         const params = {};
@@ -104,7 +104,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Next Lunar Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Next Lunar Phase", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         const PHASE_LABELS = {
             new_moon: "New Moon",

package/dist/tools/specialized/natal.js

@@ -73,7 +73,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Natal Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["datetime", "latitude", "longitude"]);
         assertZonedDatetime("datetime", args.datetime, args.timezone);

package/dist/tools/specialized/progressed.js

@@ -60,7 +60,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_IMAGE_AND_JSON,
-    annotations: { title: "Progressed Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Progressed Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["birth_datetime", "birth_latitude", "birth_longitude", "target_datetime"]);
         assertZonedDatetime("birth_datetime", args.birth_datetime, args.timezone);

package/dist/tools/specialized/relocation.js

@@ -51,7 +51,7 @@ registerTool({
         additionalProperties: false,
     },
     outputSchema: OUTPUT_SCHEMA_JSON,
-    annotations: { title: "Relocation Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    annotations: { title: "Relocation Chart", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     handler: async (args) => {
         validateRequired(args, ["natal_datetime", "natal_latitude", "natal_longitude", "relocation_latitude", "relocation_longitude"]);
         assertZonedDatetime("natal_datetime", args.natal_datetime, args.timezone);