@kynver-app/mcp-estimator 0.2.5 → 0.2.7

package/package.json

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

package/src/server.ts

@@ -18,6 +18,7 @@ import * as clientTools from "./tools/client-tools.js";
 import * as takeoffTools from "./tools/takeoff-tools.js";
 import * as intakeTools from "./tools/intake-tools.js";
 import * as remodelEstimateTools from "./tools/remodel-estimate-tools.js";
+import * as remodelDeliverableTools from "./tools/remodel-deliverable-tools.js";
 import { readOwnPackageVersion } from "./lib/package-version.js";
 
 const PACKAGE_VERSION = readOwnPackageVersion(import.meta.url);
@@ -73,6 +74,7 @@ export function createEstimatorServer(): McpServer {
   register(estimateTools.deleteEstimate.name, { description: estimateTools.deleteEstimate.description, inputSchema: estimateTools.deleteEstimate.inputSchemaZod }, (args) => estimateTools.deleteEstimate.execute(args as any));
   register(estimateTools.duplicateEstimate.name, { description: estimateTools.duplicateEstimate.description, inputSchema: estimateTools.duplicateEstimate.inputSchemaZod }, (args) => estimateTools.duplicateEstimate.execute(args as any));
   register(remodelEstimateTools.buildRemodelEstimate.name, { description: remodelEstimateTools.buildRemodelEstimate.description, inputSchema: remodelEstimateTools.buildRemodelEstimate.inputSchemaZod }, (args) => remodelEstimateTools.buildRemodelEstimate.execute(args as any));
+  register(remodelDeliverableTools.buildRemodelDeliverable.name, { description: remodelDeliverableTools.buildRemodelDeliverable.description, inputSchema: remodelDeliverableTools.buildRemodelDeliverable.inputSchemaZod }, (args) => remodelDeliverableTools.buildRemodelDeliverable.execute(args as any));
 
   // --- Template tools (4) ---
   register(templateTools.saveTemplate.name, { description: templateTools.saveTemplate.description, inputSchema: templateTools.saveTemplate.inputSchemaZod }, (args) => templateTools.saveTemplate.execute(args as any));

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

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+
+const packageSchema = z.object({
+  intake: z.object({
+    projectName: z.string().optional(),
+    scopes: z.array(
+      z.object({
+        key: z.string(),
+        label: z.string().optional(),
+        quantity: z.number().optional(),
+        unit: z.string().optional(),
+        serviceCode: z.string().optional(),
+        budgetLump: z.number().optional(),
+        notes: z.string().optional(),
+      })
+    ),
+    expandScopeComponents: z.boolean().optional(),
+    includeStandardAlternates: z.boolean().optional(),
+    exclusions: z.array(z.string()).optional(),
+    assumptions: z.array(z.string()).optional(),
+    notes: z.string().optional(),
+  }),
+  pricing: z
+    .object({
+      contingencyPercent: z.number().optional(),
+      markupPercent: z.number().optional(),
+      profitPercent: z.number().optional(),
+    })
+    .optional(),
+});
+
+const buildDeliverableSchema = z.object({
+  preset: z.enum(["matthew-portland-2026-06"]).optional(),
+  client: z.object({
+    projectTitle: z.string(),
+    clientName: z.string().optional(),
+    preparedBy: z.string().optional(),
+    location: z.string().optional(),
+    documentType: z.string().optional(),
+    validityNote: z.string().optional(),
+  }),
+  budgetPackage: packageSchema.optional(),
+  fullPackage: packageSchema.optional(),
+  alternates: z
+    .array(
+      z.object({
+        key: z.string(),
+        label: z.string(),
+        description: z.string(),
+        budgetPlaceholder: z.number().nullable(),
+      })
+    )
+    .optional(),
+  correctionNote: z.string().optional(),
+  scopeBasis: z.array(z.string()).optional(),
+});
+
+export const buildRemodelDeliverable = {
+  name: "estimator_build_remodel_deliverable",
+  description:
+    "Build a dogfoodable residential remodel deliverable package with distinct budget/base and full/dream scope sections, separate alternates (never in headline totals), client-facing line-item descriptions, HTML/PDF handoff metadata, and MCP tool guidance for deeper detail. Use preset matthew-portland-2026-06 for the Matthew Portland fixture ($339,025 full / $167,200 bank-budget). Does not persist — use handoff JSON + reviewMarkdown to render client PDF/HTML. Supersedes hand-built deliverables that omitted structured sections. For single-scope preview only, use estimator_build_remodel_estimate.",
+  inputSchemaZod: buildDeliverableSchema,
+  execute: async (args: z.infer<typeof buildDeliverableSchema>): Promise<string> => {
+    if (!client.hasApiKey()) return client.noApiKeyMessage();
+    const data = await client.post(
+      "/estimator/estimates/build-remodel-deliverable",
+      args
+    );
+    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();