@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/bill/bill-archive.js

@@ -0,0 +1,68 @@
+/**
+ * Bill Archive Tool
+ *
+ * Archive a bill in FreshBooks (soft delete).
+ */
+import { BillArchiveInputSchema, BillArchiveOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for bill_archive
+ */
+export const billArchiveTool = {
+    name: "bill_archive",
+    description: `Archive a bill in FreshBooks (soft delete, preserves records).
+
+WHEN TO USE:
+- User wants to hide a bill without deleting it permanently
+- Bill is paid and should be removed from active lists
+- User wants to clean up bill list while preserving history
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- billId: The bill ID to archive
+
+BENEFITS OVER DELETE:
+- Archived bills can be restored if needed
+- Preserves historical records and audit trail
+- Safer option for bills with payment history
+
+EXAMPLE PROMPTS:
+- "Archive bill 12345"
+- "Hide that paid bill from my list"
+- "Archive the old vendor bills"
+
+RETURNS:
+Confirmation of successful archiving with the bill ID.`,
+    inputSchema: BillArchiveInputSchema,
+    outputSchema: BillArchiveOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('bill_archive', async (input, _context) => {
+            const { accountId, billId } = input;
+            logger.debug('Archiving bill', {
+                accountId,
+                billId,
+            });
+            await client.executeWithRetry('bill_archive', async (fbClient) => {
+                // Archive is implemented as an update to set visState to archived (2)
+                const response = await fbClient.bills.archive(accountId, billId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            logger.info('Bill archived successfully', {
+                billId,
+            });
+            return {
+                success: true,
+                billId,
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=bill-archive.js.map

package/dist/tools/bill/bill-archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-archive.js","sourceRoot":"","sources":["../../../src/tools/bill/bill-archive.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;uDAsBwC;IAErD,WAAW,EAAE,sBAAsB;IACnC,YAAY,EAAE,uBAAuB;IAErC;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAA6C,EAC7C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,cAAc,EACd,KAAK,EACH,KAA6C,EAC7C,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YAEpC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE;gBAC7B,SAAS;gBACT,MAAM;aACP,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,gBAAgB,CAC3B,cAAc,EACd,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,sEAAsE;gBACtE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAEjE,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,4BAA4B,EAAE;gBACxC,MAAM;aACP,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM;aACP,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/bill-create.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Bill Create Tool
+ *
+ * Create a new bill in FreshBooks.
+ */
+import { z } from "zod";
+import { BillCreateInputSchema, BillSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for bill_create
+ */
+export declare const billCreateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        vendorId: z.ZodNumber;
+        issueDate: z.ZodString;
+        dueDate: z.ZodOptional<z.ZodString>;
+        billNumber: z.ZodOptional<z.ZodString>;
+        amount: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        lines: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+        notes: z.ZodOptional<z.ZodString>;
+        attachment: z.ZodOptional<z.ZodAny>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        vendorId: number;
+        issueDate: string;
+        dueDate?: string | undefined;
+        lines?: any[] | undefined;
+        notes?: string | undefined;
+        billNumber?: string | undefined;
+        attachment?: any;
+    }, {
+        accountId: string;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        vendorId: number;
+        issueDate: string;
+        dueDate?: string | undefined;
+        lines?: any[] | undefined;
+        notes?: string | undefined;
+        billNumber?: string | undefined;
+        attachment?: any;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        billNumber: z.ZodNullable<z.ZodString>;
+        vendorId: z.ZodNumber;
+        amount: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        outstandingAmount: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        paidAmount: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        dueDate: z.ZodNullable<z.ZodString>;
+        issueDate: z.ZodString;
+        status: z.ZodEnum<["unpaid", "partial", "paid", "overdue"]>;
+        lines: z.ZodArray<z.ZodAny, "many">;
+        notes: z.ZodNullable<z.ZodString>;
+        attachment: z.ZodNullable<z.ZodAny>;
+        taxAmount: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "partial" | "paid" | "overdue" | "unpaid";
+        createdAt: string;
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        dueDate: string | null;
+        updatedAt: string;
+        lines: any[];
+        notes: string | null;
+        billNumber: string | null;
+        vendorId: number;
+        outstandingAmount: {
+            code: string;
+            amount: string;
+        } | null;
+        paidAmount: {
+            code: string;
+            amount: string;
+        } | null;
+        issueDate: string;
+        taxAmount: {
+            code: string;
+            amount: string;
+        } | null;
+        visState?: 0 | 1 | 2 | undefined;
+        attachment?: any;
+    }, {
+        status: "partial" | "paid" | "overdue" | "unpaid";
+        createdAt: string;
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        dueDate: string | null;
+        updatedAt: string;
+        lines: any[];
+        notes: string | null;
+        billNumber: string | null;
+        vendorId: number;
+        outstandingAmount: {
+            code: string;
+            amount: string;
+        } | null;
+        paidAmount: {
+            code: string;
+            amount: string;
+        } | null;
+        issueDate: string;
+        taxAmount: {
+            code: string;
+            amount: string;
+        } | null;
+        visState?: 0 | 1 | 2 | undefined;
+        attachment?: any;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillCreateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillSingleOutputSchema>>;
+};
+//# sourceMappingURL=bill-create.d.ts.map

package/dist/tools/bill/bill-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-create.d.ts","sourceRoot":"","sources":["../../../src/tools/bill/bill-create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiCzB;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,UACpC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;CAwCnD,CAAC"}

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

@@ -0,0 +1,70 @@
+/**
+ * Bill Create Tool
+ *
+ * Create a new bill in FreshBooks.
+ */
+import { BillCreateInputSchema, BillSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for bill_create
+ */
+export const billCreateTool = {
+    name: "bill_create",
+    description: `Create a new bill in FreshBooks for vendor payments.
+
+WHEN TO USE:
+- User says "create a bill", "add a vendor bill", "record a bill"
+- User mentions receiving an invoice from a vendor
+- User needs to track a vendor payment
+
+REQUIRED INFO:
+- accountId: FreshBooks account ID
+- vendorId: The vendor this bill is from
+- issueDate: When the bill was issued (ISO 8601 format)
+- amount: Bill amount with currency code
+
+OPTIONAL BUT HELPFUL:
+- dueDate: When payment is due
+- billNumber: Vendor's bill/invoice number
+- lines: Itemized line items
+- notes: Additional notes or descriptions
+- attachment: Scanned bill or PDF
+
+EXAMPLE PROMPTS:
+- "Create a bill for vendor 123 for $500"
+- "Record a new bill from my supplier dated today"
+- "Add vendor bill #INV-2024-001 for $1,250"
+
+RETURNS:
+Created bill with ID, status, and all details for tracking and payment.`,
+    inputSchema: BillCreateInputSchema,
+    outputSchema: BillSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('bill_create', async (input, _context) => {
+            const { accountId, ...billData } = input;
+            logger.debug('Creating bill', {
+                accountId,
+                vendorId: billData.vendorId,
+            });
+            const result = await client.executeWithRetry('bill_create', async (fbClient) => {
+                const response = await fbClient.bills.create(billData, accountId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { bill: { ... } }
+            const createdBill = result.bill ?? result;
+            logger.info('Bill created successfully', {
+                billId: createdBill.id,
+            });
+            return createdBill;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=bill-create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bill-create.js","sourceRoot":"","sources":["../../../src/tools/bill/bill-create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;wEA0ByD;IAEtE,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,sBAAsB;IAEpC;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAA4C,EAC5C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,aAAa,EACb,KAAK,EACH,KAA4C,EAC5C,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC;YAEzC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE;gBAC5B,SAAS;gBACT,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,aAAa,EACb,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,QAAe,EAAE,SAAS,CAAC,CAAC;gBAEzE,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,wCAAwC;YACxC,MAAM,WAAW,GAAI,MAA6B,CAAC,IAAI,IAAI,MAAM,CAAC;YAElE,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;gBACvC,MAAM,EAAG,WAA+B,CAAC,EAAE;aAC5C,CAAC,CAAC;YAEH,OAAO,WAAqD,CAAC;QAC/D,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/bill-delete.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"bill-delete.d.ts","sourceRoot":"","sources":["../../../src/tools/bill/bill-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;IA6BzB;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,UACpC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;CAwCnD,CAAC"}

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

@@ -0,0 +1,67 @@
+/**
+ * Bill Delete Tool
+ *
+ * Delete a bill from FreshBooks.
+ */
+import { BillDeleteInputSchema, BillDeleteOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for bill_delete
+ */
+export const billDeleteTool = {
+    name: "bill_delete",
+    description: `Delete a bill from FreshBooks.
+
+WHEN TO USE:
+- User asks to "delete a bill", "remove a bill"
+- User entered a bill by mistake
+- Bill is no longer needed and should be removed
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- billId: The bill ID to delete
+
+IMPORTANT:
+- Deletion is permanent and cannot be undone
+- Consider using bill_archive instead to preserve records
+- Cannot delete bills that have payments against them
+
+EXAMPLE PROMPTS:
+- "Delete bill 12345"
+- "Remove that bill I just created"
+- "Delete the incorrect vendor bill"
+
+RETURNS:
+Confirmation of successful deletion with the bill ID.`,
+    inputSchema: BillDeleteInputSchema,
+    outputSchema: BillDeleteOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('bill_delete', async (input, _context) => {
+            const { accountId, billId } = input;
+            logger.debug('Deleting bill', {
+                accountId,
+                billId,
+            });
+            await client.executeWithRetry('bill_delete', async (fbClient) => {
+                const response = await fbClient.bills.delete(accountId, billId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            logger.info('Bill deleted successfully', {
+                billId,
+            });
+            return {
+                success: true,
+                billId,
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=bill-delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bill-delete.js","sourceRoot":"","sources":["../../../src/tools/bill/bill-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;sDAsBuC;IAEpD,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,sBAAsB;IAEpC;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAA4C,EAC5C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,aAAa,EACb,KAAK,EACH,KAA4C,EAC5C,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YAEpC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE;gBAC5B,SAAS;gBACT,MAAM;aACP,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,gBAAgB,CAC3B,aAAa,EACb,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAEhE,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,2BAA2B,EAAE;gBACvC,MAAM;aACP,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM;aACP,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/bill-list.d.ts

@@ -0,0 +1,249 @@
+/**
+ * Bill List Tool
+ *
+ * List bills with pagination and optional filtering.
+ */
+import { z } from "zod";
+import { BillListInputSchema, BillListOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for bill_list
+ */
+export declare const billListTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        perPage: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        vendorId: z.ZodOptional<z.ZodNumber>;
+        status: z.ZodOptional<z.ZodEnum<["unpaid", "partial", "paid", "overdue"]>>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        status?: "partial" | "paid" | "overdue" | "unpaid" | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        vendorId?: number | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    }, {
+        accountId: string;
+        status?: "partial" | "paid" | "overdue" | "unpaid" | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        vendorId?: number | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        bills: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            billNumber: z.ZodNullable<z.ZodString>;
+            vendorId: z.ZodNumber;
+            amount: z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>;
+            outstandingAmount: z.ZodNullable<z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>>;
+            paidAmount: z.ZodNullable<z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>>;
+            dueDate: z.ZodNullable<z.ZodString>;
+            issueDate: z.ZodString;
+            status: z.ZodEnum<["unpaid", "partial", "paid", "overdue"]>;
+            lines: z.ZodArray<z.ZodAny, "many">;
+            notes: z.ZodNullable<z.ZodString>;
+            attachment: z.ZodNullable<z.ZodAny>;
+            taxAmount: z.ZodNullable<z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        }, "strip", z.ZodTypeAny, {
+            status: "partial" | "paid" | "overdue" | "unpaid";
+            createdAt: string;
+            id: number;
+            amount: {
+                code: string;
+                amount: string;
+            };
+            dueDate: string | null;
+            updatedAt: string;
+            lines: any[];
+            notes: string | null;
+            billNumber: string | null;
+            vendorId: number;
+            outstandingAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            paidAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            issueDate: string;
+            taxAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            visState?: 0 | 1 | 2 | undefined;
+            attachment?: any;
+        }, {
+            status: "partial" | "paid" | "overdue" | "unpaid";
+            createdAt: string;
+            id: number;
+            amount: {
+                code: string;
+                amount: string;
+            };
+            dueDate: string | null;
+            updatedAt: string;
+            lines: any[];
+            notes: string | null;
+            billNumber: string | null;
+            vendorId: number;
+            outstandingAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            paidAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            issueDate: string;
+            taxAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            visState?: 0 | 1 | 2 | undefined;
+            attachment?: any;
+        }>, "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;
+        };
+        bills: {
+            status: "partial" | "paid" | "overdue" | "unpaid";
+            createdAt: string;
+            id: number;
+            amount: {
+                code: string;
+                amount: string;
+            };
+            dueDate: string | null;
+            updatedAt: string;
+            lines: any[];
+            notes: string | null;
+            billNumber: string | null;
+            vendorId: number;
+            outstandingAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            paidAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            issueDate: string;
+            taxAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            visState?: 0 | 1 | 2 | undefined;
+            attachment?: any;
+        }[];
+    }, {
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+        bills: {
+            status: "partial" | "paid" | "overdue" | "unpaid";
+            createdAt: string;
+            id: number;
+            amount: {
+                code: string;
+                amount: string;
+            };
+            dueDate: string | null;
+            updatedAt: string;
+            lines: any[];
+            notes: string | null;
+            billNumber: string | null;
+            vendorId: number;
+            outstandingAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            paidAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            issueDate: string;
+            taxAmount: {
+                code: string;
+                amount: string;
+            } | null;
+            visState?: 0 | 1 | 2 | undefined;
+            attachment?: any;
+        }[];
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillListInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillListOutputSchema>>;
+};
+//# sourceMappingURL=bill-list.d.ts.map