@kynver-app/mcp-estimator 0.2.16 → 0.2.18

package/dist/tools/remodel-estimate-tools.js

@@ -1,71 +0,0 @@
-import { z } from "zod";
-import * as client from "../lib/kynver-client.js";
-const scopeSchema = 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(),
-});
-const buildRemodelSchema = z.object({
-    intake: z.object({
-        projectName: z.string().optional(),
-        scopes: z.array(scopeSchema),
-        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(),
-        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
-        .array(z.object({
-        id: z.string().optional(),
-        description: z.string(),
-        quantity: z.number(),
-        unit: z.string(),
-        serviceCode: z.string().nullable().optional(),
-        materialType: z.string().nullable().optional(),
-    }))
-        .optional(),
-    overrides: z
-        .array(z.object({
-        scopeKey: z.string().optional(),
-        serviceCode: z.string().optional(),
-        description: z.string().optional(),
-        quantity: z.number().optional(),
-        unitMaterial: z.number().optional(),
-        unitLabor: z.number().optional(),
-        lumpTotal: z.number().optional(),
-        notes: z.string().optional(),
-    }))
-        .optional(),
-    pricing: z
-        .object({
-        contingencyPercent: z.number().optional(),
-        markupPercent: z.number().optional(),
-        profitPercent: z.number().optional(),
-    })
-        .optional(),
-});
-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. 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) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post("/estimator/estimates/build-remodel", args);
-        return JSON.stringify(data);
-    },
-};

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

@@ -1,89 +0,0 @@
-import { z } from "zod";
-declare const createSigningRequestSchema: z.ZodObject<{
-    estimateId: z.ZodString;
-    recipientEmail: z.ZodOptional<z.ZodString>;
-    recipientName: z.ZodOptional<z.ZodString>;
-    senderNote: z.ZodOptional<z.ZodString>;
-    expiresInDays: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    estimateId: string;
-    recipientEmail?: string | undefined;
-    recipientName?: string | undefined;
-    senderNote?: string | undefined;
-    expiresInDays?: number | undefined;
-}, {
-    estimateId: string;
-    recipientEmail?: string | undefined;
-    recipientName?: string | undefined;
-    senderNote?: string | undefined;
-    expiresInDays?: number | undefined;
-}>;
-export declare const createSigningRequest: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        estimateId: z.ZodString;
-        recipientEmail: z.ZodOptional<z.ZodString>;
-        recipientName: z.ZodOptional<z.ZodString>;
-        senderNote: z.ZodOptional<z.ZodString>;
-        expiresInDays: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        estimateId: string;
-        recipientEmail?: string | undefined;
-        recipientName?: string | undefined;
-        senderNote?: string | undefined;
-        expiresInDays?: number | undefined;
-    }, {
-        estimateId: string;
-        recipientEmail?: string | undefined;
-        recipientName?: string | undefined;
-        senderNote?: string | undefined;
-        expiresInDays?: number | undefined;
-    }>;
-    execute: (args: z.infer<typeof createSigningRequestSchema>) => Promise<string>;
-};
-declare const getSigningRequestsSchema: z.ZodObject<{
-    estimateId: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    estimateId: string;
-}, {
-    estimateId: string;
-}>;
-export declare const getSigningRequests: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        estimateId: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        estimateId: string;
-    }, {
-        estimateId: string;
-    }>;
-    execute: (args: z.infer<typeof getSigningRequestsSchema>) => Promise<string>;
-};
-declare const cancelSigningRequestSchema: z.ZodObject<{
-    estimateId: z.ZodString;
-    requestId: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    estimateId: string;
-    requestId: string;
-}, {
-    estimateId: string;
-    requestId: string;
-}>;
-export declare const cancelSigningRequest: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        estimateId: z.ZodString;
-        requestId: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        estimateId: string;
-        requestId: string;
-    }, {
-        estimateId: string;
-        requestId: string;
-    }>;
-    execute: (args: z.infer<typeof cancelSigningRequestSchema>) => Promise<string>;
-};
-export {};

package/dist/tools/signing-tools.js

@@ -1,51 +0,0 @@
-import { z } from "zod";
-import * as client from "../lib/kynver-client.js";
-const createSigningRequestSchema = z.object({
-    estimateId: z.string(),
-    recipientEmail: z.string().email().optional(),
-    recipientName: z.string().max(200).optional(),
-    senderNote: z.string().max(2000).optional(),
-    expiresInDays: z.number().int().min(1).max(365).optional(),
-});
-export const createSigningRequest = {
-    name: "estimator_create_signing_request",
-    description: "Create a contract signing request for an estimate. Returns a tokenized signing URL that can be shared with the client. The client can review and electronically sign the estimate at that URL. The signing request expires after expiresInDays (default 30). Does not send emails during implementation.",
-    inputSchemaZod: createSigningRequestSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const { estimateId, ...body } = args;
-        const data = await client.post(`/estimator/estimates/${estimateId}/signing-requests`, body);
-        return JSON.stringify(data);
-    },
-};
-const getSigningRequestsSchema = z.object({
-    estimateId: z.string(),
-});
-export const getSigningRequests = {
-    name: "estimator_get_signing_requests",
-    description: "List all signing requests for an estimate. Returns status (pending/signed/expired/cancelled), signing URL, recipient, and audit metadata for each request.",
-    inputSchemaZod: getSigningRequestsSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.get(`/estimator/estimates/${args.estimateId}/signing-requests`);
-        return JSON.stringify(data);
-    },
-};
-const cancelSigningRequestSchema = z.object({
-    estimateId: z.string(),
-    requestId: z.string(),
-});
-export const cancelSigningRequest = {
-    name: "estimator_cancel_signing_request",
-    description: "Cancel a pending signing request. Cannot cancel a request that has already been signed. The signing URL will become invalid immediately.",
-    inputSchemaZod: cancelSigningRequestSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const { estimateId, requestId } = args;
-        const data = await client.patch(`/estimator/estimates/${estimateId}/signing-requests`, { requestId });
-        return JSON.stringify(data);
-    },
-};

package/dist/tools/stats-pdf-tools.d.ts

@@ -1,113 +0,0 @@
-import { z } from "zod";
-declare const getStatsSchema: z.ZodObject<{
-    from: z.ZodOptional<z.ZodString>;
-    to: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    from?: string | undefined;
-    to?: string | undefined;
-}, {
-    from?: string | undefined;
-    to?: string | undefined;
-}>;
-export declare const getStats: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        from: z.ZodOptional<z.ZodString>;
-        to: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        from?: string | undefined;
-        to?: string | undefined;
-    }, {
-        from?: string | undefined;
-        to?: string | undefined;
-    }>;
-    execute: (args: z.infer<typeof getStatsSchema>) => Promise<string>;
-};
-declare const exportPdfSchema: z.ZodObject<{
-    estimateId: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    estimateId: string;
-}, {
-    estimateId: string;
-}>;
-export declare const exportPdf: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        estimateId: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        estimateId: string;
-    }, {
-        estimateId: string;
-    }>;
-    execute: (args: z.infer<typeof exportPdfSchema>) => Promise<string>;
-};
-declare const updateOutputConfigSchema: z.ZodObject<{
-    estimateId: z.ZodString;
-    showMaterialCost: z.ZodOptional<z.ZodBoolean>;
-    showLaborCost: z.ZodOptional<z.ZodBoolean>;
-    showUnitPrice: z.ZodOptional<z.ZodBoolean>;
-    showQuantity: z.ZodOptional<z.ZodBoolean>;
-    showNotes: z.ZodOptional<z.ZodBoolean>;
-    headerText: z.ZodOptional<z.ZodString>;
-    footerText: z.ZodOptional<z.ZodString>;
-    template: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    estimateId: string;
-    showMaterialCost?: boolean | undefined;
-    showLaborCost?: boolean | undefined;
-    showUnitPrice?: boolean | undefined;
-    showQuantity?: boolean | undefined;
-    showNotes?: boolean | undefined;
-    headerText?: string | undefined;
-    footerText?: string | undefined;
-    template?: string | undefined;
-}, {
-    estimateId: string;
-    showMaterialCost?: boolean | undefined;
-    showLaborCost?: boolean | undefined;
-    showUnitPrice?: boolean | undefined;
-    showQuantity?: boolean | undefined;
-    showNotes?: boolean | undefined;
-    headerText?: string | undefined;
-    footerText?: string | undefined;
-    template?: string | undefined;
-}>;
-export declare const updateOutputConfig: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        estimateId: z.ZodString;
-        showMaterialCost: z.ZodOptional<z.ZodBoolean>;
-        showLaborCost: z.ZodOptional<z.ZodBoolean>;
-        showUnitPrice: z.ZodOptional<z.ZodBoolean>;
-        showQuantity: z.ZodOptional<z.ZodBoolean>;
-        showNotes: z.ZodOptional<z.ZodBoolean>;
-        headerText: z.ZodOptional<z.ZodString>;
-        footerText: z.ZodOptional<z.ZodString>;
-        template: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        estimateId: string;
-        showMaterialCost?: boolean | undefined;
-        showLaborCost?: boolean | undefined;
-        showUnitPrice?: boolean | undefined;
-        showQuantity?: boolean | undefined;
-        showNotes?: boolean | undefined;
-        headerText?: string | undefined;
-        footerText?: string | undefined;
-        template?: string | undefined;
-    }, {
-        estimateId: string;
-        showMaterialCost?: boolean | undefined;
-        showLaborCost?: boolean | undefined;
-        showUnitPrice?: boolean | undefined;
-        showQuantity?: boolean | undefined;
-        showNotes?: boolean | undefined;
-        headerText?: string | undefined;
-        footerText?: string | undefined;
-        template?: string | undefined;
-    }>;
-    execute: (args: z.infer<typeof updateOutputConfigSchema>) => Promise<string>;
-};
-export {};

package/dist/tools/stats-pdf-tools.js

@@ -1,73 +0,0 @@
-import { z } from "zod";
-import * as client from "../lib/kynver-client.js";
-// --- estimator_get_stats ---
-const getStatsSchema = z.object({
-    from: z.string().optional(),
-    to: z.string().optional(),
-});
-export const getStats = {
-    name: "estimator_get_stats",
-    description: "Get aggregate statistics for the user's estimating business. Returns: total estimates count, estimates by status, total revenue (accepted estimates), average estimate value, estimates by type (replacement vs repair). Optionally filter by date range (from/to as ISO strings). Use this for dashboard data and business reporting.",
-    inputSchemaZod: getStatsSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const params = new URLSearchParams();
-        if (args.from)
-            params.set("from", args.from);
-        if (args.to)
-            params.set("to", args.to);
-        const q = params.toString();
-        const path = q ? `/estimator/stats?${q}` : "/estimator/stats";
-        const data = await client.get(path);
-        return JSON.stringify(data);
-    },
-};
-// --- estimator_export_pdf ---
-const exportPdfSchema = z.object({
-    estimateId: z.string(),
-});
-export const exportPdf = {
-    name: "estimator_export_pdf",
-    description: "Generate a PDF document for an estimate. Returns a download URL (not the binary file). The PDF layout is controlled by the estimate's output config — use estimator_update_output_config to customize which columns, sections, and details appear. The PDF includes company branding from estimator config.",
-    inputSchemaZod: exportPdfSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        // Trigger PDF generation on the server side
-        try {
-            await client.get(`/estimator/estimates/${args.estimateId}/pdf`);
-        }
-        catch {
-            // Even if the binary response fails to parse, the PDF was generated
-        }
-        return JSON.stringify({
-            message: "PDF generated successfully.",
-            downloadUrl: `/api/estimator/estimates/${args.estimateId}/pdf`,
-        });
-    },
-};
-// --- estimator_update_output_config ---
-const updateOutputConfigSchema = z.object({
-    estimateId: z.string(),
-    showMaterialCost: z.boolean().optional(),
-    showLaborCost: z.boolean().optional(),
-    showUnitPrice: z.boolean().optional(),
-    showQuantity: z.boolean().optional(),
-    showNotes: z.boolean().optional(),
-    headerText: z.string().optional(),
-    footerText: z.string().optional(),
-    template: z.string().optional(),
-});
-export const updateOutputConfig = {
-    name: "estimator_update_output_config",
-    description: "Configure what appears in an estimate's PDF output. Toggle visibility of: material costs, labor costs, unit prices, quantities, line item notes. Set custom header/footer text. Choose a template style. This controls the presentation layer — the underlying estimate data is not changed.",
-    inputSchemaZod: updateOutputConfigSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const { estimateId, ...body } = args;
-        const data = await client.patch(`/estimator/estimates/${estimateId}/output-config`, body);
-        return JSON.stringify(data);
-    },
-};