@markcolabs/mcp 0.1.0

package/dist/index.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+/**
+ * @markcolabs/mcp — MCP server entrypoint.
+ *
+ * Sprint 136 v0.1.0 (per ADR-0039). Registers:
+ *   - 5 tools:
+ *       dc.calculator.mortgage.monthlyPayment       (S135 Item 5)
+ *       dc.calculator.compoundInterest.futureValue  (S135 Item 5)
+ *       dc.calculator.401k.projection               (S136 Item 3)
+ *       dc.calculator.socialSecurity.estimate       (S136 Item 3)
+ *       dc.calculator.paycheck.netPay               (S136 Item 3)
+ *   - 1 resource: dc://disclaimers/ymyl (canonical YMYL disclaimer)
+ *
+ * Transport: stdio (default for local MCP clients).
+ *
+ * S136 hits O5-KR1 5-tool target. Post-S136: methodology resources
+ * (dc://methodologies/*) and the `plan-retirement` prompt template (O5-KR2).
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { zodToJsonSchema } from "./util/zod-to-json-schema.js";
+import * as mortgageTool from "./tools/mortgage.js";
+import * as compoundInterestTool from "./tools/compoundInterest.js";
+import * as retirement401kTool from "./tools/retirement401k.js";
+import * as socialSecurityTool from "./tools/socialSecurity.js";
+import * as paycheckTool from "./tools/paycheck.js";
+import { YMYL_DISCLAIMER, YMYL_DISCLAIMER_URI, } from "./disclaimers/ymyl.js";
+// Re-export the tool execute functions and engines so consumers (and parity
+// tests) can import them directly without spinning up the MCP transport.
+export { execute as executeMortgageTool } from "./tools/mortgage.js";
+export { execute as executeCompoundInterestTool } from "./tools/compoundInterest.js";
+export { execute as executeRetirement401kTool } from "./tools/retirement401k.js";
+export { execute as executeSocialSecurityTool } from "./tools/socialSecurity.js";
+export { execute as executePaycheckTool } from "./tools/paycheck.js";
+export * as mortgageEngine from "./engines/mortgage.js";
+export * as compoundInterestEngine from "./engines/compoundInterest.js";
+export * as retirement401kEngine from "./engines/retirement401k.js";
+export * as socialSecurityEngine from "./engines/socialSecurity.js";
+export * as paycheckEngine from "./engines/paycheck.js";
+export * from "./envelope.js";
+// ---------------------------------------------------------------------------
+// Server setup
+// ---------------------------------------------------------------------------
+const server = new Server({
+    name: "@markcolabs/mcp",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// ---------------------------------------------------------------------------
+// tools/list
+// ---------------------------------------------------------------------------
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: mortgageTool.TOOL_NAME,
+                description: mortgageTool.TOOL_DESCRIPTION,
+                inputSchema: zodToJsonSchema(mortgageTool.MortgageMonthlyPaymentInputSchema),
+            },
+            {
+                name: compoundInterestTool.TOOL_NAME,
+                description: compoundInterestTool.TOOL_DESCRIPTION,
+                inputSchema: zodToJsonSchema(compoundInterestTool.CompoundInterestFutureValueInputSchema),
+            },
+            {
+                name: retirement401kTool.TOOL_NAME,
+                description: retirement401kTool.TOOL_DESCRIPTION,
+                inputSchema: zodToJsonSchema(retirement401kTool.Retirement401kProjectionInputSchema),
+            },
+            {
+                name: socialSecurityTool.TOOL_NAME,
+                description: socialSecurityTool.TOOL_DESCRIPTION,
+                inputSchema: zodToJsonSchema(socialSecurityTool.SocialSecurityEstimateInputSchema),
+            },
+            {
+                name: paycheckTool.TOOL_NAME,
+                description: paycheckTool.TOOL_DESCRIPTION,
+                inputSchema: zodToJsonSchema(paycheckTool.PaycheckNetPayInputSchema),
+            },
+        ],
+    };
+});
+// ---------------------------------------------------------------------------
+// tools/call
+// ---------------------------------------------------------------------------
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    let result;
+    switch (name) {
+        case mortgageTool.TOOL_NAME:
+            result = mortgageTool.execute(args);
+            break;
+        case compoundInterestTool.TOOL_NAME:
+            result = compoundInterestTool.execute(args);
+            break;
+        case retirement401kTool.TOOL_NAME:
+            result = retirement401kTool.execute(args);
+            break;
+        case socialSecurityTool.TOOL_NAME:
+            result = socialSecurityTool.execute(args);
+            break;
+        case paycheckTool.TOOL_NAME:
+            result = paycheckTool.execute(args);
+            break;
+        default:
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: {
+                                code: "INPUT_VALIDATION",
+                                message: `Unknown tool: ${name}`,
+                                retriable: false,
+                            },
+                        }),
+                    },
+                ],
+            };
+    }
+    if (result.ok) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result.value, null, 2),
+                },
+            ],
+        };
+    }
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result.error),
+            },
+        ],
+    };
+});
+// ---------------------------------------------------------------------------
+// resources/list — exposes the canonical YMYL disclaimer (O5-KR2 stub)
+// ---------------------------------------------------------------------------
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return {
+        resources: [
+            {
+                uri: YMYL_DISCLAIMER_URI,
+                name: "Canonical YMYL Disclaimer",
+                description: "Single source of truth for the YMYL disclaimer string returned in every tool response.",
+                mimeType: "text/plain",
+            },
+        ],
+    };
+});
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    if (uri === YMYL_DISCLAIMER_URI) {
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "text/plain",
+                    text: YMYL_DISCLAIMER,
+                },
+            ],
+        };
+    }
+    throw new Error(`Unknown resource: ${uri}`);
+});
+// ---------------------------------------------------------------------------
+// Boot — only run when invoked directly (not when imported by tests).
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // eslint-disable-next-line no-console
+    console.error("[@markcolabs/mcp] v0.1.0 ready (stdio) — 5 tools registered.");
+}
+// Run only when invoked as a binary, not when imported by parity tests.
+const isDirect = import.meta.url === `file://${process.argv[1]}` ||
+    process.argv[1]?.endsWith("dist/index.js") ||
+    process.argv[1]?.endsWith("dist\\index.js");
+if (isDirect) {
+    main().catch((err) => {
+        // eslint-disable-next-line no-console
+        console.error("[@markcolabs/mcp] fatal:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/shared/bounds.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Numeric bounds shared between Zod schemas and engines.
+ *
+ * Per ADR-0039 § 2: "Bounds match the constants already defined in the source
+ * calculator JS (e.g., MAX_HOME_PRICE = 100000000 from mortgage-calculator.js).
+ * Bounds are imported from a shared bounds.ts module so engine and schema cannot drift."
+ *
+ * If the site calculator constants change, update both surfaces in lockstep.
+ */
+export declare const MORTGAGE_BOUNDS: {
+    readonly MIN_PRINCIPAL: 0;
+    readonly MAX_PRINCIPAL: 100000000;
+    readonly MIN_RATE_PERCENT: 0;
+    readonly MAX_RATE_PERCENT: 30;
+    readonly MIN_TERM_YEARS: 1;
+    readonly MAX_TERM_YEARS: 50;
+};
+export declare const COMPOUND_INTEREST_BOUNDS: {
+    readonly MIN_PRINCIPAL: 0;
+    readonly MAX_PRINCIPAL: 100000000;
+    readonly MIN_RATE_PERCENT: 0;
+    readonly MAX_RATE_PERCENT: 50;
+    readonly MIN_YEARS: 0;
+    readonly MAX_YEARS: 100;
+    readonly MIN_MONTHLY_CONTRIBUTION: 0;
+    readonly MAX_MONTHLY_CONTRIBUTION: 1000000;
+};
+/**
+ * Allowed compounding-frequency labels and their per-year period counts.
+ * Matches the site calculator's compoundFrequency input options.
+ */
+export declare const COMPOUNDING_FREQUENCY: Record<"annually" | "semiannually" | "quarterly" | "monthly" | "daily", number>;
+export type CompoundingFrequencyLabel = keyof typeof COMPOUNDING_FREQUENCY;
+export declare const RETIREMENT_401K_BOUNDS: {
+    readonly MIN_CURRENT_BALANCE: 0;
+    readonly MAX_CURRENT_BALANCE: 100000000;
+    readonly MIN_ANNUAL_SALARY: 0;
+    readonly MAX_ANNUAL_SALARY: 100000000;
+    readonly MIN_CONTRIBUTION_PERCENT: 0;
+    readonly MAX_CONTRIBUTION_PERCENT: 100;
+    readonly MIN_EMPLOYER_MATCH_PERCENT: 0;
+    readonly MAX_EMPLOYER_MATCH_PERCENT: 100;
+    readonly MIN_EMPLOYER_MATCH_LIMIT_PERCENT: 0;
+    readonly MAX_EMPLOYER_MATCH_LIMIT_PERCENT: 100;
+    readonly MIN_SALARY_GROWTH_PERCENT: 0;
+    readonly MAX_SALARY_GROWTH_PERCENT: 20;
+    readonly MIN_RETURN_PERCENT: 0;
+    readonly MAX_RETURN_PERCENT: 20;
+    readonly MIN_AGE: 18;
+    readonly MAX_AGE: 100;
+};
+export declare const SOCIAL_SECURITY_BOUNDS: {
+    readonly MIN_BIRTH_YEAR: 1943;
+    readonly MAX_BIRTH_YEAR: 2004;
+    readonly MIN_CURRENT_EARNINGS: 0;
+    readonly MAX_CURRENT_EARNINGS: 1000000;
+    readonly MIN_CLAIM_AGE: 62;
+    readonly MAX_CLAIM_AGE: 70;
+    readonly MIN_LIFE_EXPECTANCY: 62;
+    readonly MAX_LIFE_EXPECTANCY: 120;
+    readonly MIN_YEARS_WORKED: 0;
+    readonly MAX_YEARS_WORKED: 50;
+};
+export declare const PAYCHECK_BOUNDS: {
+    readonly MIN_GROSS_ANNUAL_SALARY: 0;
+    readonly MAX_GROSS_ANNUAL_SALARY: 10000000;
+    readonly MIN_DEPENDENTS: 0;
+    readonly MAX_DEPENDENTS: 20;
+    readonly MIN_PRETAX_DEDUCTIONS: 0;
+    readonly MAX_PRETAX_DEDUCTIONS: 1000000;
+    readonly MIN_POSTTAX_DEDUCTIONS: 0;
+    readonly MAX_POSTTAX_DEDUCTIONS: 1000000;
+};
+/**
+ * Allowed paycheck pay-frequency labels. Mirrors site PAY_PERIODS keys
+ * (excluding hourly, which is computed differently and out of scope for v1).
+ */
+export declare const PAYCHECK_PAY_FREQUENCY: Record<"weekly" | "biweekly" | "semimonthly" | "monthly" | "quarterly" | "annual", number>;
+export type PaycheckPayFrequencyLabel = keyof typeof PAYCHECK_PAY_FREQUENCY;
+/** Federal filing-status enum (camelCase, matches paycheck engine). */
+export declare const FEDERAL_FILING_STATUS: readonly ["single", "married", "marriedSeparate", "headOfHousehold"];
+export type FederalFilingStatusLabel = (typeof FEDERAL_FILING_STATUS)[number];
+//# sourceMappingURL=bounds.d.ts.map

package/dist/shared/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../src/shared/bounds.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAKX,eAAO,MAAM,wBAAwB;;;;;;;;;CAS3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,EAC/D,MAAM,CAOP,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAQ3E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;CAiBzB,CAAC;AASX,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAWzB,CAAC;AAMX,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,EAC1E,MAAM,CAQP,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAE5E,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,sEAKxB,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/shared/bounds.js

@@ -0,0 +1,121 @@
+/**
+ * Numeric bounds shared between Zod schemas and engines.
+ *
+ * Per ADR-0039 § 2: "Bounds match the constants already defined in the source
+ * calculator JS (e.g., MAX_HOME_PRICE = 100000000 from mortgage-calculator.js).
+ * Bounds are imported from a shared bounds.ts module so engine and schema cannot drift."
+ *
+ * If the site calculator constants change, update both surfaces in lockstep.
+ */
+// -----------------------------------------------------------------------------
+// Mortgage calculator bounds
+// -----------------------------------------------------------------------------
+export const MORTGAGE_BOUNDS = {
+    MIN_PRINCIPAL: 0,
+    MAX_PRINCIPAL: 100_000_000,
+    MIN_RATE_PERCENT: 0,
+    MAX_RATE_PERCENT: 30,
+    MIN_TERM_YEARS: 1,
+    MAX_TERM_YEARS: 50,
+};
+// -----------------------------------------------------------------------------
+// Compound-interest calculator bounds
+// -----------------------------------------------------------------------------
+export const COMPOUND_INTEREST_BOUNDS = {
+    MIN_PRINCIPAL: 0,
+    MAX_PRINCIPAL: 100_000_000,
+    MIN_RATE_PERCENT: 0,
+    MAX_RATE_PERCENT: 50,
+    MIN_YEARS: 0,
+    MAX_YEARS: 100,
+    MIN_MONTHLY_CONTRIBUTION: 0,
+    MAX_MONTHLY_CONTRIBUTION: 1_000_000,
+};
+/**
+ * Allowed compounding-frequency labels and their per-year period counts.
+ * Matches the site calculator's compoundFrequency input options.
+ */
+export const COMPOUNDING_FREQUENCY = {
+    annually: 1,
+    semiannually: 2,
+    quarterly: 4,
+    monthly: 12,
+    daily: 365,
+};
+// -----------------------------------------------------------------------------
+// 401(k) projection bounds (S136)
+// -----------------------------------------------------------------------------
+// Mirrors the site 401k calculator's form ranges (see formFields config in
+// site/src/pages/401k-retirement-calculator/401k-retirement-calculator.js).
+// `MAX_RETURN_PERCENT` matches MAX_EXPECTED_RETURN constant in that file.
+export const RETIREMENT_401K_BOUNDS = {
+    MIN_CURRENT_BALANCE: 0,
+    MAX_CURRENT_BALANCE: 100_000_000,
+    MIN_ANNUAL_SALARY: 0,
+    MAX_ANNUAL_SALARY: 100_000_000,
+    MIN_CONTRIBUTION_PERCENT: 0,
+    MAX_CONTRIBUTION_PERCENT: 100,
+    MIN_EMPLOYER_MATCH_PERCENT: 0,
+    MAX_EMPLOYER_MATCH_PERCENT: 100,
+    MIN_EMPLOYER_MATCH_LIMIT_PERCENT: 0,
+    MAX_EMPLOYER_MATCH_LIMIT_PERCENT: 100,
+    MIN_SALARY_GROWTH_PERCENT: 0,
+    MAX_SALARY_GROWTH_PERCENT: 20,
+    MIN_RETURN_PERCENT: 0,
+    MAX_RETURN_PERCENT: 20,
+    MIN_AGE: 18,
+    MAX_AGE: 100,
+};
+// -----------------------------------------------------------------------------
+// Social Security estimate bounds (S136)
+// -----------------------------------------------------------------------------
+// Mirrors site/src/pages/social-security-calculator form ranges.
+// Birth year range matches site min/max (1943..2004) — anyone outside that
+// range can't realistically use 2014+ bend points or hasn't been born yet.
+// Claim age 62-70 is the SSA-allowed claiming window.
+export const SOCIAL_SECURITY_BOUNDS = {
+    MIN_BIRTH_YEAR: 1943,
+    MAX_BIRTH_YEAR: 2004,
+    MIN_CURRENT_EARNINGS: 0,
+    MAX_CURRENT_EARNINGS: 1_000_000,
+    MIN_CLAIM_AGE: 62,
+    MAX_CLAIM_AGE: 70,
+    MIN_LIFE_EXPECTANCY: 62,
+    MAX_LIFE_EXPECTANCY: 120,
+    MIN_YEARS_WORKED: 0,
+    MAX_YEARS_WORKED: 50,
+};
+// -----------------------------------------------------------------------------
+// Paycheck net-pay bounds (S136)
+// -----------------------------------------------------------------------------
+// Mirrors site/src/pages/paycheck-calculator form ranges + IRS reasonable caps.
+export const PAYCHECK_BOUNDS = {
+    MIN_GROSS_ANNUAL_SALARY: 0,
+    MAX_GROSS_ANNUAL_SALARY: 10_000_000,
+    MIN_DEPENDENTS: 0,
+    MAX_DEPENDENTS: 20,
+    MIN_PRETAX_DEDUCTIONS: 0,
+    MAX_PRETAX_DEDUCTIONS: 1_000_000,
+    MIN_POSTTAX_DEDUCTIONS: 0,
+    MAX_POSTTAX_DEDUCTIONS: 1_000_000,
+};
+/**
+ * Allowed paycheck pay-frequency labels. Mirrors site PAY_PERIODS keys
+ * (excluding hourly, which is computed differently and out of scope for v1).
+ */
+export const PAYCHECK_PAY_FREQUENCY = {
+    weekly: 52,
+    biweekly: 26,
+    semimonthly: 24,
+    monthly: 12,
+    quarterly: 4,
+    annual: 1,
+};
+/** Federal filing-status enum (camelCase, matches paycheck engine). */
+export const FEDERAL_FILING_STATUS = [
+    "single",
+    "married",
+    "marriedSeparate",
+    "headOfHousehold",
+];
+//# sourceMappingURL=bounds.js.map

package/dist/shared/bounds.js.map

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

package/dist/tools/compoundInterest.d.ts

@@ -0,0 +1,48 @@
+/**
+ * MCP tool wrapper for `dc.calculator.compoundInterest.futureValue`.
+ *
+ * Per ADR-0039 § 1: tool name locked.
+ * Per ADR-0039 § 2: Zod input with bounds from shared/bounds.ts; rate as Percent.
+ * Per ADR-0039 § 3: returns ToolResult<CompoundInterestFutureValueResult>.
+ * Per ADR-0039 § 4: errors funnel through ToolError.
+ */
+import { z } from "zod";
+import { type CompoundInterestFutureValueResult } from "../engines/compoundInterest.js";
+import { type ToolResult, type ToolError } from "../envelope.js";
+/** Locked tool name per ADR-0039 § 1. */
+export declare const TOOL_NAME = "dc.calculator.compoundInterest.futureValue";
+/**
+ * Zod input schema. `compoundingFrequency` is an enum of the supported labels.
+ */
+export declare const CompoundInterestFutureValueInputSchema: z.ZodObject<{
+    principal: z.ZodNumber;
+    annualRatePercent: z.ZodNumber;
+    years: z.ZodNumber;
+    compoundingFrequency: z.ZodEnum<["annually" | "semiannually" | "quarterly" | "monthly" | "daily", ...("annually" | "semiannually" | "quarterly" | "monthly" | "daily")[]]>;
+    monthlyContribution: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    principal: number;
+    annualRatePercent: number;
+    years: number;
+    compoundingFrequency: "annually" | "semiannually" | "quarterly" | "monthly" | "daily";
+    monthlyContribution?: number | undefined;
+}, {
+    principal: number;
+    annualRatePercent: number;
+    years: number;
+    compoundingFrequency: "annually" | "semiannually" | "quarterly" | "monthly" | "daily";
+    monthlyContribution?: number | undefined;
+}>;
+export type CompoundInterestFutureValueToolInput = z.infer<typeof CompoundInterestFutureValueInputSchema>;
+export declare const TOOL_DESCRIPTION: string;
+/**
+ * Execute the tool. Tagged-union return; SDK adapter maps to MCP isError.
+ */
+export declare function execute(rawInput: unknown): {
+    ok: true;
+    value: ToolResult<CompoundInterestFutureValueResult>;
+} | {
+    ok: false;
+    error: ToolError;
+};
+//# sourceMappingURL=compoundInterest.d.ts.map

package/dist/tools/compoundInterest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compoundInterest.d.ts","sourceRoot":"","sources":["../../src/tools/compoundInterest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,iCAAiC,EACvC,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,+CAA+C,CAAC;AAYtE;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;EA2BjD,CAAC;AAEH,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,sCAAsC,CAC9C,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAGyD,CAAC;AAEvF;;GAEG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,iCAAiC,CAAC,CAAA;CAAE,GAClE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAuDlC"}

package/dist/tools/compoundInterest.js

@@ -0,0 +1,107 @@
+/**
+ * MCP tool wrapper for `dc.calculator.compoundInterest.futureValue`.
+ *
+ * Per ADR-0039 § 1: tool name locked.
+ * Per ADR-0039 § 2: Zod input with bounds from shared/bounds.ts; rate as Percent.
+ * Per ADR-0039 § 3: returns ToolResult<CompoundInterestFutureValueResult>.
+ * Per ADR-0039 § 4: errors funnel through ToolError.
+ */
+import { z } from "zod";
+import { futureValue, ENGINE_VERSION, } from "../engines/compoundInterest.js";
+import { COMPOUND_INTEREST_BOUNDS, COMPOUNDING_FREQUENCY, } from "../shared/bounds.js";
+import { YMYL_DISCLAIMER } from "../disclaimers/ymyl.js";
+import { makeResult, makeError, } from "../envelope.js";
+/** Locked tool name per ADR-0039 § 1. */
+export const TOOL_NAME = "dc.calculator.compoundInterest.futureValue";
+const METHODOLOGY = {
+    url: "https://www.digitalcalculator.info/compound-interest-calculator/",
+    version: "2026-05-09",
+};
+const FREQUENCY_LABELS = Object.keys(COMPOUNDING_FREQUENCY);
+/**
+ * Zod input schema. `compoundingFrequency` is an enum of the supported labels.
+ */
+export const CompoundInterestFutureValueInputSchema = z.object({
+    principal: z
+        .number()
+        .min(COMPOUND_INTEREST_BOUNDS.MIN_PRINCIPAL)
+        .max(COMPOUND_INTEREST_BOUNDS.MAX_PRINCIPAL)
+        .describe("Initial principal in USD."),
+    annualRatePercent: z
+        .number()
+        .min(COMPOUND_INTEREST_BOUNDS.MIN_RATE_PERCENT)
+        .max(COMPOUND_INTEREST_BOUNDS.MAX_RATE_PERCENT)
+        .describe("Annual interest rate as whole-number percent (e.g., 7 for 7%)."),
+    years: z
+        .number()
+        .min(COMPOUND_INTEREST_BOUNDS.MIN_YEARS)
+        .max(COMPOUND_INTEREST_BOUNDS.MAX_YEARS)
+        .describe("Investment period in years."),
+    compoundingFrequency: z
+        .enum(FREQUENCY_LABELS)
+        .describe("How often interest compounds: annually | semiannually | quarterly | monthly | daily."),
+    monthlyContribution: z
+        .number()
+        .min(COMPOUND_INTEREST_BOUNDS.MIN_MONTHLY_CONTRIBUTION)
+        .max(COMPOUND_INTEREST_BOUNDS.MAX_MONTHLY_CONTRIBUTION)
+        .optional()
+        .describe("Optional monthly contribution in USD. Defaults to 0."),
+});
+export const TOOL_DESCRIPTION = "Project the future value of an initial principal with optional regular monthly " +
+    "contributions, compounding at the chosen frequency. Inputs are in USD; rate is a " +
+    "whole-number percent. Returns { futureValue, totalContributions, interestEarned }.";
+/**
+ * Execute the tool. Tagged-union return; SDK adapter maps to MCP isError.
+ */
+export function execute(rawInput) {
+    const parsed = CompoundInterestFutureValueInputSchema.safeParse(rawInput);
+    if (!parsed.success) {
+        const first = parsed.error.issues[0];
+        return {
+            ok: false,
+            error: makeError({
+                code: "INPUT_VALIDATION",
+                message: first?.message ?? "Invalid input.",
+                field: first?.path.join(".") || undefined,
+                retriable: false,
+            }),
+        };
+    }
+    const input = parsed.data;
+    let payload;
+    try {
+        payload = futureValue(input);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: makeError({
+                code: "INTERNAL",
+                message: "Engine error computing compound-interest future value.",
+                retriable: false,
+            }),
+        };
+    }
+    if (!Number.isFinite(payload.futureValue) ||
+        !Number.isFinite(payload.totalContributions) ||
+        !Number.isFinite(payload.interestEarned)) {
+        return {
+            ok: false,
+            error: makeError({
+                code: "INTERNAL",
+                message: "Compound-interest engine produced a non-finite result.",
+                retriable: false,
+            }),
+        };
+    }
+    return {
+        ok: true,
+        value: makeResult({
+            result: payload,
+            methodology: METHODOLOGY,
+            engineVersion: ENGINE_VERSION,
+            disclaimer: YMYL_DISCLAIMER,
+        }),
+    };
+}
+//# sourceMappingURL=compoundInterest.js.map

package/dist/tools/compoundInterest.js.map

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

package/dist/tools/mortgage.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MCP tool wrapper for `dc.calculator.mortgage.monthlyPayment`.
+ *
+ * Per ADR-0039 § 1: tool name is locked.
+ * Per ADR-0039 § 2: Zod input schema with bounds from shared/bounds.ts.
+ * Per ADR-0039 § 3: returns ToolResult<MortgageMonthlyPaymentResult>.
+ * Per ADR-0039 § 4: failures funnel through ToolError; tools never throw.
+ */
+import { z } from "zod";
+import { type MortgageMonthlyPaymentResult } from "../engines/mortgage.js";
+import { type ToolResult, type ToolError } from "../envelope.js";
+/** Locked tool name per ADR-0039 § 1. */
+export declare const TOOL_NAME = "dc.calculator.mortgage.monthlyPayment";
+/**
+ * Zod input schema. Bounds come from shared/bounds.ts so engine and schema cannot drift.
+ */
+export declare const MortgageMonthlyPaymentInputSchema: z.ZodObject<{
+    principal: z.ZodNumber;
+    annualRatePercent: z.ZodNumber;
+    termYears: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    principal: number;
+    annualRatePercent: number;
+    termYears: number;
+}, {
+    principal: number;
+    annualRatePercent: number;
+    termYears: number;
+}>;
+export type MortgageMonthlyPaymentToolInput = z.infer<typeof MortgageMonthlyPaymentInputSchema>;
+/**
+ * Tool description used in mcp.tools/list.
+ */
+export declare const TOOL_DESCRIPTION: string;
+/**
+ * Execute the tool. Validation + engine call wrapped in the standard envelope.
+ *
+ * Returns a tagged union:
+ *   { ok: true, value: ToolResult<...> }
+ *   { ok: false, error: ToolError }
+ *
+ * The MCP SDK adapter at src/index.ts maps `ok=false` to `isError: true`.
+ */
+export declare function execute(rawInput: unknown): {
+    ok: true;
+    value: ToolResult<MortgageMonthlyPaymentResult>;
+} | {
+    ok: false;
+    error: ToolError;
+};
+//# sourceMappingURL=mortgage.d.ts.map

package/dist/tools/mortgage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mortgage.d.ts","sourceRoot":"","sources":["../../src/tools/mortgage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,0CAA0C,CAAC;AAQjE;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;EAiB5C,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,iCAAiC,CACzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAIoB,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,4BAA4B,CAAC,CAAA;CAAE,GAC7D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CA0DlC"}