@kynver-app/mcp-estimator 0.2.4 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/mcp-estimator",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Kynver Estimator MCP server — chat, estimate, and catalog tools",
   "type": "module",
   "bin": {

package/src/server.ts

@@ -11,6 +11,7 @@ import * as templateTools from "./tools/template-tools.js";
 import * as versionTools from "./tools/version-tools.js";
 import * as photoTools from "./tools/photo-tools.js";
 import * as statsPdfTools from "./tools/stats-pdf-tools.js";
+import * as emailPdfTools from "./tools/email-pdf-tools.js";
 import * as visionTools from "./tools/vision-tools.js";
 import * as companyTools from "./tools/company-tools.js";
 import * as clientTools from "./tools/client-tools.js";
@@ -92,6 +93,7 @@ export function createEstimatorServer(): McpServer {
   register(statsPdfTools.getStats.name, { description: statsPdfTools.getStats.description, inputSchema: statsPdfTools.getStats.inputSchemaZod }, (args) => statsPdfTools.getStats.execute(args as any));
   register(statsPdfTools.exportPdf.name, { description: statsPdfTools.exportPdf.description, inputSchema: statsPdfTools.exportPdf.inputSchemaZod }, (args) => statsPdfTools.exportPdf.execute(args as any));
   register(statsPdfTools.updateOutputConfig.name, { description: statsPdfTools.updateOutputConfig.description, inputSchema: statsPdfTools.updateOutputConfig.inputSchemaZod }, (args) => statsPdfTools.updateOutputConfig.execute(args as any));
+  register(emailPdfTools.emailPdf.name, { description: emailPdfTools.emailPdf.description, inputSchema: emailPdfTools.emailPdf.inputSchemaZod }, (args) => emailPdfTools.emailPdf.execute(args as any));
 
   // --- Vision tools (2) ---
   register(visionTools.analyzePhotos.name, { description: visionTools.analyzePhotos.description, inputSchema: visionTools.analyzePhotos.inputSchemaZod }, (args) => visionTools.analyzePhotos.execute(args as any));

package/src/tools/email-pdf-tools.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+const emailPdfSchema = z.object({
+  estimateId: z.string(),
+  recipient: z.string().email().optional(),
+  subject: z.string().min(1).max(200).optional(),
+  message: z.string().min(1).max(10_000).optional(),
+  confirmExternalRecipient: z.boolean().optional().default(false),
+});
+
+export const emailPdf = {
+  name: "estimator_email_pdf",
+  description:
+    "Email an estimate PDF to a recipient. Fetches and attaches the PDF server-side (no secrets exposed). Defaults to the account owner's email when recipient is omitted. Estimate client emails and linked client records are trusted without extra confirmation; any other address requires confirmExternalRecipient=true after explicit user confirmation. Respects the estimate approval gate before customer send. Returns send status and audit metadata.",
+  inputSchemaZod: emailPdfSchema,
+  execute: async (args: z.infer<typeof emailPdfSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+
+    const { estimateId, ...body } = args;
+    const data = await client.post<unknown>(
+      `/estimator/estimates/${estimateId}/email-pdf`,
+      body,
+    );
+    return JSON.stringify(data);
+  },
+};

package/src/tools/remodel-estimate-tools.ts

@@ -27,7 +27,9 @@ const buildRemodelSchema = z.object({
       )
       .optional(),
     includeStandardAlternates: z.boolean().optional(),
+    expandScopeComponents: z.boolean().optional(),
     exclusions: z.array(z.string()).optional(),
+    assumptions: z.array(z.string()).optional(),
     notes: z.string().optional(),
   }),
   takeoffRows: z
@@ -68,7 +70,7 @@ const buildRemodelSchema = z.object({
 export const buildRemodelEstimate = {
   name: "estimator_build_remodel_estimate",
   description:
-    "Build a reviewable residential remodel estimate from normalized intake scopes, optional takeoff quantities, catalog prices, and overrides. Returns line items with provenance, alternates (both baths, upstairs expansion, roof, wall moving), exclusions, contingency/markup/profit breakdown, and reviewMarkdown. Does not persist — use estimator_generate_estimate_from_takeoff or estimator_create_repair after review. Scope keys: kitchen, bath_full, bath_half, bath_primary, bath_secondary, cabinets, drywall, paint, framing, roof, flooring, electrical_kitchen, electrical_bath.",
+    "Build a reviewable residential remodel estimate from normalized intake scopes, optional takeoff quantities, catalog prices, and overrides. Lump room scopes (kitchen, baths) auto-expand into a per-trade breakdown of line items (demolition, cabinetry, countertops, plumbing, electrical, appliances, flooring, tile, finishes) — each with its own scope-of-work description carried in notes — so client-facing output is itemized, not a single vague lump (set intake.expandScopeComponents=false for the legacy single-line behavior). Returns line items with provenance, alternates (both baths, upstairs expansion, roof, wall moving), a default+custom assumptions list, default+custom exclusions, contingency/markup/profit breakdown, and reviewMarkdown. Pass project-specific items via intake.assumptions and intake.exclusions. Does not persist — use estimator_generate_estimate_from_takeoff or estimator_create_repair after review. Room scope keys: kitchen, bath_full, bath_half, bath_primary, bath_secondary. Trade/quantity scope keys: cabinets, drywall, paint, framing, roof, flooring, electrical_kitchen, electrical_bath. Whole-project phase scope keys: general_conditions, permits, demolition, protection, final_clean.",
   inputSchemaZod: buildRemodelSchema,
   execute: async (args: z.infer<typeof buildRemodelSchema>): Promise<string> => {
     if (!client.hasApiKey()) return client.noApiKeyMessage();