@kynver-app/mcp-estimator 0.2.12 → 0.2.14

package/dist/server.js

@@ -18,6 +18,7 @@ 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 * as signingTools from "./tools/signing-tools.js";
 import { readOwnPackageVersion } from "./lib/package-version.js";
 const PACKAGE_VERSION = readOwnPackageVersion(import.meta.url);
 function toolResult(text) {
@@ -110,5 +111,9 @@ export function createEstimatorServer() {
     register(takeoffTools.getEstimateApproval.name, { description: takeoffTools.getEstimateApproval.description, inputSchema: takeoffTools.getEstimateApproval.inputSchemaZod }, (args) => takeoffTools.getEstimateApproval.execute(args));
     // --- Intake tools (1) ---
     register(intakeTools.normalizeRemodelIntake.name, { description: intakeTools.normalizeRemodelIntake.description, inputSchema: intakeTools.normalizeRemodelIntake.inputSchemaZod }, (args) => intakeTools.normalizeRemodelIntake.execute(args));
+    // --- Signing tools (3) ---
+    register(signingTools.createSigningRequest.name, { description: signingTools.createSigningRequest.description, inputSchema: signingTools.createSigningRequest.inputSchemaZod }, (args) => signingTools.createSigningRequest.execute(args));
+    register(signingTools.getSigningRequests.name, { description: signingTools.getSigningRequests.description, inputSchema: signingTools.getSigningRequests.inputSchemaZod }, (args) => signingTools.getSigningRequests.execute(args));
+    register(signingTools.cancelSigningRequest.name, { description: signingTools.cancelSigningRequest.description, inputSchema: signingTools.cancelSigningRequest.inputSchemaZod }, (args) => signingTools.cancelSigningRequest.execute(args));
     return server;
 }

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

@@ -301,7 +301,6 @@ declare const updateConfigSchema: z.ZodObject<{
     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;
@@ -312,7 +311,6 @@ declare const updateConfigSchema: z.ZodObject<{
     companyAddress?: string | undefined;
     companyLogo?: string | undefined;
     licenseNumber?: string | undefined;
-    defaultNotes?: string | undefined;
     defaultTerms?: string | undefined;
 }, {
     defaultMarkup?: number | undefined;
@@ -323,7 +321,6 @@ declare const updateConfigSchema: z.ZodObject<{
     companyAddress?: string | undefined;
     companyLogo?: string | undefined;
     licenseNumber?: string | undefined;
-    defaultNotes?: string | undefined;
     defaultTerms?: string | undefined;
 }>;
 export declare const updateConfig: {
@@ -338,7 +335,6 @@ export declare const updateConfig: {
         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;
@@ -349,7 +345,6 @@ export declare const updateConfig: {
         companyAddress?: string | undefined;
         companyLogo?: string | undefined;
         licenseNumber?: string | undefined;
-        defaultNotes?: string | undefined;
         defaultTerms?: string | undefined;
     }, {
         defaultMarkup?: number | undefined;
@@ -360,7 +355,6 @@ export declare const updateConfig: {
         companyAddress?: string | undefined;
         companyLogo?: string | undefined;
         licenseNumber?: string | undefined;
-        defaultNotes?: string | undefined;
         defaultTerms?: string | undefined;
     }>;
     execute: (args: z.infer<typeof updateConfigSchema>) => Promise<string>;

package/dist/tools/catalog-tools.js

@@ -156,12 +156,11 @@ const updateConfigSchema = z.object({
     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).",
+    description: "Update the user's estimator settings. You can set: companyName, defaultMarkup (waste %), taxRate, companyPhone, companyEmail, companyAddress, companyLogo (URL), licenseNumber (contractor CCB/license number), and defaultTerms (terms & conditions appended to estimates).",
     inputSchemaZod: updateConfigSchema,
     execute: async (args) => {
         if (!client.hasApiKey())

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

@@ -0,0 +1,89 @@
+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

@@ -0,0 +1,51 @@
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/mcp-estimator",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "files": [
     "dist",
     "!dist/**/__tests__/**",