@kynver-app/mcp-estimator 0.1.1

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

@@ -0,0 +1,387 @@
+import { z } from "zod";
+declare const importCatalogSchema: z.ZodObject<{
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+}, {
+    message: string;
+}>;
+export declare const importCatalog: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+    }, {
+        message: string;
+    }>;
+    execute: (args: z.infer<typeof importCatalogSchema>) => Promise<string>;
+};
+declare const reviewImportSchema: z.ZodObject<{
+    importId: z.ZodString;
+    approved: z.ZodOptional<z.ZodBoolean>;
+    changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        action: z.ZodEnum<["keep", "skip", "edit"]>;
+        edits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        index: number;
+        action: "keep" | "skip" | "edit";
+        edits?: Record<string, unknown> | undefined;
+    }, {
+        index: number;
+        action: "keep" | "skip" | "edit";
+        edits?: Record<string, unknown> | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    importId: string;
+    approved?: boolean | undefined;
+    changes?: {
+        index: number;
+        action: "keep" | "skip" | "edit";
+        edits?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}, {
+    importId: string;
+    approved?: boolean | undefined;
+    changes?: {
+        index: number;
+        action: "keep" | "skip" | "edit";
+        edits?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}>;
+export declare const reviewImport: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        importId: z.ZodString;
+        approved: z.ZodOptional<z.ZodBoolean>;
+        changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            action: z.ZodEnum<["keep", "skip", "edit"]>;
+            edits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            index: number;
+            action: "keep" | "skip" | "edit";
+            edits?: Record<string, unknown> | undefined;
+        }, {
+            index: number;
+            action: "keep" | "skip" | "edit";
+            edits?: Record<string, unknown> | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        importId: string;
+        approved?: boolean | undefined;
+        changes?: {
+            index: number;
+            action: "keep" | "skip" | "edit";
+            edits?: Record<string, unknown> | undefined;
+        }[] | undefined;
+    }, {
+        importId: string;
+        approved?: boolean | undefined;
+        changes?: {
+            index: number;
+            action: "keep" | "skip" | "edit";
+            edits?: Record<string, unknown> | undefined;
+        }[] | undefined;
+    }>;
+    execute: (args: z.infer<typeof reviewImportSchema>) => Promise<string>;
+};
+declare const commitImportSchema: z.ZodObject<{
+    importId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    importId: string;
+}, {
+    importId: string;
+}>;
+export declare const commitImport: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        importId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        importId: string;
+    }, {
+        importId: string;
+    }>;
+    execute: (args: z.infer<typeof commitImportSchema>) => Promise<string>;
+};
+declare const setupPriceSchema: z.ZodObject<{
+    name: z.ZodString;
+    serviceCode: z.ZodString;
+    category: z.ZodString;
+    materialType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unit: z.ZodString;
+    materialCost: z.ZodNumber;
+    laborCost: z.ZodNumber;
+    minCharge: z.ZodOptional<z.ZodNumber>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    serviceCode: string;
+    category: string;
+    unit: string;
+    materialCost: number;
+    laborCost: number;
+    materialType?: string | null | undefined;
+    minCharge?: number | undefined;
+    notes?: string | undefined;
+}, {
+    name: string;
+    serviceCode: string;
+    category: string;
+    unit: string;
+    materialCost: number;
+    laborCost: number;
+    materialType?: string | null | undefined;
+    minCharge?: number | undefined;
+    notes?: string | undefined;
+}>;
+export declare const setupPrice: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        name: z.ZodString;
+        serviceCode: z.ZodString;
+        category: z.ZodString;
+        materialType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        unit: z.ZodString;
+        materialCost: z.ZodNumber;
+        laborCost: z.ZodNumber;
+        minCharge: z.ZodOptional<z.ZodNumber>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        serviceCode: string;
+        category: string;
+        unit: string;
+        materialCost: number;
+        laborCost: number;
+        materialType?: string | null | undefined;
+        minCharge?: number | undefined;
+        notes?: string | undefined;
+    }, {
+        name: string;
+        serviceCode: string;
+        category: string;
+        unit: string;
+        materialCost: number;
+        laborCost: number;
+        materialType?: string | null | undefined;
+        minCharge?: number | undefined;
+        notes?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof setupPriceSchema>) => Promise<string>;
+};
+declare const updatePriceSchema: z.ZodObject<{
+    itemId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    serviceCode: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    materialType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unit: z.ZodOptional<z.ZodString>;
+    materialCost: z.ZodOptional<z.ZodNumber>;
+    laborCost: z.ZodOptional<z.ZodNumber>;
+    minCharge: z.ZodOptional<z.ZodNumber>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    itemId: string;
+    name?: string | undefined;
+    serviceCode?: string | undefined;
+    category?: string | undefined;
+    materialType?: string | null | undefined;
+    unit?: string | undefined;
+    materialCost?: number | undefined;
+    laborCost?: number | undefined;
+    minCharge?: number | undefined;
+    notes?: string | undefined;
+}, {
+    itemId: string;
+    name?: string | undefined;
+    serviceCode?: string | undefined;
+    category?: string | undefined;
+    materialType?: string | null | undefined;
+    unit?: string | undefined;
+    materialCost?: number | undefined;
+    laborCost?: number | undefined;
+    minCharge?: number | undefined;
+    notes?: string | undefined;
+}>;
+export declare const updatePrice: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        itemId: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        serviceCode: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        materialType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        unit: z.ZodOptional<z.ZodString>;
+        materialCost: z.ZodOptional<z.ZodNumber>;
+        laborCost: z.ZodOptional<z.ZodNumber>;
+        minCharge: z.ZodOptional<z.ZodNumber>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        itemId: string;
+        name?: string | undefined;
+        serviceCode?: string | undefined;
+        category?: string | undefined;
+        materialType?: string | null | undefined;
+        unit?: string | undefined;
+        materialCost?: number | undefined;
+        laborCost?: number | undefined;
+        minCharge?: number | undefined;
+        notes?: string | undefined;
+    }, {
+        itemId: string;
+        name?: string | undefined;
+        serviceCode?: string | undefined;
+        category?: string | undefined;
+        materialType?: string | null | undefined;
+        unit?: string | undefined;
+        materialCost?: number | undefined;
+        laborCost?: number | undefined;
+        minCharge?: number | undefined;
+        notes?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof updatePriceSchema>) => Promise<string>;
+};
+declare const getCatalogSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    materialType: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    category?: string | undefined;
+    materialType?: string | undefined;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}, {
+    category?: string | undefined;
+    materialType?: string | undefined;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+}>;
+export declare const getCatalog: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        materialType: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        category?: string | undefined;
+        materialType?: string | undefined;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+    }, {
+        category?: string | undefined;
+        materialType?: string | undefined;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof getCatalogSchema>) => Promise<string>;
+};
+declare const getConfigSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const getConfig: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: (_args: z.infer<typeof getConfigSchema>) => Promise<string>;
+};
+declare const updateConfigSchema: z.ZodObject<{
+    defaultMarkup: z.ZodOptional<z.ZodNumber>;
+    taxRate: z.ZodOptional<z.ZodNumber>;
+    companyName: z.ZodOptional<z.ZodString>;
+    companyPhone: z.ZodOptional<z.ZodString>;
+    companyEmail: z.ZodOptional<z.ZodString>;
+    companyAddress: z.ZodOptional<z.ZodString>;
+    companyLogo: z.ZodOptional<z.ZodString>;
+    licenseNumber: z.ZodOptional<z.ZodString>;
+    defaultNotes: z.ZodOptional<z.ZodString>;
+    defaultTerms: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    defaultMarkup?: number | undefined;
+    taxRate?: number | undefined;
+    companyName?: string | undefined;
+    companyPhone?: string | undefined;
+    companyEmail?: string | undefined;
+    companyAddress?: string | undefined;
+    companyLogo?: string | undefined;
+    licenseNumber?: string | undefined;
+    defaultNotes?: string | undefined;
+    defaultTerms?: string | undefined;
+}, {
+    defaultMarkup?: number | undefined;
+    taxRate?: number | undefined;
+    companyName?: string | undefined;
+    companyPhone?: string | undefined;
+    companyEmail?: string | undefined;
+    companyAddress?: string | undefined;
+    companyLogo?: string | undefined;
+    licenseNumber?: string | undefined;
+    defaultNotes?: string | undefined;
+    defaultTerms?: string | undefined;
+}>;
+export declare const updateConfig: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        defaultMarkup: z.ZodOptional<z.ZodNumber>;
+        taxRate: z.ZodOptional<z.ZodNumber>;
+        companyName: z.ZodOptional<z.ZodString>;
+        companyPhone: z.ZodOptional<z.ZodString>;
+        companyEmail: z.ZodOptional<z.ZodString>;
+        companyAddress: z.ZodOptional<z.ZodString>;
+        companyLogo: z.ZodOptional<z.ZodString>;
+        licenseNumber: z.ZodOptional<z.ZodString>;
+        defaultNotes: z.ZodOptional<z.ZodString>;
+        defaultTerms: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        defaultMarkup?: number | undefined;
+        taxRate?: number | undefined;
+        companyName?: string | undefined;
+        companyPhone?: string | undefined;
+        companyEmail?: string | undefined;
+        companyAddress?: string | undefined;
+        companyLogo?: string | undefined;
+        licenseNumber?: string | undefined;
+        defaultNotes?: string | undefined;
+        defaultTerms?: string | undefined;
+    }, {
+        defaultMarkup?: number | undefined;
+        taxRate?: number | undefined;
+        companyName?: string | undefined;
+        companyPhone?: string | undefined;
+        companyEmail?: string | undefined;
+        companyAddress?: string | undefined;
+        companyLogo?: string | undefined;
+        licenseNumber?: string | undefined;
+        defaultNotes?: string | undefined;
+        defaultTerms?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof updateConfigSchema>) => Promise<string>;
+};
+declare const importTemplateSchema: z.ZodObject<{
+    templateId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    templateId?: string | undefined;
+}, {
+    templateId?: string | undefined;
+}>;
+export declare const importTemplate: {
+    name: string;
+    description: string;
+    inputSchemaZod: z.ZodObject<{
+        templateId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        templateId?: string | undefined;
+    }, {
+        templateId?: string | undefined;
+    }>;
+    execute: (args: z.infer<typeof importTemplateSchema>) => Promise<string>;
+};
+export {};

package/dist/tools/catalog-tools.js

@@ -0,0 +1,193 @@
+import { z } from "zod";
+import * as client from "../lib/kynver-client.js";
+// --- estimator_import_catalog ---
+const importCatalogSchema = z.object({
+    message: z.string(),
+});
+export const importCatalog = {
+    name: "estimator_import_catalog",
+    description: "Start a catalog import from a file. This is a placeholder — MCP cannot do file uploads. Describe the import request in the message field and the system will guide the user through the upload flow.",
+    inputSchemaZod: importCatalogSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.post("/v1/agents/kynver-estimator/chat", {
+            message: args.message,
+        });
+        return JSON.stringify(data);
+    },
+};
+// --- estimator_review_import ---
+const reviewImportSchema = z.object({
+    importId: z.string(),
+    approved: z.boolean().optional(),
+    changes: z
+        .array(z.object({
+        index: z.number(),
+        action: z.enum(["keep", "skip", "edit"]),
+        edits: z.record(z.unknown()).optional(),
+    }))
+        .optional(),
+});
+export const reviewImport = {
+    name: "estimator_review_import",
+    description: "Review a pending catalog import batch before committing. Shows parsed rows with suggested service codes, categories, and pricing. You can approve all, skip individual rows, or edit values before committing. Requires an importId from a previous import.",
+    inputSchemaZod: reviewImportSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const { importId, ...body } = args;
+        const data = await client.patch(`/estimator/import/${importId}`, body);
+        return JSON.stringify(data);
+    },
+};
+// --- estimator_commit_import ---
+const commitImportSchema = z.object({
+    importId: z.string(),
+});
+export const commitImport = {
+    name: "estimator_commit_import",
+    description: "Finalize a reviewed catalog import, writing all approved rows into the user's service catalog. Requires an importId that has been reviewed. This action cannot be undone — rows are added permanently.",
+    inputSchemaZod: commitImportSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.post(`/estimator/import/${args.importId}/commit`, {});
+        return JSON.stringify(data);
+    },
+};
+// --- estimator_setup_price ---
+const setupPriceSchema = z.object({
+    name: z.string(),
+    serviceCode: z.string(),
+    category: z.string(),
+    materialType: z.string().nullable().optional(),
+    unit: z.string(),
+    materialCost: z.number().min(0),
+    laborCost: z.number().min(0),
+    minCharge: z.number().min(0).optional(),
+    notes: z.string().optional(),
+});
+export const setupPrice = {
+    name: "estimator_setup_price",
+    description: "Add a new service to the user's price book (service catalog). Every service needs: a unique serviceCode (e.g., ROOF_INSPECT, SHINGLE_REPAIR), a display name, category (tear_off, decking, underlayment, field_install, flashing, ridge_cap, ventilation, gutters, cleanup, permit, misc, etc.), unit (sq_ft, linear_ft, each, sheet, roll, bundle, hour, lump), and material/labor costs. Items in the catalog are used when creating estimates.",
+    inputSchemaZod: setupPriceSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.post("/estimator/catalog", args);
+        return JSON.stringify(data);
+    },
+};
+// --- estimator_update_price ---
+const updatePriceSchema = z.object({
+    itemId: z.string(),
+    name: z.string().optional(),
+    serviceCode: z.string().optional(),
+    category: z.string().optional(),
+    materialType: z.string().nullable().optional(),
+    unit: z.string().optional(),
+    materialCost: z.number().min(0).optional(),
+    laborCost: z.number().min(0).optional(),
+    minCharge: z.number().min(0).optional(),
+    notes: z.string().optional(),
+});
+export const updatePrice = {
+    name: "estimator_update_price",
+    description: "Update an existing item in the service catalog. Use estimator_get_catalog first to find the itemId. You can change the name, service code, category, unit, material cost, labor cost, minimum charge, or notes.",
+    inputSchemaZod: updatePriceSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const { itemId, ...body } = args;
+        const data = await client.patch(`/estimator/catalog/${itemId}`, body);
+        return JSON.stringify(data);
+    },
+};
+// --- estimator_get_catalog ---
+const getCatalogSchema = z.object({
+    category: z.string().optional(),
+    materialType: z.string().optional(),
+    limit: z.number().optional(),
+    cursor: z.string().optional(),
+});
+export const getCatalog = {
+    name: "estimator_get_catalog",
+    description: "List all items in the user's service catalog (price book). Returns service codes, names, categories, units, and material/labor costs. IMPORTANT: Always call this before creating estimates to get valid service codes. Optional filters: category (tear_off, decking, underlayment, field_install, ridge_hip, flashing, misc, …) and materialType (asphalt_architectural, asphalt_3tab, metal_standing_seam, tpo, …) must match those exact enum strings — when unsure, omit both to fetch the full catalog.",
+    inputSchemaZod: getCatalogSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const params = new URLSearchParams();
+        if (args.category)
+            params.set("category", args.category);
+        if (args.materialType)
+            params.set("materialType", args.materialType);
+        if (args.limit != null)
+            params.set("limit", String(args.limit));
+        if (args.cursor)
+            params.set("cursor", args.cursor);
+        const q = params.toString();
+        const path = q ? `/estimator/catalog?${q}` : "/estimator/catalog";
+        const data = await client.get(path);
+        return JSON.stringify(data);
+    },
+};
+// --- estimator_get_config ---
+const getConfigSchema = z.object({});
+export const getConfig = {
+    name: "estimator_get_config",
+    description: "Get the user's estimator settings — company name, default markup/waste percentage, tax rate, currency, contact info, license number, and default notes/terms for estimates.",
+    inputSchemaZod: getConfigSchema,
+    execute: async (_args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.get("/estimator/config");
+        return JSON.stringify(data);
+    },
+};
+// --- estimator_update_config ---
+const updateConfigSchema = z.object({
+    defaultMarkup: z.number().optional(),
+    taxRate: z.number().optional(),
+    companyName: z.string().optional(),
+    companyPhone: z.string().optional(),
+    companyEmail: z.string().optional(),
+    companyAddress: z.string().optional(),
+    companyLogo: z.string().optional(),
+    licenseNumber: z.string().optional(),
+    defaultNotes: z.string().optional(),
+    defaultTerms: z.string().optional(),
+});
+export const updateConfig = {
+    name: "estimator_update_config",
+    description: "Update the user's estimator settings. You can set: companyName, defaultMarkup (waste %), taxRate, companyPhone, companyEmail, companyAddress, companyLogo (URL), licenseNumber, defaultNotes (appended to every estimate), and defaultTerms (terms & conditions).",
+    inputSchemaZod: updateConfigSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        const data = await client.patch("/estimator/config", args);
+        return JSON.stringify(data);
+    },
+};
+// --- estimator_import_template ---
+const importTemplateSchema = z.object({
+    templateId: z.string().optional(),
+});
+export const importTemplate = {
+    name: "estimator_import_template",
+    description: "Import a pre-built pricing catalog template into the user's service catalog. Call without arguments to see available templates (returns id, name, description, item count). Call with a templateId to import all items. These are MATERIAL COSTS ONLY — users should add their own labor rates after import. Items that already exist in the user's catalog are skipped (never overwritten).",
+    inputSchemaZod: importTemplateSchema,
+    execute: async (args) => {
+        if (!client.hasApiKey())
+            return client.noApiKeyMessage();
+        if (!args.templateId) {
+            const data = await client.get("/estimator/catalog/templates");
+            return JSON.stringify(data);
+        }
+        const data = await client.post("/estimator/catalog/templates", {
+            templateId: args.templateId,
+        });
+        return JSON.stringify(data);
+    },
+};