@nestpilot/mcp-app 1.0.0

package/dist/tools/medicare-tools.js

@@ -0,0 +1,162 @@
+/**
+ * NestPilot Medicare Guardian — MCP tool registrations.
+ *
+ * Extracted from server.ts for domain separation.
+ * Registers three tools and one UI resource:
+ *   1. medicare-guardian  (public, has UI)  — launches the interactive view
+ *   2. medicare-analyze   (backend proxy)   — proxies analysis to Spring Boot API
+ *   3. email-subscribe    (backend proxy)   — proxies email subscription to API
+ *
+ * @feature FEAT-0052
+ */
+import { registerAppResource, registerAppTool, RESOURCE_MIME_TYPE, } from "@modelcontextprotocol/ext-apps/server";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { toCallToolResult, proxyPostTool, } from "./mcp-helpers.js";
+// Works both from source (tools/*.ts) and compiled (dist/)
+const DIST_DIR = import.meta.filename.endsWith(".ts")
+    ? path.join(import.meta.dirname, "..", "dist")
+    : path.join(import.meta.dirname);
+export function registerMedicareTools(server, authCtx) {
+    const resourceUri = "ui://medicare-guardian/mcp-app.html";
+    // ── 1. medicare-guardian ─────────────────────────────────────────────
+    // Public tool with linked UI. The host renders the view when invoked.
+    registerAppTool(server, "medicare-guardian", {
+        title: "Medicare Deadline Guardian",
+        description: `Open the Medicare Guardian to help users understand their Medicare enrollment deadlines and avoid lifetime penalties.
+
+USE THIS TOOL WHEN THE USER:
+- Asks about Medicare enrollment, Part A, Part B, or Part D
+- Is turning 65 or already past 65 and has Medicare questions
+- Wants to know when to sign up for Medicare
+- Asks about Medicare late enrollment penalties or premium surcharges
+- Mentions retiring and needs to switch from employer coverage to Medicare
+- Asks about Special Enrollment Periods (SEP) or Initial Enrollment Period (IEP)
+- Wonders if they can delay Medicare while still working
+- Asks about COBRA and Medicare coordination or timing
+- Wants deadline reminders for Medicare enrollment
+- Asks about Medicare IRMAA (Income-Related Monthly Adjustment Amount)
+- Needs to understand creditable vs non-creditable drug coverage
+- Has questions about employer coverage and Medicare coordination
+
+DO NOT USE FOR:
+- Comparing specific Medicare Advantage or Medigap plan prices/benefits
+- Medical diagnosis, treatment, or prescription questions
+- Retirement investment strategy (401k, IRA, stocks, pensions)
+- Social Security benefit calculations or claiming strategies
+- General health insurance brokerage or plan shopping`,
+        inputSchema: {
+            mode: z
+                .enum(["timeline", "sep_check", "penalty_estimate"])
+                .default("timeline")
+                .describe("Widget mode: 'timeline', 'sep_check', or 'penalty_estimate'"),
+        },
+        _meta: {
+            ui: {
+                resourceUri,
+                visibility: ["model", "app"],
+            },
+        },
+    }, async (args) => {
+        const { mode = "timeline" } = args;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        mode,
+                        message: `Initialized in ${mode} mode`,
+                    }),
+                },
+            ],
+        };
+    });
+    // ── 2. medicare-analyze ──────────────────────────────────────────────
+    // Backend proxy — called by the view via app.callServerTool().
+    server.tool("medicare-analyze", "Analyzes a user's Medicare situation. Called by the Medicare Guardian view to compute enrollment deadlines, penalty estimates, and a readiness score. Do not call this tool directly — it is used internally by the Medicare Guardian UI.", {
+        dateOfBirth: z.string().describe("Date of birth in YYYY-MM-DD format"),
+        employmentStatus: z
+            .enum(["WORKING", "RETIRED", "NOT_WORKING"])
+            .describe("Current employment status"),
+        coverageType: z
+            .enum([
+            "NONE",
+            "EMPLOYER_CURRENT",
+            "RETIREE",
+            "COBRA",
+            "MARKETPLACE",
+            "TRICARE",
+            "VA",
+        ])
+            .describe("Current health coverage type"),
+        employerSize: z
+            .enum(["LESS_THAN_20", "BETWEEN_20_AND_99", "100_PLUS"])
+            .optional()
+            .describe("Employer size (required when coverageType is EMPLOYER_CURRENT)"),
+        hsaContributor: z
+            .boolean()
+            .default(false)
+            .describe("Contributing to an HSA"),
+        hasCreditableDrugCoverage: z
+            .boolean()
+            .default(false)
+            .describe("Has creditable (Part D equivalent) drug coverage"),
+    }, async (args) => {
+        const result = await proxyPostTool("/api/medicare/guardian/analyze", args, { toolName: "medicare-analyze", authCtx });
+        // If proxyPostTool returned an error, pass it through
+        if (result.isError) {
+            return result;
+        }
+        // Normalise the backend response into a flat structure for the view.
+        // Unwrap provenance envelope if present (FEAT-0056 pipeline).
+        const textContent = result.content[0];
+        const parsed = JSON.parse(textContent.text);
+        const data = (parsed.data ?? parsed);
+        const summary = data.summary ?? {};
+        const responseData = {
+            status: summary.status,
+            healthScore: summary.healthScore,
+            deadlines: data.deadlines ?? [],
+            penalties: data.penalties ?? {},
+            checklist: data.checklist ?? [],
+            explanations: data.explanations ?? [],
+        };
+        return toCallToolResult(responseData);
+    });
+    // ── 3. email-subscribe ───────────────────────────────────────────────
+    // Backend proxy — subscribes a user to Medicare deadline reminders.
+    server.tool("email-subscribe", "Subscribes a user to Medicare deadline reminder emails. Called by the Medicare Guardian view after analysis. Do not call this tool directly — it is used internally by the Medicare Guardian UI.", {
+        email: z.string().describe("User's email address"),
+        score: z.number().describe("Medicare readiness score from analysis"),
+        iepEndDate: z
+            .string()
+            .optional()
+            .describe("IEP end date in YYYY-MM-DD if known"),
+        source: z
+            .string()
+            .default("mcp_medicare_guardian")
+            .describe("Sign-up source identifier"),
+    }, async (args) => {
+        const result = await proxyPostTool("/api/medicare/subscribe", args, { authCtx });
+        if (result.isError) {
+            return result;
+        }
+        const textContent = result.content[0];
+        const data = JSON.parse(textContent.text);
+        return toCallToolResult({
+            success: true,
+            message: data.message ?? "Subscribed!",
+        });
+    });
+    // ── UI Resource ──────────────────────────────────────────────────────
+    // Serves the bundled single-file HTML for the Medicare Guardian view.
+    registerAppResource(server, resourceUri, resourceUri, { mimeType: RESOURCE_MIME_TYPE }, async () => {
+        const html = await fs.readFile(path.join(DIST_DIR, "mcp-app.html"), "utf-8");
+        return {
+            contents: [
+                { uri: resourceUri, mimeType: RESOURCE_MIME_TYPE, text: html },
+            ],
+        };
+    });
+}

package/dist/tools/optimize-roth-tools-test.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRothTools(server: McpServer): void;

package/dist/tools/optimize-roth-tools-test.js

@@ -0,0 +1,36 @@
+/**
+ * Simplified Roth conversion optimization MCP tool for testing — FEAT-0066
+ */
+import { registerAppTool } from "@modelcontextprotocol/ext-apps/server";
+import { z } from "zod";
+import { toCallToolResult } from "./mcp-helpers.js";
+export function registerRothTools(server) {
+    console.log("registerRothTools: Starting registration...");
+    registerAppTool(server, "optimize_roth_conversion", {
+        title: "Optimize Roth Conversion",
+        description: `Test Roth conversion optimization tool.`,
+        inputSchema: {
+            filingStatus: z
+                .enum(["SINGLE", "MFJ", "MFS", "HOH"])
+                .describe("Tax filing status"),
+            currentAge: z
+                .number()
+                .int()
+                .min(18)
+                .max(100)
+                .describe("Current age"),
+        },
+        _meta: {
+            ui: {
+                visibility: ["model", "app"],
+            },
+        },
+    }, async (args) => {
+        console.log("optimize_roth_conversion tool called with args:", args);
+        return toCallToolResult({
+            message: "Test tool executed successfully",
+            args,
+        });
+    });
+    console.log("registerRothTools: Registration complete");
+}

package/dist/tools/optimize-roth-tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type AuthContext } from "./mcp-helpers.js";
+export declare function registerRothTools(server: McpServer, authCtx?: AuthContext): void;