astronomy-oracle 0.1.0

package/dist/format.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Markdown formatting functions for MCP tool responses.
+ */
+import type { CelestialObject, VisibilityInfo, SessionObject } from "./types.js";
+/**
+ * Format a single celestial object as detailed markdown.
+ */
+export declare function formatObject(obj: CelestialObject, visibility?: VisibilityInfo): string;
+/**
+ * Format an array of search results as a markdown table.
+ */
+export declare function formatSearchResults(objects: CelestialObject[]): string;
+/**
+ * Format a session plan with objects grouped by time window.
+ */
+export declare function formatSessionPlan(windows: Map<string, SessionObject[]>, location: {
+    lat: number;
+    lon: number;
+}, date: Date): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAgDpB;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,eAAe,EACpB,UAAU,CAAC,EAAE,cAAc,GAC1B,MAAM,CAgFR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAkCtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EACrC,QAAQ,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACtC,IAAI,EAAE,IAAI,GACT,MAAM,CAyER"}

package/dist/format.js

@@ -0,0 +1,204 @@
+/**
+ * Markdown formatting functions for MCP tool responses.
+ */
+/**
+ * Convert RA in degrees to "HHh MMm SS.Ss" format.
+ * RA degrees / 15 = hours.
+ */
+function degreesToHMS(deg) {
+    const totalHours = deg / 15;
+    const hours = Math.floor(totalHours);
+    const remainMinutes = (totalHours - hours) * 60;
+    const minutes = Math.floor(remainMinutes);
+    const seconds = (remainMinutes - minutes) * 60;
+    return `${hours}h ${String(minutes).padStart(2, "0")}m ${seconds.toFixed(1).padStart(4, "0")}s`;
+}
+/**
+ * Convert Dec in degrees to "+DD° MM' SS.S\"" format.
+ */
+function degreesToDMS(deg) {
+    const sign = deg >= 0 ? "+" : "-";
+    const abs = Math.abs(deg);
+    const degrees = Math.floor(abs);
+    const remainArcmin = (abs - degrees) * 60;
+    const arcmin = Math.floor(remainArcmin);
+    const arcsec = (remainArcmin - arcmin) * 60;
+    return `${sign}${degrees}° ${String(arcmin).padStart(2, "0")}' ${arcsec.toFixed(1).padStart(4, "0")}"`;
+}
+/**
+ * Format a Date as "HH:MM UTC".
+ */
+function formatTime(date) {
+    const h = String(date.getUTCHours()).padStart(2, "0");
+    const m = String(date.getUTCMinutes()).padStart(2, "0");
+    return `${h}:${m} UTC`;
+}
+/**
+ * Build the display name for an object, e.g. "M31 / NGC0224 / \"Andromeda Galaxy\""
+ */
+function buildTitle(obj) {
+    const parts = [];
+    if (obj.messier)
+        parts.push(obj.messier);
+    parts.push(obj.name);
+    if (obj.commonName)
+        parts.push(`"${obj.commonName}"`);
+    return parts.join(" / ");
+}
+/**
+ * Format a single celestial object as detailed markdown.
+ */
+export function formatObject(obj, visibility) {
+    const lines = [];
+    // Title
+    lines.push(`# ${buildTitle(obj)}`);
+    lines.push("");
+    // Core properties
+    lines.push(`- **Type:** ${obj.typeName}`);
+    lines.push(`- **Constellation:** ${obj.constellation}`);
+    lines.push(`- **RA:** ${degreesToHMS(obj.ra)}`);
+    lines.push(`- **Dec:** ${degreesToDMS(obj.dec)}`);
+    if (obj.magnitude !== null) {
+        lines.push(`- **Magnitude:** ${obj.magnitude}`);
+    }
+    if (obj.surfaceBrightness !== null) {
+        lines.push(`- **Surface Brightness:** ${obj.surfaceBrightness} mag/arcsec²`);
+    }
+    if (obj.majorAxis !== null) {
+        const size = obj.minorAxis !== null
+            ? `${obj.majorAxis}' × ${obj.minorAxis}'`
+            : `${obj.majorAxis}'`;
+        lines.push(`- **Angular Size:** ${size}`);
+        if (obj.positionAngle !== null) {
+            lines.push(`- **Position Angle:** ${obj.positionAngle}°`);
+        }
+    }
+    if (obj.hubbleType) {
+        lines.push(`- **Hubble Type:** ${obj.hubbleType}`);
+    }
+    // Cross-references
+    const xrefs = [];
+    if (obj.messier)
+        xrefs.push(obj.messier);
+    if (obj.ngcCrossRef)
+        xrefs.push(obj.ngcCrossRef);
+    if (obj.icCrossRef)
+        xrefs.push(obj.icCrossRef);
+    if (obj.otherIdentifiers)
+        xrefs.push(obj.otherIdentifiers);
+    if (xrefs.length > 0) {
+        lines.push("");
+        lines.push(`**Cross-references:** ${xrefs.join(", ")}`);
+    }
+    // Visibility section
+    if (visibility) {
+        lines.push("");
+        lines.push("## Current Visibility");
+        lines.push("");
+        if (visibility.neverRises) {
+            lines.push("This object **never rises** above the horizon at your location.");
+        }
+        else if (visibility.isCircumpolar) {
+            lines.push("This object is **circumpolar** — it never sets at your location.");
+            lines.push("");
+            lines.push(`- **Altitude:** ${visibility.altitude.toFixed(1)}°`);
+            lines.push(`- **Azimuth:** ${visibility.azimuth.toFixed(1)}°`);
+            if (visibility.transitTime) {
+                lines.push(`- **Transit:** ${formatTime(visibility.transitTime)}`);
+            }
+        }
+        else {
+            lines.push(`- **Altitude:** ${visibility.altitude.toFixed(1)}°`);
+            lines.push(`- **Azimuth:** ${visibility.azimuth.toFixed(1)}°`);
+            if (visibility.riseTime) {
+                lines.push(`- **Rise:** ${formatTime(visibility.riseTime)}`);
+            }
+            if (visibility.transitTime) {
+                lines.push(`- **Transit:** ${formatTime(visibility.transitTime)}`);
+            }
+            if (visibility.setTime) {
+                lines.push(`- **Set:** ${formatTime(visibility.setTime)}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format an array of search results as a markdown table.
+ */
+export function formatSearchResults(objects) {
+    if (objects.length === 0) {
+        return "No objects found.";
+    }
+    const lines = [];
+    lines.push(`Found ${objects.length} object(s):`);
+    lines.push("");
+    lines.push("| Name | Type | Mag | Size | Constellation | Common Name |");
+    lines.push("| --- | --- | ---: | --- | --- | --- |");
+    for (const obj of objects) {
+        const name = obj.messier
+            ? `${obj.messier} (${obj.name})`
+            : obj.name;
+        const mag = obj.magnitude !== null ? String(obj.magnitude) : "—";
+        const size = obj.majorAxis !== null
+            ? obj.minorAxis !== null
+                ? `${obj.majorAxis}' × ${obj.minorAxis}'`
+                : `${obj.majorAxis}'`
+            : "—";
+        const common = obj.commonName ?? "—";
+        lines.push(`| ${name} | ${obj.typeName} | ${mag} | ${size} | ${obj.constellation} | ${common} |`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a session plan with objects grouped by time window.
+ */
+export function formatSessionPlan(windows, location, date) {
+    const lines = [];
+    lines.push("# Observing Session Plan");
+    lines.push("");
+    lines.push(`**Location:** ${Math.abs(location.lat).toFixed(2)}°${location.lat >= 0 ? "N" : "S"}, ${Math.abs(location.lon).toFixed(2)}°${location.lon >= 0 ? "E" : "W"}  `);
+    lines.push(`**Date:** ${date.toISOString().slice(0, 10)}`);
+    const sections = [
+        {
+            key: "evening",
+            title: "Early Evening",
+            timeRange: "sunset–22:00",
+        },
+        {
+            key: "midnight",
+            title: "Late Night",
+            timeRange: "22:00–02:00",
+        },
+        {
+            key: "predawn",
+            title: "Pre-Dawn",
+            timeRange: "02:00–sunrise",
+        },
+    ];
+    for (const section of sections) {
+        lines.push("");
+        lines.push(`## ${section.title} (${section.timeRange})`);
+        lines.push("");
+        const objects = windows.get(section.key);
+        if (!objects || objects.length === 0) {
+            lines.push("No notable objects in this window.");
+            continue;
+        }
+        lines.push("| Object | Type | Mag | Peak Alt | Transit | Score |");
+        lines.push("| --- | --- | ---: | ---: | --- | ---: |");
+        for (const so of objects) {
+            const name = so.object.messier
+                ? `${so.object.messier} (${so.object.name})`
+                : so.object.name;
+            const mag = so.object.magnitude !== null ? String(so.object.magnitude) : "—";
+            const peakAlt = `${so.peakAltitude.toFixed(1)}°`;
+            const transit = formatTime(so.transitTime);
+            lines.push(`| ${name} | ${so.object.typeName} | ${mag} | ${peakAlt} | ${transit} | ${so.score} |`);
+        }
+    }
+    lines.push("");
+    lines.push("*Score reflects overall observability based on altitude, magnitude, and object type. Higher is better (0–100).*");
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for the astronomy-oracle MCP server.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for the astronomy-oracle MCP server.
+ */
+import { readFileSync } from "node:fs";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+console.error(`Astronomy Oracle v${pkg.version} — celestial object catalog & observing planner MCP server`);
+const server = createServer(pkg.version);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.on("SIGINT", async () => {
+    await server.close();
+    process.exit(0);
+});
+process.on("SIGTERM", async () => {
+    await server.close();
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CACnE,CAAC;AACF,OAAO,CAAC,KAAK,CACX,qBAAqB,GAAG,CAAC,OAAO,4DAA4D,CAC7F,CAAC;AAEF,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/search.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fuzzy search helper for catalog lookups.
+ */
+/**
+ * Case-insensitive substring search across multiple fields of an item.
+ * Returns all items where at least one specified field contains the query.
+ * Returns all items if query is empty.
+ * Safely skips null/undefined field values.
+ */
+export declare function fuzzySearch<T extends object>(items: T[], query: string, fields: (keyof T & string)[]): T[];
+//# sourceMappingURL=search.d.ts.map

package/dist/lib/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAC3B,CAAC,EAAE,CAYL"}

package/dist/lib/search.js

@@ -0,0 +1,21 @@
+/**
+ * Fuzzy search helper for catalog lookups.
+ */
+/**
+ * Case-insensitive substring search across multiple fields of an item.
+ * Returns all items where at least one specified field contains the query.
+ * Returns all items if query is empty.
+ * Safely skips null/undefined field values.
+ */
+export function fuzzySearch(items, query, fields) {
+    if (!query || query.trim() === "")
+        return [...items];
+    const lowerQuery = query.toLowerCase();
+    return items.filter((item) => fields.some((field) => {
+        const value = item[field];
+        if (value == null || typeof value !== "string")
+            return false;
+        return value.toLowerCase().includes(lowerQuery);
+    }));
+}
+//# sourceMappingURL=search.js.map

package/dist/lib/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,KAAU,EACV,KAAa,EACb,MAA4B;IAE5B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAErD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC7D,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/register-tools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Register all MCP tools with the server.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=register-tools.d.ts.map

package/dist/register-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-tools.d.ts","sourceRoot":"","sources":["../src/register-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAIrD"}

package/dist/register-tools.js

@@ -0,0 +1,12 @@
+/**
+ * Register all MCP tools with the server.
+ */
+import { registerLookupObject } from "./tools/lookup-object.js";
+import { registerSearchObjects } from "./tools/search-objects.js";
+import { registerPlanSession } from "./tools/plan-session.js";
+export function registerTools(server) {
+    registerLookupObject(server);
+    registerSearchObjects(server);
+    registerPlanSession(server);
+}
+//# sourceMappingURL=register-tools.js.map

package/dist/register-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-tools.js","sourceRoot":"","sources":["../src/register-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP server factory for astronomy-oracle.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(version?: string): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAOxD"}

package/dist/server.js

@@ -0,0 +1,14 @@
+/**
+ * MCP server factory for astronomy-oracle.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerTools } from "./register-tools.js";
+export function createServer(version) {
+    const server = new McpServer({
+        name: "astronomy-oracle",
+        version: version ?? "0.0.0",
+    });
+    registerTools(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO,IAAI,OAAO;KAC5B,CAAC,CAAC;IACH,aAAa,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/lookup-object.d.ts

@@ -0,0 +1,6 @@
+/**
+ * lookup_object tool — find a celestial object by name, designation, or common name.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLookupObject(server: McpServer): void;
+//# sourceMappingURL=lookup-object.d.ts.map

package/dist/tools/lookup-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-object.d.ts","sourceRoot":"","sources":["../../src/tools/lookup-object.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgE5D"}

package/dist/tools/lookup-object.js

@@ -0,0 +1,82 @@
+/**
+ * lookup_object tool — find a celestial object by name, designation, or common name.
+ */
+import { z } from "zod";
+import { getCatalog } from "../data/catalog.js";
+import { fuzzySearch } from "../lib/search.js";
+import { riseTransitSet } from "../astro/visibility.js";
+import { formatObject } from "../format.js";
+function findObject(store, name) {
+    // Try exact Messier match (uppercase)
+    const upperName = name.toUpperCase();
+    const messierMatch = store.byMessier.get(upperName);
+    if (messierMatch)
+        return messierMatch;
+    // Try exact primary name match
+    const byNameMatch = store.byName.get(name);
+    if (byNameMatch)
+        return byNameMatch;
+    // Try exact common name match (lowercase)
+    const commonMatch = store.byCommonName.get(name.toLowerCase());
+    if (commonMatch)
+        return commonMatch;
+    // Fuzzy search fallback
+    const allObjects = [...store.all.values()];
+    const fuzzyResults = fuzzySearch(allObjects, name, [
+        "name",
+        "messier",
+        "commonName",
+        "otherIdentifiers",
+    ]);
+    return fuzzyResults.length > 0 ? fuzzyResults[0] : null;
+}
+export function registerLookupObject(server) {
+    server.tool("lookup_object", "Look up a celestial object by Messier number (e.g. M31), NGC/IC designation (e.g. NGC7000), or common name (e.g. Andromeda Galaxy). Optionally compute visibility from a given location and time.", {
+        name: z
+            .string()
+            .describe("Object name, Messier number, NGC/IC designation, or common name"),
+        latitude: z
+            .number()
+            .min(-90)
+            .max(90)
+            .optional()
+            .describe("Observer latitude in degrees (-90 to 90)"),
+        longitude: z
+            .number()
+            .min(-180)
+            .max(180)
+            .optional()
+            .describe("Observer longitude in degrees (-180 to 180)"),
+        date: z
+            .string()
+            .optional()
+            .describe("Date/time in ISO 8601 format (defaults to now)"),
+    }, async ({ name, latitude, longitude, date }) => {
+        const store = await getCatalog();
+        const obj = findObject(store, name);
+        if (!obj) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No object found matching "${name}". Try the search_objects tool to browse by type, constellation, or magnitude.`,
+                    },
+                ],
+            };
+        }
+        let visibility;
+        if (latitude !== undefined && longitude !== undefined) {
+            const obsDate = date ? new Date(date) : new Date();
+            visibility = riseTransitSet(obj.ra, obj.dec, latitude, longitude, obsDate);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatObject(obj, visibility),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=lookup-object.js.map

package/dist/tools/lookup-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-object.js","sourceRoot":"","sources":["../../src/tools/lookup-object.ts"],"names":[],"mappings":"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"}

package/dist/tools/plan-session.d.ts

@@ -0,0 +1,6 @@
+/**
+ * plan_session tool — generate an observing session plan for a location and date.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPlanSession(server: McpServer): void;
+//# sourceMappingURL=plan-session.d.ts.map

package/dist/tools/plan-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-session.d.ts","sourceRoot":"","sources":["../../src/tools/plan-session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6H3D"}

package/dist/tools/plan-session.js

@@ -0,0 +1,118 @@
+/**
+ * plan_session tool — generate an observing session plan for a location and date.
+ */
+import { z } from "zod";
+import { getCatalog } from "../data/catalog.js";
+import { OBJECT_TYPES } from "../types.js";
+import { riseTransitSet } from "../astro/visibility.js";
+import { formatSessionPlan } from "../format.js";
+const typeKeys = Object.keys(OBJECT_TYPES).filter((k) => k !== "NonEx" && k !== "Dup");
+/**
+ * Classify a transit time's UTC hour into a session window.
+ */
+function classifyWindow(transitTime) {
+    const hour = transitTime.getUTCHours();
+    if (hour >= 18 && hour < 22)
+        return "evening";
+    if (hour >= 22 || hour < 2)
+        return "midnight";
+    if (hour >= 2 && hour < 6)
+        return "predawn";
+    // Default: pick closest window
+    if (hour >= 6 && hour < 15)
+        return "predawn"; // morning → predawn is closest
+    return "evening"; // afternoon → evening is closest
+}
+export function registerPlanSession(server) {
+    server.tool("plan_session", "Generate an observing session plan for a given location and date. Returns the best celestial objects to observe grouped by time window (evening, midnight, pre-dawn), scored by observability.", {
+        latitude: z
+            .number()
+            .min(-90)
+            .max(90)
+            .describe("Observer latitude in degrees (-90 to 90)"),
+        longitude: z
+            .number()
+            .min(-180)
+            .max(180)
+            .describe("Observer longitude in degrees (-180 to 180)"),
+        date: z
+            .string()
+            .optional()
+            .describe("Date in ISO 8601 format (defaults to today)"),
+        minAltitude: z
+            .number()
+            .optional()
+            .describe("Minimum peak altitude in degrees (default 15)"),
+        maxMagnitude: z
+            .number()
+            .optional()
+            .describe("Maximum (faintest) visual magnitude to include"),
+        types: z
+            .array(z.enum(typeKeys))
+            .optional()
+            .describe("Object type codes to include (e.g. [\"G\", \"PN\", \"OCl\"])"),
+    }, async (params) => {
+        const store = await getCatalog();
+        const { latitude, longitude, date: dateStr, minAltitude: minAltParam, maxMagnitude, types, } = params;
+        const obsDate = dateStr ? new Date(dateStr) : new Date();
+        const minAltitude = minAltParam ?? 15;
+        // Filter candidates
+        let candidates = [...store.all.values()];
+        // Only include objects with known magnitude
+        candidates = candidates.filter((obj) => obj.magnitude !== null);
+        if (maxMagnitude !== undefined) {
+            candidates = candidates.filter((obj) => obj.magnitude <= maxMagnitude);
+        }
+        if (types && types.length > 0) {
+            const typeSet = new Set(types);
+            candidates = candidates.filter((obj) => typeSet.has(obj.type));
+        }
+        // Compute visibility and score each candidate
+        const sessionObjects = [];
+        for (const obj of candidates) {
+            const vis = riseTransitSet(obj.ra, obj.dec, latitude, longitude, obsDate);
+            // Skip objects that never rise
+            if (vis.neverRises)
+                continue;
+            // Compute peak altitude: 90 - |lat - dec| (simple approximation)
+            const peakAltitude = 90 - Math.abs(latitude - obj.dec);
+            // Skip objects that don't reach minAltitude
+            if (peakAltitude < minAltitude)
+                continue;
+            // Need a transit time for window classification
+            const transitTime = vis.transitTime;
+            if (!transitTime)
+                continue;
+            const window = classifyWindow(transitTime);
+            // Score = peakAltitude + max(0, (12 - magnitude) * 5) + min(majorAxis or 0, 30)
+            const magBonus = Math.max(0, (12 - (obj.magnitude ?? 12)) * 5);
+            const sizeBonus = Math.min(obj.majorAxis ?? 0, 30);
+            const score = Math.round(peakAltitude + magBonus + sizeBonus);
+            sessionObjects.push({
+                object: obj,
+                peakAltitude,
+                transitTime,
+                window,
+                score,
+            });
+        }
+        // Group by window, sort by score desc, take top 15 per window
+        const windows = new Map();
+        for (const w of ["evening", "midnight", "predawn"]) {
+            const inWindow = sessionObjects
+                .filter((so) => so.window === w)
+                .sort((a, b) => b.score - a.score)
+                .slice(0, 15);
+            windows.set(w, inWindow);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatSessionPlan(windows, { lat: latitude, lon: longitude }, obsDate),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=plan-session.js.map

package/dist/tools/plan-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-session.js","sourceRoot":"","sources":["../../src/tools/plan-session.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-objects.d.ts

@@ -0,0 +1,6 @@
+/**
+ * search_objects tool — filter and browse the celestial object catalog.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchObjects(server: McpServer): void;
+//# sourceMappingURL=search-objects.d.ts.map

package/dist/tools/search-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-objects.d.ts","sourceRoot":"","sources":["../../src/tools/search-objects.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0I7D"}