@goodsamsoftware/freshbooks-mcp 1.0.0

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

@@ -0,0 +1,73 @@
+/**
+ * Callback Create Tool
+ *
+ * Register a new webhook/callback for event notifications.
+ */
+import { CallbackCreateInputSchema, CallbackSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for callback_create
+ */
+export const callbackCreateTool = {
+    name: "callback_create",
+    description: `Register a new webhook/callback in FreshBooks.
+
+WHEN TO USE:
+- User wants to receive notifications for FreshBooks events
+- User says "create a webhook", "set up event notification", "register callback"
+- User wants to be notified when invoices are created, payments received, etc.
+
+REQUIRED INFO:
+- Event type (e.g., "invoice.create", "payment.create", "time_entry.create")
+- Webhook endpoint URL (must be HTTPS and publicly accessible)
+- Account ID
+
+COMMON EVENT TYPES:
+- invoice.create, invoice.update, invoice.delete
+- payment.create, payment.update, payment.delete
+- time_entry.create, time_entry.update, time_entry.delete
+- client.create, client.update
+- project.create, project.update
+
+IMPORTANT NOTES:
+- Webhook URL must be HTTPS
+- FreshBooks will send a verification request to your URL
+- You must call callback_verify with the verification code to activate
+- Until verified, no events will be sent
+
+EXAMPLE PROMPTS:
+- "Create a webhook for new invoices at https://myapp.com/webhooks"
+- "Register callback for payment notifications"
+- "Set up webhook to track time entry changes"
+
+RETURNS:
+Created webhook with verification status (unverified initially).
+Use callback_verify to complete activation.`,
+    inputSchema: CallbackCreateInputSchema,
+    outputSchema: CallbackSingleOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('callback_create', async (input, _context) => {
+            const { accountId, event, uri } = input;
+            // Validate HTTPS
+            if (!uri.startsWith('https://')) {
+                throw ErrorHandler.createValidationError('Webhook URI must use HTTPS protocol for security', { tool: 'callback_create', accountId });
+            }
+            // Prepare callback data
+            const callbackData = {
+                event,
+                uri,
+            };
+            const result = await client.executeWithRetry('callback_create', async (fbClient) => {
+                const response = await fbClient.callbacks.create(callbackData, accountId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract callback data
+            return result.callback;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=callback-create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback-create.js","sourceRoot":"","sources":["../../../src/tools/callback/callback-create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAgC6B;IAE1C,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,0BAA0B;IAExC,KAAK,CAAC,OAAO,CACX,KAAgD,EAChD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,iBAAiB,EACjB,KAAK,EAAE,KAAgD,EAAE,QAAqB,EAAE,EAAE;YAChF,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;YAExC,iBAAiB;YACjB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChC,MAAM,YAAY,CAAC,qBAAqB,CACtC,kDAAkD,EAClD,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,CACvC,CAAC;YACJ,CAAC;YAED,wBAAwB;YACxB,MAAM,YAAY,GAAG;gBACnB,KAAK;gBACL,GAAG;aACJ,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,YAAmB,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,CAAC,CAAC;YAEH,wBAAwB;YACxB,OAAQ,MAAc,CAAC,QAAQ,CAAC;QAClC,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/callback/callback-delete.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Callback Delete Tool
+ *
+ * Delete/unregister a webhook/callback.
+ */
+import { z } from "zod";
+import { CallbackDeleteInputSchema, CallbackDeleteOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for callback_delete
+ */
+export declare const callbackDeleteTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        callbackId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        callbackId: number;
+    }, {
+        accountId: string;
+        callbackId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        success: z.ZodBoolean;
+        callbackId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        callbackId: number;
+    }, {
+        success: boolean;
+        callbackId: number;
+    }>;
+    execute(input: z.infer<typeof CallbackDeleteInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof CallbackDeleteOutputSchema>>;
+};
+//# sourceMappingURL=callback-delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback-delete.d.ts","sourceRoot":"","sources":["../../../src/tools/callback/callback-delete.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;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;mBA+BpB,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,UACxC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;CAyBvD,CAAC"}

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

@@ -0,0 +1,57 @@
+/**
+ * Callback Delete Tool
+ *
+ * Delete/unregister a webhook/callback.
+ */
+import { CallbackDeleteInputSchema, CallbackDeleteOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for callback_delete
+ */
+export const callbackDeleteTool = {
+    name: "callback_delete",
+    description: `Delete/unregister a webhook/callback from FreshBooks.
+
+WHEN TO USE:
+- User wants to stop receiving webhook notifications
+- User says "delete webhook", "remove callback", "unregister webhook"
+- User needs to clean up unused webhook subscriptions
+
+REQUIRED INFO:
+- Callback ID to delete
+- Account ID
+
+WHAT HAPPENS:
+- Webhook is permanently deleted
+- No more events will be sent to the endpoint
+- Cannot be undone (must recreate to re-enable)
+
+EXAMPLE PROMPTS:
+- "Delete webhook 123"
+- "Remove callback 456"
+- "Unregister the webhook for invoices"
+- "Stop sending payment notifications"
+
+RETURNS:
+Confirmation that the webhook was deleted successfully.`,
+    inputSchema: CallbackDeleteInputSchema,
+    outputSchema: CallbackDeleteOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('callback_delete', async (input, _context) => {
+            const { accountId, callbackId } = input;
+            await client.executeWithRetry('callback_delete', async (fbClient) => {
+                const response = await fbClient.callbacks.delete(accountId, String(callbackId));
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            return {
+                success: true,
+                callbackId,
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=callback-delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback-delete.js","sourceRoot":"","sources":["../../../src/tools/callback/callback-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;wDAuByC;IAEtD,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,0BAA0B;IAExC,KAAK,CAAC,OAAO,CACX,KAAgD,EAChD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,iBAAiB,EACjB,KAAK,EAAE,KAAgD,EAAE,QAAqB,EAAE,EAAE;YAChF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;YAExC,MAAM,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAClE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAEhF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,UAAU;aACX,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/callback/callback-list.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Callback List Tool
+ *
+ * List webhooks/callbacks with pagination.
+ */
+import { z } from "zod";
+import { CallbackListInputSchema, CallbackListOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for callback_list
+ */
+export declare const callbackListTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        perPage: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        page?: number | undefined;
+        perPage?: number | undefined;
+    }, {
+        accountId: string;
+        page?: number | undefined;
+        perPage?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        callbacks: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            event: z.ZodString;
+            uri: z.ZodString;
+            verified: z.ZodBoolean;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            uri: string;
+            createdAt: string;
+            id: number;
+            updatedAt: string;
+            event: string;
+            verified: boolean;
+        }, {
+            uri: string;
+            createdAt: string;
+            id: number;
+            updatedAt: string;
+            event: string;
+            verified: boolean;
+        }>, "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;
+        };
+        callbacks: {
+            uri: string;
+            createdAt: string;
+            id: number;
+            updatedAt: string;
+            event: string;
+            verified: boolean;
+        }[];
+    }, {
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+        callbacks: {
+            uri: string;
+            createdAt: string;
+            id: number;
+            updatedAt: string;
+            event: string;
+            verified: boolean;
+        }[];
+    }>;
+    execute(input: z.infer<typeof CallbackListInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof CallbackListOutputSchema>>;
+};
+//# sourceMappingURL=callback-list.d.ts.map

package/dist/tools/callback/callback-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-list.d.ts","sourceRoot":"","sources":["../../../src/tools/callback/callback-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAGjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAiClB,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,UACtC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;CAsDrD,CAAC"}

package/dist/tools/callback/callback-list.js

@@ -0,0 +1,84 @@
+/**
+ * Callback List Tool
+ *
+ * List webhooks/callbacks with pagination.
+ */
+import { CallbackListInputSchema, CallbackListOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for callback_list
+ */
+export const callbackListTool = {
+    name: "callback_list",
+    description: `List webhooks/callbacks from FreshBooks.
+
+WHEN TO USE:
+- User asks to "see webhooks", "list callbacks", "show webhook subscriptions"
+- User wants to check what events they're subscribed to
+- User needs to verify webhook setup
+
+WHAT IT RETURNS:
+Each callback includes:
+- Event type being monitored (e.g., invoice.create, payment.create)
+- Webhook endpoint URL
+- Verification status
+- Creation/update timestamps
+
+PAGINATION:
+- Use page/perPage for large result sets
+- Default: 30 results per page
+- Maximum: 100 results per page
+
+EXAMPLE PROMPTS:
+- "Show me all my webhooks"
+- "List webhook subscriptions"
+- "What events am I listening for?"
+
+RETURNS:
+Array of webhook configurations with their verification status and event types.`,
+    inputSchema: CallbackListInputSchema,
+    outputSchema: CallbackListOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('callback_list', async (input, _context) => {
+            const { accountId, page, perPage } = input;
+            const result = await client.executeWithRetry('callback_list', async (fbClient) => {
+                const { PaginationQueryBuilder } = 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);
+                }
+                const response = await fbClient.callbacks.list(accountId, queryBuilders);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract data
+            const callbacks = result.callbacks || [];
+            const paginationData = result.pages || {
+                page: 1,
+                pages: 1,
+                total: callbacks.length,
+                per_page: 30,
+            };
+            return {
+                callbacks,
+                pagination: {
+                    page: paginationData.page,
+                    pages: paginationData.pages,
+                    perPage: paginationData.per_page || paginationData.perPage || 30,
+                    total: paginationData.total,
+                },
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=callback-list.js.map

package/dist/tools/callback/callback-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-list.js","sourceRoot":"","sources":["../../../src/tools/callback/callback-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;gFAyBiE;IAE9E,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,wBAAwB;IAEtC,KAAK,CAAC,OAAO,CACX,KAA8C,EAC9C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,eAAe,EACf,KAAK,EAAE,KAA8C,EAAE,QAAqB,EAAE,EAAE;YAC9E,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;YAE3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC/E,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAC7C,+CAA+C,CAChD,CAAC;gBAEF,6BAA6B;gBAC7B,MAAM,aAAa,GAAU,EAAE,CAAC;gBAEhC,8BAA8B;gBAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAChD,MAAM,UAAU,GAAG,IAAI,sBAAsB,EAAE,CAAC;oBAChD,IAAI,IAAI,KAAK,SAAS;wBAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC9C,IAAI,OAAO,KAAK,SAAS;wBAAE,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBACvD,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,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,CAAC,CAAC;YAEH,eAAe;YACf,MAAM,SAAS,GAAI,MAAc,CAAC,SAAS,IAAI,EAAE,CAAC;YAClD,MAAM,cAAc,GAAI,MAAc,CAAC,KAAK,IAAI;gBAC9C,IAAI,EAAE,CAAC;gBACP,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,SAAS,CAAC,MAAM;gBACvB,QAAQ,EAAE,EAAE;aACb,CAAC;YAEF,OAAO;gBACL,SAAS;gBACT,UAAU,EAAE;oBACV,IAAI,EAAE,cAAc,CAAC,IAAI;oBACzB,KAAK,EAAE,cAAc,CAAC,KAAK;oBAC3B,OAAO,EAAE,cAAc,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,IAAI,EAAE;oBAChE,KAAK,EAAE,cAAc,CAAC,KAAK;iBAC5B;aACF,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/callback/callback-resend-verification.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Callback Resend Verification Tool
+ *
+ * Resend the verification request to a webhook endpoint.
+ */
+import { z } from "zod";
+import { CallbackResendVerificationInputSchema, CallbackSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for callback_resend_verification
+ */
+export declare const callbackResendVerificationTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        callbackId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        callbackId: number;
+    }, {
+        accountId: string;
+        callbackId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        event: z.ZodString;
+        uri: z.ZodString;
+        verified: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }, {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }>;
+    execute(input: z.infer<typeof CallbackResendVerificationInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof CallbackSingleOutputSchema>>;
+};
+//# sourceMappingURL=callback-resend-verification.d.ts.map

package/dist/tools/callback/callback-resend-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-resend-verification.d.ts","sourceRoot":"","sources":["../../../src/tools/callback/callback-resend-verification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qCAAqC,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAGjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAuChC,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,UACpD,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;CAuBvD,CAAC"}

package/dist/tools/callback/callback-resend-verification.js

@@ -0,0 +1,63 @@
+/**
+ * Callback Resend Verification Tool
+ *
+ * Resend the verification request to a webhook endpoint.
+ */
+import { CallbackResendVerificationInputSchema, CallbackSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for callback_resend_verification
+ */
+export const callbackResendVerificationTool = {
+    name: "callback_resend_verification",
+    description: `Resend the verification request to a webhook endpoint.
+
+WHEN TO USE:
+- User didn't receive the initial verification code
+- Verification code expired or was lost
+- User says "resend webhook verification", "send verification again"
+- Webhook endpoint was temporarily down during initial verification
+
+REQUIRED INFO:
+- Callback ID to resend verification for
+- Account ID
+
+WHAT HAPPENS:
+- FreshBooks sends a new POST request to the webhook URL
+- Request contains a fresh verifier code
+- User can then use callback_verify with the new code
+
+VERIFICATION REQUEST FORMAT:
+FreshBooks will POST to the webhook URL:
+{
+  "object": "callback",
+  "action": "verify",
+  "verifier": "new_abc123xyz..."
+}
+
+EXAMPLE PROMPTS:
+- "Resend verification for webhook 123"
+- "Send webhook verification again"
+- "I didn't get the verification code, send it again"
+
+RETURNS:
+Updated webhook configuration (still unverified until callback_verify is called).`,
+    inputSchema: CallbackResendVerificationInputSchema,
+    outputSchema: CallbackSingleOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('callback_resend_verification', async (input, _context) => {
+            const { accountId, callbackId } = input;
+            const result = await client.executeWithRetry('callback_resend_verification', async (fbClient) => {
+                const response = await fbClient.callbacks.resendVerification(accountId, String(callbackId));
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract callback data
+            return result.callback;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=callback-resend-verification.js.map

package/dist/tools/callback/callback-resend-verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-resend-verification.js","sourceRoot":"","sources":["../../../src/tools/callback/callback-resend-verification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qCAAqC,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kFA+BmE;IAEhF,WAAW,EAAE,qCAAqC;IAClD,YAAY,EAAE,0BAA0B;IAExC,KAAK,CAAC,OAAO,CACX,KAA4D,EAC5D,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,8BAA8B,EAC9B,KAAK,EAAE,KAA4D,EAAE,QAAqB,EAAE,EAAE;YAC5F,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;YAExC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,8BAA8B,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC9F,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAE5F,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,wBAAwB;YACxB,OAAQ,MAAc,CAAC,QAAQ,CAAC;QAClC,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/callback/callback-single.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Callback Single Tool
+ *
+ * Get a single webhook/callback by ID.
+ */
+import { z } from "zod";
+import { CallbackSingleInputSchema, CallbackSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for callback_single
+ */
+export declare const callbackSingleTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        callbackId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        callbackId: number;
+    }, {
+        accountId: string;
+        callbackId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        event: z.ZodString;
+        uri: z.ZodString;
+        verified: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }, {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }>;
+    execute(input: z.infer<typeof CallbackSingleInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof CallbackSingleOutputSchema>>;
+};
+//# sourceMappingURL=callback-single.d.ts.map

package/dist/tools/callback/callback-single.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-single.d.ts","sourceRoot":"","sources":["../../../src/tools/callback/callback-single.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;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA6BpB,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,UACxC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;CAuBvD,CAAC"}

package/dist/tools/callback/callback-single.js

@@ -0,0 +1,53 @@
+/**
+ * Callback Single Tool
+ *
+ * Get a single webhook/callback by ID.
+ */
+import { CallbackSingleInputSchema, CallbackSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for callback_single
+ */
+export const callbackSingleTool = {
+    name: "callback_single",
+    description: `Get a single webhook/callback by ID from FreshBooks.
+
+WHEN TO USE:
+- User asks for details about a specific webhook
+- User wants to check verification status of a webhook
+- User needs to see the configuration of a particular callback
+
+REQUIRED INFO:
+- Callback ID (from callback_list)
+- Account ID
+
+EXAMPLE PROMPTS:
+- "Show me webhook 123"
+- "Get details for callback 456"
+- "Is webhook 789 verified?"
+
+RETURNS:
+Complete webhook details including:
+- Event type
+- Endpoint URL
+- Verification status
+- Creation and update timestamps`,
+    inputSchema: CallbackSingleInputSchema,
+    outputSchema: CallbackSingleOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('callback_single', async (input, _context) => {
+            const { accountId, callbackId } = input;
+            const result = await client.executeWithRetry('callback_single', async (fbClient) => {
+                const response = await fbClient.callbacks.single(accountId, String(callbackId));
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract callback data
+            return result.callback;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=callback-single.js.map

package/dist/tools/callback/callback-single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-single.js","sourceRoot":"","sources":["../../../src/tools/callback/callback-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;iCAqBkB;IAE/B,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,0BAA0B;IAExC,KAAK,CAAC,OAAO,CACX,KAAgD,EAChD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,iBAAiB,EACjB,KAAK,EAAE,KAAgD,EAAE,QAAqB,EAAE,EAAE;YAChF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;YAExC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAEhF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,wBAAwB;YACxB,OAAQ,MAAc,CAAC,QAAQ,CAAC;QAClC,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/callback/callback-update.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Callback Update Tool
+ *
+ * Update an existing webhook/callback configuration.
+ */
+import { z } from "zod";
+import { CallbackUpdateInputSchema, CallbackSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for callback_update
+ */
+export declare const callbackUpdateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        callbackId: z.ZodNumber;
+        event: z.ZodOptional<z.ZodString>;
+        uri: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        callbackId: number;
+        uri?: string | undefined;
+        event?: string | undefined;
+    }, {
+        accountId: string;
+        callbackId: number;
+        uri?: string | undefined;
+        event?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        event: z.ZodString;
+        uri: z.ZodString;
+        verified: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }, {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }>;
+    execute(input: z.infer<typeof CallbackUpdateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof CallbackSingleOutputSchema>>;
+};
+//# sourceMappingURL=callback-update.d.ts.map

package/dist/tools/callback/callback-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-update.d.ts","sourceRoot":"","sources":["../../../src/tools/callback/callback-update.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;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAkCpB,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,UACxC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;CA+BvD,CAAC"}