@kynver-app/mcp-estimator 0.2.15 → 0.2.17

package/dist/tools/takeoff-tools.js

@@ -1,297 +0,0 @@
-import { z } from "zod";
-import * as client from "../lib/kynver-client.js";
-const projectIdSchema = z.object({ projectId: z.string().uuid() });
-const createTakeoffProjectSchema = z.object({
-    projectName: z.string(),
-    buildingType: z.enum(["commercial", "residential"]),
-    siteAddress: z.string().optional(),
-    clientId: z.string().optional(),
-    companyId: z.string().optional(),
-});
-const listTakeoffProjectsSchema = z.object({});
-const remodelHintsSchema = z
-    .object({
-    cabinetLinearFt: z.number().nonnegative().optional(),
-    rooms: z
-        .array(z.object({
-        name: z.string(),
-        lengthFt: z.number().positive().optional(),
-        widthFt: z.number().positive().optional(),
-    }))
-        .optional(),
-    baths: z
-        .array(z.object({
-        type: z.enum(["full", "half", "three_quarter", "unknown"]).optional(),
-        count: z.number().int().positive().optional(),
-        label: z.string().optional(),
-    }))
-        .optional(),
-    flooringSqFt: z.number().nonnegative().optional(),
-    drywallSqFt: z.number().nonnegative().optional(),
-    paintSqFt: z.number().nonnegative().optional(),
-    roofSqFt: z.number().nonnegative().optional(),
-    flags: z
-        .object({
-        wallMovingRisk: z.boolean().optional(),
-        electricalSurpriseRisk: z.boolean().optional(),
-        plumbingSurpriseRisk: z.boolean().optional(),
-    })
-        .optional(),
-    notes: z.string().optional(),
-})
-    .optional();
-const uploadTakeoffInputSchema = z.object({
-    projectId: z.string().uuid(),
-    kind: z.string(),
-    fileName: z.string(),
-    base64: z.string(),
-    mimeType: z.string().optional(),
-    remodelHints: remodelHintsSchema,
-});
-const listTakeoffRowsSchema = z.object({
-    projectId: z.string().uuid(),
-    reviewState: z.string().optional(),
-});
-const reviewTakeoffRowSchema = z.object({
-    projectId: z.string().uuid(),
-    rowId: z.string().uuid(),
-    action: z.enum(["approve", "skip", "edit"]),
-    edits: z
-        .object({
-        description: z.string().optional(),
-        quantity: z.number().optional(),
-        unit: z.string().optional(),
-        serviceCode: z.string().nullable().optional(),
-    })
-        .optional(),
-});
-const commitTakeoffSchema = z.object({
-    projectId: z.string().uuid(),
-    overrideNote: z.string().optional(),
-});
-const listSystemPacksSchema = z.object({ segment: z.enum(["commercial", "residential"]).optional() });
-const applySystemPackSchema = z.object({
-    projectId: z.string().uuid(),
-    systemPackSlug: z.string(),
-    serviceProfileId: z.string().optional(),
-});
-const listServiceProfilesSchema = z.object({});
-const upsertServiceProfileSchema = z.object({
-    slug: z.string(),
-    name: z.string(),
-    segment: z.enum([
-        "commercial_service",
-        "commercial_production",
-        "residential_service",
-        "residential_production",
-    ]),
-    laborMultiplier: z.number().optional(),
-    defaultWastePercent: z.number().optional(),
-});
-const requestEstimateApprovalSchema = z.object({
-    estimateId: z.string().uuid(),
-    note: z.string().optional(),
-});
-const approveEstimateSchema = z.object({
-    estimateId: z.string().uuid(),
-    approvalId: z.string().uuid(),
-    action: z.enum(["approve", "reject"]),
-    note: z.string().optional(),
-});
-const getEstimateApprovalSchema = z.object({ estimateId: z.string().uuid() });
-export const createTakeoffProject = {
-    name: "estimator_create_takeoff_project",
-    description: "Create a takeoff project shell (commercial or residential). Upload inputs, run extract, review rows, commit, apply system pack, then generate estimate.",
-    inputSchemaZod: createTakeoffProjectSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post("/estimator/takeoffs", args);
-        return JSON.stringify(data);
-    },
-};
-export const getTakeoffProject = {
-    name: "estimator_get_takeoff_project",
-    description: "Get takeoff project with inputs, rows, status, pack/profile, linked estimate.",
-    inputSchemaZod: projectIdSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.get(`/estimator/takeoffs/${args.projectId}`);
-        return JSON.stringify(data);
-    },
-};
-export const listTakeoffProjects = {
-    name: "estimator_list_takeoff_projects",
-    description: "List takeoff projects for the workspace.",
-    inputSchemaZod: listTakeoffProjectsSchema,
-    execute: async (_args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.get("/estimator/takeoffs");
-        return JSON.stringify(data);
-    },
-};
-export const uploadTakeoffInput = {
-    name: "estimator_upload_takeoff_input",
-    description: "Upload a takeoff input file (base64) for a project. kind: eagleview_pdf|eagleview_xml|eagleview_json|eagleview_csv|spec_pdf|spreadsheet|photo|voice|other. For remodel photo/drawing takeoff, use kind=photo or spec_pdf and pass optional remodelHints (cabinet LF, room dims, bath counts, flooring/drywall/paint/roof sf, risk flags) — quantities are reviewable, not auto-measured from pixels.",
-    inputSchemaZod: uploadTakeoffInputSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post(`/estimator/takeoffs/${args.projectId}/inputs`, {
-            kind: args.kind,
-            fileName: args.fileName,
-            base64: args.base64,
-            ...(args.mimeType ? { mimeType: args.mimeType } : {}),
-            ...(args.remodelHints ? { remodelHints: args.remodelHints } : {}),
-        });
-        return JSON.stringify(data);
-    },
-};
-export const runTakeoffExtract = {
-    name: "estimator_run_takeoff_extract",
-    description: "Run takeoff extractors on all uploaded inputs (idempotent).",
-    inputSchemaZod: projectIdSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post(`/estimator/takeoffs/${args.projectId}/extract`, {});
-        return JSON.stringify(data);
-    },
-};
-export const listTakeoffRows = {
-    name: "estimator_list_takeoff_rows",
-    description: "List takeoff rows with evidence and review state.",
-    inputSchemaZod: listTakeoffRowsSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const qs = args.reviewState ? `?reviewState=${args.reviewState}` : "";
-        const data = await client.get(`/estimator/takeoffs/${args.projectId}/rows${qs}`);
-        return JSON.stringify(data);
-    },
-};
-export const reviewTakeoffRow = {
-    name: "estimator_review_takeoff_row",
-    description: "Approve, skip, or edit a single takeoff row.",
-    inputSchemaZod: reviewTakeoffRowSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const { projectId, rowId, ...body } = args;
-        const data = await client.patch(`/estimator/takeoffs/${projectId}/rows/${rowId}`, body);
-        return JSON.stringify(data);
-    },
-};
-export const commitTakeoff = {
-    name: "estimator_commit_takeoff",
-    description: "Mark takeoff ready after all rows reviewed and area measurement approved (or override note).",
-    inputSchemaZod: commitTakeoffSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post(`/estimator/takeoffs/${args.projectId}/commit`, {
-            overrideNote: args.overrideNote,
-        });
-        return JSON.stringify(data);
-    },
-};
-export const listSystemPacks = {
-    name: "estimator_list_system_packs",
-    description: "List built-in commercial and residential system packs.",
-    inputSchemaZod: listSystemPacksSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const qs = args.segment ? `?segment=${args.segment}` : "";
-        const data = await client.get(`/estimator/system-packs${qs}`);
-        return JSON.stringify(data);
-    },
-};
-export const applySystemPack = {
-    name: "estimator_apply_system_pack",
-    description: "Set system pack slug and optional service profile on takeoff project.",
-    inputSchemaZod: applySystemPackSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.patch(`/estimator/takeoffs/${args.projectId}`, {
-            systemPackSlug: args.systemPackSlug,
-            serviceProfileId: args.serviceProfileId ?? null,
-        });
-        return JSON.stringify(data);
-    },
-};
-export const listServiceProfiles = {
-    name: "estimator_list_service_profiles",
-    description: "List service department profiles (includes v6 defaults).",
-    inputSchemaZod: listServiceProfilesSchema,
-    execute: async (_args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.get("/estimator/service-profiles");
-        return JSON.stringify(data);
-    },
-};
-export const upsertServiceProfile = {
-    name: "estimator_upsert_service_profile",
-    description: "Create or update a service department profile.",
-    inputSchemaZod: upsertServiceProfileSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post("/estimator/service-profiles", args);
-        return JSON.stringify(data);
-    },
-};
-export const generateEstimateFromTakeoff = {
-    name: "estimator_generate_estimate_from_takeoff",
-    description: "Generate draft estimate from committed takeoff + system pack. Preflight fails if catalog codes missing.",
-    inputSchemaZod: projectIdSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post(`/estimator/takeoffs/${args.projectId}/generate-estimate`, {});
-        return JSON.stringify(data);
-    },
-};
-export const requestEstimateApproval = {
-    name: "estimator_request_estimate_approval",
-    description: "Request owner approval before customer send.",
-    inputSchemaZod: requestEstimateApprovalSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post(`/estimator/estimates/${args.estimateId}/approval`, {
-            note: args.note,
-        });
-        return JSON.stringify(data);
-    },
-};
-export const approveEstimate = {
-    name: "estimator_approve_estimate",
-    description: "Approve or reject estimate (workspace owner).",
-    inputSchemaZod: approveEstimateSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post(`/estimator/estimates/${args.estimateId}/approval`, {
-            approvalId: args.approvalId,
-            action: args.action,
-            note: args.note,
-        });
-        return JSON.stringify(data);
-    },
-};
-export const getEstimateApproval = {
-    name: "estimator_get_estimate_approval",
-    description: "Get latest approval status for an estimate.",
-    inputSchemaZod: getEstimateApprovalSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.get(`/estimator/estimates/${args.estimateId}/approval`);
-        return JSON.stringify(data);
-    },
-};

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

@@ -1,96 +0,0 @@
-import { z } from "zod";
-declare const saveTemplateSchema: z.ZodObject<{
-    estimateId: z.ZodString;
-    name: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    estimateId: string;
-}, {
-    name: string;
-    estimateId: string;
-}>;
-export declare const saveTemplate: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        estimateId: z.ZodString;
-        name: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        estimateId: string;
-    }, {
-        name: string;
-        estimateId: string;
-    }>;
-    execute: (args: z.infer<typeof saveTemplateSchema>) => Promise<string>;
-};
-declare const listTemplatesSchema: z.ZodObject<{
-    type: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    type?: string | undefined;
-}, {
-    type?: string | undefined;
-}>;
-export declare const listTemplates: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        type: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        type?: string | undefined;
-    }, {
-        type?: string | undefined;
-    }>;
-    execute: (args: z.infer<typeof listTemplatesSchema>) => Promise<string>;
-};
-declare const deleteTemplateSchema: z.ZodObject<{
-    id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-}, {
-    id: string;
-}>;
-export declare const deleteTemplate: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-    }, {
-        id: string;
-    }>;
-    execute: (args: z.infer<typeof deleteTemplateSchema>) => Promise<string>;
-};
-declare const createFromTemplateSchema: z.ZodObject<{
-    templateId: z.ZodString;
-    projectName: z.ZodString;
-    clientId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    templateId: string;
-    projectName: string;
-    clientId?: string | undefined;
-}, {
-    templateId: string;
-    projectName: string;
-    clientId?: string | undefined;
-}>;
-export declare const createFromTemplate: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        templateId: z.ZodString;
-        projectName: z.ZodString;
-        clientId: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        templateId: string;
-        projectName: string;
-        clientId?: string | undefined;
-    }, {
-        templateId: string;
-        projectName: string;
-        clientId?: string | undefined;
-    }>;
-    execute: (args: z.infer<typeof createFromTemplateSchema>) => Promise<string>;
-};
-export {};

package/dist/tools/template-tools.js

@@ -1,70 +0,0 @@
-import { z } from "zod";
-import * as client from "../lib/kynver-client.js";
-// --- estimator_save_template ---
-const saveTemplateSchema = z.object({
-    estimateId: z.string(),
-    name: z.string(),
-});
-export const saveTemplate = {
-    name: "estimator_save_template",
-    description: "Save an existing estimate as a reusable template. Templates capture the estimate's line items, quantities, and structure so you can quickly create similar estimates in the future. Requires the estimateId of the source estimate and a name for the template.",
-    inputSchemaZod: saveTemplateSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post("/estimator/templates", args);
-        return JSON.stringify(data);
-    },
-};
-// --- estimator_list_templates ---
-const listTemplatesSchema = z.object({
-    type: z.string().optional(),
-});
-export const listTemplates = {
-    name: "estimator_list_templates",
-    description: "List all saved estimate templates. Optionally filter by type: 'replacement' or 'repair_service'. Returns template names, types, and IDs. Use template IDs with estimator_create_from_template to create new estimates.",
-    inputSchemaZod: listTemplatesSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const params = new URLSearchParams();
-        if (args.type)
-            params.set("type", args.type);
-        const q = params.toString();
-        const path = q ? `/estimator/templates?${q}` : "/estimator/templates";
-        const data = await client.get(path);
-        return JSON.stringify(data);
-    },
-};
-// --- estimator_delete_template ---
-const deleteTemplateSchema = z.object({
-    id: z.string(),
-});
-export const deleteTemplate = {
-    name: "estimator_delete_template",
-    description: "Delete a saved estimate template permanently. This does not affect any estimates that were previously created from this template.",
-    inputSchemaZod: deleteTemplateSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.del(`/estimator/templates/${args.id}`);
-        return JSON.stringify(data);
-    },
-};
-// --- estimator_create_from_template ---
-const createFromTemplateSchema = z.object({
-    templateId: z.string(),
-    projectName: z.string(),
-    clientId: z.string().optional(),
-});
-export const createFromTemplate = {
-    name: "estimator_create_from_template",
-    description: "Create a new estimate from a saved template. The new estimate gets all the template's line items and structure. Requires: templateId (from estimator_list_templates), projectName. Optionally link to a clientId. The new estimate is created as a draft.",
-    inputSchemaZod: createFromTemplateSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post("/estimator/estimates", args);
-        return JSON.stringify(data);
-    },
-};

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

@@ -1,46 +0,0 @@
-import { z } from "zod";
-declare const listVersionsSchema: z.ZodObject<{
-    estimateId: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    estimateId: string;
-}, {
-    estimateId: string;
-}>;
-export declare const listVersions: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        estimateId: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        estimateId: string;
-    }, {
-        estimateId: string;
-    }>;
-    execute: (args: z.infer<typeof listVersionsSchema>) => Promise<string>;
-};
-declare const getVersionSchema: z.ZodObject<{
-    estimateId: z.ZodString;
-    versionId: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    estimateId: string;
-    versionId: string;
-}, {
-    estimateId: string;
-    versionId: string;
-}>;
-export declare const getVersion: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        estimateId: z.ZodString;
-        versionId: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        estimateId: string;
-        versionId: string;
-    }, {
-        estimateId: string;
-        versionId: string;
-    }>;
-    execute: (args: z.infer<typeof getVersionSchema>) => Promise<string>;
-};
-export {};

package/dist/tools/version-tools.js

@@ -1,33 +0,0 @@
-import { z } from "zod";
-import * as client from "../lib/kynver-client.js";
-// --- estimator_list_versions ---
-const listVersionsSchema = z.object({
-    estimateId: z.string(),
-});
-export const listVersions = {
-    name: "estimator_list_versions",
-    description: "List all saved version snapshots of an estimate. Versions are created automatically when significant changes are made. Shows version numbers and timestamps. Use this to track the history of changes to an estimate.",
-    inputSchemaZod: listVersionsSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.get(`/estimator/estimates/${args.estimateId}/versions`);
-        return JSON.stringify(data);
-    },
-};
-// --- estimator_get_version ---
-const getVersionSchema = z.object({
-    estimateId: z.string(),
-    versionId: z.string(),
-});
-export const getVersion = {
-    name: "estimator_get_version",
-    description: "Get a specific historical version of an estimate. Returns the full estimate snapshot as it existed at that point in time — all line items, totals, and metadata. Useful for comparing current vs previous versions or reverting changes.",
-    inputSchemaZod: getVersionSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.get(`/estimator/estimates/${args.estimateId}/versions/${args.versionId}`);
-        return JSON.stringify(data);
-    },
-};

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

@@ -1,52 +0,0 @@
-import { z } from "zod";
-declare const analyzePhotosSchema: z.ZodObject<{
-    images: z.ZodArray<z.ZodString, "many">;
-    prompt: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    images: string[];
-    prompt?: string | undefined;
-}, {
-    images: string[];
-    prompt?: string | undefined;
-}>;
-export declare const analyzePhotos: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        images: z.ZodArray<z.ZodString, "many">;
-        prompt: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        images: string[];
-        prompt?: string | undefined;
-    }, {
-        images: string[];
-        prompt?: string | undefined;
-    }>;
-    execute: (args: z.infer<typeof analyzePhotosSchema>) => Promise<string>;
-};
-declare const analyzeDocumentSchema: z.ZodObject<{
-    text: z.ZodString;
-    prompt: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    text: string;
-    prompt?: string | undefined;
-}, {
-    text: string;
-    prompt?: string | undefined;
-}>;
-export declare const analyzeDocument: {
-    name: string;
-    description: string;
-    inputSchemaZod: z.ZodObject<{
-        text: z.ZodString;
-        prompt: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        text: string;
-        prompt?: string | undefined;
-    }, {
-        text: string;
-        prompt?: string | undefined;
-    }>;
-    execute: (args: z.infer<typeof analyzeDocumentSchema>) => Promise<string>;
-};
-export {};

package/dist/tools/vision-tools.js

@@ -1,42 +0,0 @@
-import { z } from "zod";
-import * as client from "../lib/kynver-client.js";
-// --- estimator_analyze_photos ---
-const analyzePhotosSchema = z.object({
-    images: z.array(z.string()),
-    prompt: z.string().optional(),
-});
-export const analyzePhotos = {
-    name: "estimator_analyze_photos",
-    description: "Analyze roof photos using Claude's vision AI. Provide image URLs (can be multiple). The AI identifies: roofing materials, visible damage (missing shingles, cracks, moss, ponding), approximate measurements, and repair recommendations. Use the optional prompt parameter to ask specific questions about the photos. Results can inform estimate creation.",
-    inputSchemaZod: analyzePhotosSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post("/estimator/analyze", {
-            type: "photos",
-            images: args.images,
-            ...(args.prompt ? { prompt: args.prompt } : {}),
-        });
-        return JSON.stringify(data);
-    },
-};
-// --- estimator_analyze_document ---
-const analyzeDocumentSchema = z.object({
-    text: z.string(),
-    prompt: z.string().optional(),
-});
-export const analyzeDocument = {
-    name: "estimator_analyze_document",
-    description: "Analyze a text document (inspection report, insurance scope of work, contractor notes) and extract structured estimating data — identified services, quantities, materials, and damage descriptions. Pass the document text in the text field. Use the optional prompt parameter to focus the analysis. Results can be used to create estimates with accurate line items.",
-    inputSchemaZod: analyzeDocumentSchema,
-    execute: async (args) => {
-        if (!client.hasApiKey())
-            return client.noApiKeyMessage();
-        const data = await client.post("/estimator/analyze", {
-            type: "document",
-            text: args.text,
-            ...(args.prompt ? { prompt: args.prompt } : {}),
-        });
-        return JSON.stringify(data);
-    },
-};