@kynver-app/mcp-estimator 0.2.8 → 0.2.10

package/dist/tools/intake-tools.js

@@ -0,0 +1,82 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+const remodelProjectTypeSchema = z.enum([
+    "kitchen_remodel",
+    "bath_remodel",
+    "kitchen_and_bath_remodel",
+    "whole_home_remodel",
+    "other_remodel",
+]);
+const normalizeRemodelIntakeSchema = z.object({
+    projectType: remodelProjectTypeSchema,
+    projectName: z.string().optional(),
+    siteAddress: z.string().optional(),
+    baseScopes: z
+        .array(z.object({
+        key: z.string().optional(),
+        label: z.string(),
+        quantity: z.number().optional(),
+        unit: z.string().optional(),
+        serviceCode: z.string().optional(),
+        budgetLump: z.number().optional(),
+        notes: z.string().optional(),
+        confidence: z.enum(["high", "medium", "low", "unknown"]).optional(),
+        isAlternate: z.boolean().optional(),
+        alternateGroup: z.string().optional(),
+    }))
+        .optional(),
+    alternates: z
+        .array(z.object({
+        key: z.string(),
+        label: z.string(),
+        scopeKeys: z.array(z.string()).optional(),
+        lumpAdd: z.number().optional(),
+        notes: z.string().optional(),
+    }))
+        .optional(),
+    attachments: z
+        .array(z.object({
+        id: z.string(),
+        kind: z.enum(["photo", "drawing", "plan_set", "spec_pdf", "spreadsheet", "other"]),
+        fileName: z.string().optional(),
+        caption: z.string().optional(),
+        url: z.string().optional(),
+        mimeType: z.string().optional(),
+    }))
+        .optional(),
+    exclusions: z.array(z.string()).optional(),
+    surprises: z.array(z.string()).optional(),
+    rateReferences: z
+        .array(z.object({
+        key: z.string(),
+        label: z.string(),
+        value: z.number(),
+        unit: z.string().optional(),
+        source: z.enum(["operating_rule", "catalog", "user", "takeoff"]),
+        catalogId: z.string().optional(),
+        confidence: z.enum(["high", "medium", "low", "unknown"]).optional(),
+    }))
+        .optional(),
+    assumptionsNeedingReview: z
+        .array(z.object({
+        id: z.string(),
+        text: z.string(),
+        severity: z.enum(["info", "warn", "blocker"]),
+        relatedScopeKey: z.string().optional(),
+    }))
+        .optional(),
+    remodelHints: z.record(z.string(), z.unknown()).optional(),
+    includeStandardAlternates: z.boolean().optional(),
+    notes: z.string().optional(),
+});
+export const normalizeRemodelIntake = {
+    name: "estimator_normalize_remodel_intake",
+    description: "Validate and normalize a residential remodel intake payload for kitchen/bath estimating. Accepts project type, base scopes vs alternates, drawing/photo attachment metadata, exclusions/surprises, rate references, and optional remodelHints from takeoff. Returns provenance-backed scopes, Will Portland default rates, assumptions needing review, and an estimate-builder-ready payload.",
+    inputSchemaZod: normalizeRemodelIntakeSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.post("/estimator/intake/normalize-remodel", args);
+        return JSON.stringify(data, null, 2);
+    },
+};

package/dist/tools/price-catalog-tools.d.ts

@@ -0,0 +1,96 @@
+import { z } from "zod";
+declare const listPriceCatalogsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const listPriceCatalogs: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: (_args: z.infer<typeof listPriceCatalogsSchema>) => Promise<string>;
+};
+declare const getPriceCatalogSchema: z.ZodObject<{
+    catalogId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    catalogId: string;
+}, {
+    catalogId: string;
+}>;
+export declare const getPriceCatalog: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        catalogId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        catalogId: string;
+    }, {
+        catalogId: string;
+    }>;
+    execute: (args: z.infer<typeof getPriceCatalogSchema>) => Promise<string>;
+};
+declare const resolvePriceSchema: z.ZodObject<{
+    serviceCode: z.ZodString;
+    materialType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    region: z.ZodOptional<z.ZodString>;
+    overrideMaterialCost: z.ZodOptional<z.ZodNumber>;
+    overrideLaborCost: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    serviceCode: string;
+    materialType?: string | null | undefined;
+    region?: string | undefined;
+    overrideMaterialCost?: number | undefined;
+    overrideLaborCost?: number | undefined;
+}, {
+    serviceCode: string;
+    materialType?: string | null | undefined;
+    region?: string | undefined;
+    overrideMaterialCost?: number | undefined;
+    overrideLaborCost?: number | undefined;
+}>;
+export declare const resolvePrice: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        serviceCode: z.ZodString;
+        materialType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        region: z.ZodOptional<z.ZodString>;
+        overrideMaterialCost: z.ZodOptional<z.ZodNumber>;
+        overrideLaborCost: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        serviceCode: string;
+        materialType?: string | null | undefined;
+        region?: string | undefined;
+        overrideMaterialCost?: number | undefined;
+        overrideLaborCost?: number | undefined;
+    }, {
+        serviceCode: string;
+        materialType?: string | null | undefined;
+        region?: string | undefined;
+        overrideMaterialCost?: number | undefined;
+        overrideLaborCost?: number | undefined;
+    }>;
+    execute: (args: z.infer<typeof resolvePriceSchema>) => Promise<string>;
+};
+declare const seedPriceCatalogSchema: z.ZodObject<{
+    catalogId: z.ZodString;
+    overwrite: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    catalogId: string;
+    overwrite?: boolean | undefined;
+}, {
+    catalogId: string;
+    overwrite?: boolean | undefined;
+}>;
+export declare const seedPriceCatalog: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        catalogId: z.ZodString;
+        overwrite: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        catalogId: string;
+        overwrite?: boolean | undefined;
+    }, {
+        catalogId: string;
+        overwrite?: boolean | undefined;
+    }>;
+    execute: (args: z.infer<typeof seedPriceCatalogSchema>) => Promise<string>;
+};
+export {};

package/dist/tools/price-catalog-tools.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+const listPriceCatalogsSchema = z.object({});
+export const listPriceCatalogs = {
+    name: "estimator_list_price_catalogs",
+    description: "List durable builtin price catalogs shipped with the estimator (region, effective date, markup policy). These are the MCP's stored price lists — not AgentOS memory. Use before seeding or resolving remodel defaults.",
+    inputSchemaZod: listPriceCatalogsSchema,
+    execute: async (_args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.get("/estimator/price-catalog");
+        return JSON.stringify(data);
+    },
+};
+const getPriceCatalogSchema = z.object({
+    catalogId: z.string(),
+});
+export const getPriceCatalog = {
+    name: "estimator_get_price_catalog",
+    description: "Read all unit-price lines from a builtin price catalog (service codes, units, material/labor split, review/confidence metadata). Default Portland remodel catalog id: portland-remodel-will-2026-06.",
+    inputSchemaZod: getPriceCatalogSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.get(`/estimator/price-catalog/${encodeURIComponent(args.catalogId)}`);
+        return JSON.stringify(data);
+    },
+};
+const resolvePriceSchema = z.object({
+    serviceCode: z.string(),
+    materialType: z.string().nullable().optional(),
+    region: z.string().optional(),
+    overrideMaterialCost: z.number().min(0).optional(),
+    overrideLaborCost: z.number().min(0).optional(),
+});
+export const resolvePrice = {
+    name: "estimator_resolve_price",
+    description: "Resolve unit pricing for one service code with provenance: user price book → builtin catalog → optional intake override (overrideMaterialCost/overrideLaborCost). Returns source, region, effective date, and markupIncluded flag.",
+    inputSchemaZod: resolvePriceSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const params = new URLSearchParams({ serviceCode: args.serviceCode });
+        if (args.materialType)
+            params.set("materialType", args.materialType);
+        if (args.region)
+            params.set("region", args.region);
+        if (args.overrideMaterialCost != null) {
+            params.set("overrideMaterialCost", String(args.overrideMaterialCost));
+        }
+        if (args.overrideLaborCost != null) {
+            params.set("overrideLaborCost", String(args.overrideLaborCost));
+        }
+        const data = await client.get(`/estimator/price-catalog/resolve?${params.toString()}`);
+        return JSON.stringify(data);
+    },
+};
+const seedPriceCatalogSchema = z.object({
+    catalogId: z.string(),
+    overwrite: z.boolean().optional(),
+});
+export const seedPriceCatalog = {
+    name: "estimator_seed_price_catalog",
+    description: "Copy a builtin price catalog into the user's ServiceCatalogItem price book (skips existing codes unless overwrite=true). Use portland-remodel-will-2026-06 for Will's Portland remodel working rates.",
+    inputSchemaZod: seedPriceCatalogSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.post("/estimator/price-catalog/seed", args);
+        return JSON.stringify(data);
+    },
+};