@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/bill-vendor/billvendor-create.js

@@ -0,0 +1,72 @@
+/**
+ * BillVendor Create Tool
+ *
+ * Create a new vendor in FreshBooks.
+ */
+import { BillVendorCreateInputSchema, BillVendorSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for billvendor_create
+ */
+export const billvendorCreateTool = {
+    name: "billvendor_create",
+    description: `Create a new vendor in FreshBooks for bill tracking.
+
+WHEN TO USE:
+- User says "add a vendor", "create a supplier", "new vendor"
+- User needs to add a new vendor before creating bills
+- User mentions a new supplier they work with
+
+REQUIRED INFO:
+- accountId: FreshBooks account ID
+- vendorName: The vendor/supplier name
+
+OPTIONAL BUT HELPFUL:
+- contactName: Primary contact person
+- email: Vendor email address
+- phone: Vendor phone number
+- address, city, province, postalCode, country: Full address
+- currencyCode: Currency for transactions (defaults to USD)
+- accountNumber: Your account number with the vendor
+- taxNumber: Vendor's tax ID/VAT number
+- note: Additional notes about the vendor
+- is1099: Whether vendor is 1099 eligible (US tax purposes)
+
+EXAMPLE PROMPTS:
+- "Add a new vendor called Acme Supplies"
+- "Create vendor 'Office Depot' with email supplies@officedepot.com"
+- "Add supplier 'Tech Parts Inc' in Canada"
+
+RETURNS:
+Created vendor with ID and all details for future bill creation.`,
+    inputSchema: BillVendorCreateInputSchema,
+    outputSchema: BillVendorSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('billvendor_create', async (input, _context) => {
+            const { accountId, ...vendorData } = input;
+            logger.debug('Creating vendor', {
+                accountId,
+                vendorName: vendorData.vendorName,
+            });
+            const result = await client.executeWithRetry('billvendor_create', async (fbClient) => {
+                const response = await fbClient.billVendors.create(vendorData, accountId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { bill_vendor: { ... } }
+            const createdVendor = result.bill_vendor ?? result;
+            logger.info('Vendor created successfully', {
+                vendorId: createdVendor.id,
+            });
+            return createdVendor;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=billvendor-create.js.map

package/dist/tools/bill-vendor/billvendor-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-create.js","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;iEA4BkD;IAE/D,WAAW,EAAE,2BAA2B;IACxC,YAAY,EAAE,4BAA4B;IAE1C;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAkD,EAClD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,mBAAmB,EACnB,KAAK,EACH,KAAkD,EAClD,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,CAAC;YAE3C,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;gBAC9B,SAAS;gBACT,UAAU,EAAE,UAAU,CAAC,UAAU;aAClC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,mBAAmB,EACnB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,UAAiB,EAAE,SAAS,CAAC,CAAC;gBAEjF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CACF,CAAC;YAEF,+CAA+C;YAC/C,MAAM,aAAa,GAAI,MAAoC,CAAC,WAAW,IAAI,MAAM,CAAC;YAElF,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACzC,QAAQ,EAAG,aAAiC,CAAC,EAAE;aAChD,CAAC,CAAC;YAEH,OAAO,aAA6D,CAAC;QACvE,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/bill-vendor/billvendor-delete.d.ts

@@ -0,0 +1,40 @@
+/**
+ * BillVendor Delete Tool
+ *
+ * Delete a vendor from FreshBooks.
+ */
+import { z } from "zod";
+import { BillVendorDeleteInputSchema, BillVendorDeleteOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for billvendor_delete
+ */
+export declare const billvendorDeleteTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        vendorId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        vendorId: number;
+    }, {
+        accountId: string;
+        vendorId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        success: z.ZodBoolean;
+        vendorId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        vendorId: number;
+    }, {
+        success: boolean;
+        vendorId: number;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillVendorDeleteInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillVendorDeleteOutputSchema>>;
+};
+//# sourceMappingURL=billvendor-delete.d.ts.map

package/dist/tools/bill-vendor/billvendor-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-delete.d.ts","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAGzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;IA6B/B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,UAC1C,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;CAwCzD,CAAC"}

package/dist/tools/bill-vendor/billvendor-delete.js

@@ -0,0 +1,67 @@
+/**
+ * BillVendor Delete Tool
+ *
+ * Delete a vendor from FreshBooks.
+ */
+import { BillVendorDeleteInputSchema, BillVendorDeleteOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for billvendor_delete
+ */
+export const billvendorDeleteTool = {
+    name: "billvendor_delete",
+    description: `Delete a vendor from FreshBooks.
+
+WHEN TO USE:
+- User asks to "delete a vendor", "remove a supplier"
+- Vendor was created by mistake
+- Vendor is no longer used and should be removed
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- vendorId: The vendor ID to delete
+
+IMPORTANT:
+- Cannot delete vendors that have associated bills
+- Deletion is permanent and cannot be undone
+- Consider archiving instead if vendor has bill history
+
+EXAMPLE PROMPTS:
+- "Delete vendor 12345"
+- "Remove that supplier I just added"
+- "Delete the duplicate vendor"
+
+RETURNS:
+Confirmation of successful deletion with the vendor ID.`,
+    inputSchema: BillVendorDeleteInputSchema,
+    outputSchema: BillVendorDeleteOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('billvendor_delete', async (input, _context) => {
+            const { accountId, vendorId } = input;
+            logger.debug('Deleting vendor', {
+                accountId,
+                vendorId,
+            });
+            await client.executeWithRetry('billvendor_delete', async (fbClient) => {
+                const response = await fbClient.billVendors.delete(accountId, vendorId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            logger.info('Vendor deleted successfully', {
+                vendorId,
+            });
+            return {
+                success: true,
+                vendorId,
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=billvendor-delete.js.map

package/dist/tools/bill-vendor/billvendor-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-delete.js","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;wDAsByC;IAEtD,WAAW,EAAE,2BAA2B;IACxC,YAAY,EAAE,4BAA4B;IAE1C;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAkD,EAClD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,mBAAmB,EACnB,KAAK,EACH,KAAkD,EAClD,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;YAEtC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;gBAC9B,SAAS;gBACT,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,gBAAgB,CAC3B,mBAAmB,EACnB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAExE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CACF,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACzC,QAAQ;aACT,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ;aACT,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/bill-vendor/billvendor-list.d.ts

@@ -0,0 +1,179 @@
+/**
+ * BillVendor List Tool
+ *
+ * List vendors with pagination and optional filtering.
+ */
+import { z } from "zod";
+import { BillVendorListInputSchema, BillVendorListOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for billvendor_list
+ */
+export declare const billvendorListTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        perPage: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        vendorName: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        email?: string | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        vendorName?: string | undefined;
+    }, {
+        accountId: string;
+        email?: string | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        vendorName?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        vendors: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            vendorName: z.ZodString;
+            contactName: z.ZodNullable<z.ZodString>;
+            email: z.ZodNullable<z.ZodString>;
+            phone: z.ZodNullable<z.ZodString>;
+            website: z.ZodNullable<z.ZodString>;
+            address: z.ZodNullable<z.ZodString>;
+            city: z.ZodNullable<z.ZodString>;
+            province: z.ZodNullable<z.ZodString>;
+            postalCode: z.ZodNullable<z.ZodString>;
+            country: z.ZodNullable<z.ZodString>;
+            currencyCode: z.ZodString;
+            accountNumber: z.ZodNullable<z.ZodString>;
+            taxNumber: z.ZodNullable<z.ZodString>;
+            note: z.ZodNullable<z.ZodString>;
+            is1099: z.ZodOptional<z.ZodBoolean>;
+            language: z.ZodOptional<z.ZodString>;
+            visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            email: string | null;
+            createdAt: string;
+            id: number;
+            note: string | null;
+            updatedAt: string;
+            currencyCode: string;
+            address: string | null;
+            city: string | null;
+            province: string | null;
+            country: string | null;
+            vendorName: string;
+            contactName: string | null;
+            phone: string | null;
+            website: string | null;
+            postalCode: string | null;
+            accountNumber: string | null;
+            taxNumber: string | null;
+            visState?: 0 | 1 | 2 | undefined;
+            language?: string | undefined;
+            is1099?: boolean | undefined;
+        }, {
+            email: string | null;
+            createdAt: string;
+            id: number;
+            note: string | null;
+            updatedAt: string;
+            currencyCode: string;
+            address: string | null;
+            city: string | null;
+            province: string | null;
+            country: string | null;
+            vendorName: string;
+            contactName: string | null;
+            phone: string | null;
+            website: string | null;
+            postalCode: string | null;
+            accountNumber: string | null;
+            taxNumber: string | null;
+            visState?: 0 | 1 | 2 | undefined;
+            language?: string | undefined;
+            is1099?: boolean | undefined;
+        }>, "many">;
+        pagination: z.ZodObject<{
+            page: z.ZodNumber;
+            pages: z.ZodNumber;
+            perPage: z.ZodNumber;
+            total: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        }, {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+        vendors: {
+            email: string | null;
+            createdAt: string;
+            id: number;
+            note: string | null;
+            updatedAt: string;
+            currencyCode: string;
+            address: string | null;
+            city: string | null;
+            province: string | null;
+            country: string | null;
+            vendorName: string;
+            contactName: string | null;
+            phone: string | null;
+            website: string | null;
+            postalCode: string | null;
+            accountNumber: string | null;
+            taxNumber: string | null;
+            visState?: 0 | 1 | 2 | undefined;
+            language?: string | undefined;
+            is1099?: boolean | undefined;
+        }[];
+    }, {
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+        vendors: {
+            email: string | null;
+            createdAt: string;
+            id: number;
+            note: string | null;
+            updatedAt: string;
+            currencyCode: string;
+            address: string | null;
+            city: string | null;
+            province: string | null;
+            country: string | null;
+            vendorName: string;
+            contactName: string | null;
+            phone: string | null;
+            website: string | null;
+            postalCode: string | null;
+            accountNumber: string | null;
+            taxNumber: string | null;
+            visState?: 0 | 1 | 2 | undefined;
+            language?: string | undefined;
+            is1099?: boolean | undefined;
+        }[];
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillVendorListInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillVendorListOutputSchema>>;
+};
+//# sourceMappingURL=billvendor-list.d.ts.map

package/dist/tools/bill-vendor/billvendor-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-list.d.ts","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAGrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+B7B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,UACxC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;CAuFvD,CAAC"}

package/dist/tools/bill-vendor/billvendor-list.js

@@ -0,0 +1,109 @@
+/**
+ * BillVendor List Tool
+ *
+ * List vendors with pagination and optional filtering.
+ */
+import { BillVendorListInputSchema, BillVendorListOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for billvendor_list
+ */
+export const billvendorListTool = {
+    name: "billvendor_list",
+    description: `List vendors from FreshBooks with optional filtering and pagination.
+
+WHEN TO USE:
+- User asks to "see vendors", "list suppliers", "show all vendors"
+- User wants to find a vendor by name
+- User needs vendor information for creating bills
+
+FILTERING OPTIONS:
+- vendorName: Search by vendor name (partial match)
+- email: Filter by vendor email
+
+PAGINATION:
+- Use page/perPage for large result sets
+- Default: 30 results per page
+- Maximum: 100 results per page
+
+EXAMPLE PROMPTS:
+- "Show me all vendors"
+- "List suppliers in the system"
+- "Find vendor named 'Acme'"
+- "Show vendors with email containing 'supplier.com'"
+
+RETURNS:
+Array of vendors with contact info, addresses, and tax details.
+Includes pagination metadata for navigating large result sets.`,
+    inputSchema: BillVendorListInputSchema,
+    outputSchema: BillVendorListOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('billvendor_list', async (input, _context) => {
+            const { accountId, page, perPage, ...filters } = input;
+            logger.debug('Listing vendors', {
+                accountId,
+                page,
+                perPage,
+                filters,
+            });
+            const result = await client.executeWithRetry('billvendor_list', async (fbClient) => {
+                // Dynamic import of query builders
+                const { PaginationQueryBuilder, SearchQueryBuilder } = await import('@freshbooks/api/dist/models/builders/index.js');
+                // Build query builders array
+                const queryBuilders = [];
+                // Add pagination if specified
+                if (page !== undefined || perPage !== undefined) {
+                    const pagination = new PaginationQueryBuilder();
+                    if (page !== undefined)
+                        pagination.page(page);
+                    if (perPage !== undefined)
+                        pagination.perPage(perPage);
+                    queryBuilders.push(pagination);
+                }
+                // Add search filters if any specified
+                if (Object.keys(filters).length > 0) {
+                    const search = new SearchQueryBuilder();
+                    if (filters.vendorName !== undefined) {
+                        search.like("vendor_name", filters.vendorName);
+                    }
+                    if (filters.email !== undefined) {
+                        search.equals("email", filters.email);
+                    }
+                    queryBuilders.push(search);
+                }
+                const response = await fbClient.billVendors.list(accountId, queryBuilders);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract data - FreshBooks returns: { bill_vendors: [...], pages: {...} }
+            const vendors = result.bill_vendors || [];
+            const paginationData = result.pages || {
+                page: 1,
+                pages: 1,
+                total: vendors.length,
+                per_page: 30,
+            };
+            logger.info('Vendors listed successfully', {
+                count: vendors.length,
+                total: paginationData.total,
+            });
+            return {
+                vendors,
+                pagination: {
+                    page: paginationData.page,
+                    pages: paginationData.pages,
+                    perPage: paginationData.per_page || paginationData.perPage || 30,
+                    total: paginationData.total,
+                },
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=billvendor-list.js.map

package/dist/tools/bill-vendor/billvendor-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-list.js","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-list.ts"],"names":[],"mappings":"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"}

package/dist/tools/bill-vendor/billvendor-single.d.ts

@@ -0,0 +1,94 @@
+/**
+ * BillVendor Single Tool
+ *
+ * Retrieve a single vendor by ID.
+ */
+import { z } from "zod";
+import { BillVendorSingleInputSchema, BillVendorSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for billvendor_single
+ */
+export declare const billvendorSingleTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        vendorId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        vendorId: number;
+    }, {
+        accountId: string;
+        vendorId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        vendorName: z.ZodString;
+        contactName: z.ZodNullable<z.ZodString>;
+        email: z.ZodNullable<z.ZodString>;
+        phone: z.ZodNullable<z.ZodString>;
+        website: z.ZodNullable<z.ZodString>;
+        address: z.ZodNullable<z.ZodString>;
+        city: z.ZodNullable<z.ZodString>;
+        province: z.ZodNullable<z.ZodString>;
+        postalCode: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        currencyCode: z.ZodString;
+        accountNumber: z.ZodNullable<z.ZodString>;
+        taxNumber: z.ZodNullable<z.ZodString>;
+        note: z.ZodNullable<z.ZodString>;
+        is1099: z.ZodOptional<z.ZodBoolean>;
+        language: z.ZodOptional<z.ZodString>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        email: string | null;
+        createdAt: string;
+        id: number;
+        note: string | null;
+        updatedAt: string;
+        currencyCode: string;
+        address: string | null;
+        city: string | null;
+        province: string | null;
+        country: string | null;
+        vendorName: string;
+        contactName: string | null;
+        phone: string | null;
+        website: string | null;
+        postalCode: string | null;
+        accountNumber: string | null;
+        taxNumber: string | null;
+        visState?: 0 | 1 | 2 | undefined;
+        language?: string | undefined;
+        is1099?: boolean | undefined;
+    }, {
+        email: string | null;
+        createdAt: string;
+        id: number;
+        note: string | null;
+        updatedAt: string;
+        currencyCode: string;
+        address: string | null;
+        city: string | null;
+        province: string | null;
+        country: string | null;
+        vendorName: string;
+        contactName: string | null;
+        phone: string | null;
+        website: string | null;
+        postalCode: string | null;
+        accountNumber: string | null;
+        taxNumber: string | null;
+        visState?: 0 | 1 | 2 | undefined;
+        language?: string | undefined;
+        is1099?: boolean | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillVendorSingleInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillVendorSingleOutputSchema>>;
+};
+//# sourceMappingURL=billvendor-single.d.ts.map

package/dist/tools/bill-vendor/billvendor-single.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-single.d.ts","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAGzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyB/B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,UAC1C,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;CAwCzD,CAAC"}

package/dist/tools/bill-vendor/billvendor-single.js

@@ -0,0 +1,62 @@
+/**
+ * BillVendor Single Tool
+ *
+ * Retrieve a single vendor by ID.
+ */
+import { BillVendorSingleInputSchema, BillVendorSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for billvendor_single
+ */
+export const billvendorSingleTool = {
+    name: "billvendor_single",
+    description: `Retrieve a single vendor by ID from FreshBooks.
+
+WHEN TO USE:
+- User asks for details about a specific vendor
+- User references a vendor ID or name
+- User wants to see full vendor information before creating a bill
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- vendorId: The specific vendor ID to retrieve
+
+EXAMPLE PROMPTS:
+- "Show me vendor 12345"
+- "Get details for that supplier"
+- "What's the contact info for vendor #V-001?"
+
+RETURNS:
+Complete vendor details including name, contact info, address, tax information,
+and any notes.`,
+    inputSchema: BillVendorSingleInputSchema,
+    outputSchema: BillVendorSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('billvendor_single', async (input, _context) => {
+            const { accountId, vendorId } = input;
+            logger.debug('Retrieving vendor', {
+                accountId,
+                vendorId,
+            });
+            const result = await client.executeWithRetry('billvendor_single', async (fbClient) => {
+                const response = await fbClient.billVendors.single(accountId, vendorId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { bill_vendor: { ... } }
+            const vendor = result.bill_vendor ?? result;
+            logger.info('Vendor retrieved successfully', {
+                vendorId,
+            });
+            return vendor;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=billvendor-single.js.map

package/dist/tools/bill-vendor/billvendor-single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-single.js","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;eAkBA;IAEb,WAAW,EAAE,2BAA2B;IACxC,YAAY,EAAE,4BAA4B;IAE1C;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAkD,EAClD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,mBAAmB,EACnB,KAAK,EACH,KAAkD,EAClD,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;YAEtC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE;gBAChC,SAAS;gBACT,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,mBAAmB,EACnB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAExE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CACF,CAAC;YAEF,+CAA+C;YAC/C,MAAM,MAAM,GAAI,MAAoC,CAAC,WAAW,IAAI,MAAM,CAAC;YAE3E,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE;gBAC3C,QAAQ;aACT,CAAC,CAAC;YAEH,OAAO,MAAsD,CAAC;QAChE,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}