@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/timer/timer-start.js

@@ -0,0 +1,129 @@
+/**
+ * Timer Start Tool
+ *
+ * Starts a new timer using the /comments/business/.../time_entries endpoint.
+ * This endpoint is not supported by the SDK, so we use raw HTTP.
+ *
+ * Note: The SDK uses /timetracking/business/... but timer operations require /comments/business/...
+ */
+import { TimerStartInputSchema, TimerStartOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for timer_start
+ */
+export const timerStartTool = {
+    name: "timer_start",
+    description: `Start a new timer for time tracking in FreshBooks.
+
+WHEN TO USE:
+- User says "start timer", "begin tracking time", "clock in"
+- User wants to track time on a task or project
+- Starting work on billable hours
+
+HOW IT WORKS:
+Creates a new time entry with:
+- active=true (timer is running)
+- duration=0 (will auto-calculate when stopped)
+- startedAt=now (start time)
+- isLogged=false (not yet logged as completed time)
+
+IMPORTANT NOTES:
+- FreshBooks typically allows only ONE active timer per user
+- If a timer is already running, you may need to stop it first
+- The timer will continue running until explicitly stopped
+- Duration is auto-calculated from startedAt when stopped
+
+REQUIRED:
+- businessId: FreshBooks business ID (get from user_me -> businessMemberships[].business.id)
+
+OPTIONAL BUT HELPFUL:
+- projectId: Associate timer with a specific project (recommended for billing)
+- clientId: Associate timer with a client
+- serviceId: Type of service/work being performed
+- taskId: Specific task within a project
+- note: Description of work being performed (can be updated when stopping)
+- billable: Whether time is billable (default: true)
+- internal: Whether this is internal work (default: false)
+
+EXAMPLE USAGE:
+- "Start a timer for Project Alpha"
+- "Begin tracking time on bug fixes"
+- "Clock in for client meeting"
+
+RETURNS:
+Created time entry with:
+- id: Use this ID to stop or discard the timer later
+- active: true (timer is running)
+- duration: 0 (will be calculated when stopped)
+- startedAt: When timer started
+- timer: Active timer object with isRunning=true`,
+    inputSchema: TimerStartInputSchema,
+    outputSchema: TimerStartOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('timer_start', async (input, _context) => {
+            const { businessId, projectId, clientId, serviceId, taskId, note, billable, internal } = input;
+            // Build the time entry payload using snake_case (raw API format)
+            // This matches the format used by the FreshBooks website
+            const timeEntryPayload = {
+                time_entry: {
+                    is_logged: false,
+                    duration: null, // null for active timer
+                    note: note ?? null,
+                    internal: internal ?? false,
+                    retainer_id: null,
+                    pending_client: null,
+                    pending_project: null,
+                    pending_task: null,
+                    source: null,
+                    started_at: new Date().toISOString(),
+                    local_started_at: null,
+                    local_timezone: null,
+                    billable: billable ?? false,
+                    billed: false,
+                    timer: {}, // Empty object for new timer
+                    identity_id: null,
+                    client_id: clientId ?? null,
+                    project_id: projectId ?? null,
+                    service_id: serviceId ?? null,
+                    task_id: taskId ?? null,
+                },
+            };
+            // Use raw HTTP to POST to /comments/business/.../time_entries
+            const result = await client.executeRawWithRetry('POST', `/comments/business/${businessId}/time_entries`, timeEntryPayload, 'timer_start');
+            if (!result.ok || !result.data) {
+                throw result.error || new Error('Failed to start timer');
+            }
+            const te = result.data.time_entry;
+            // Transform to camelCase output format
+            return {
+                id: te.id,
+                identityId: te.identity_id,
+                isLogged: te.is_logged,
+                startedAt: te.started_at,
+                createdAt: te.created_at,
+                clientId: te.client_id,
+                projectId: te.project_id,
+                taskId: te.task_id,
+                serviceId: te.service_id,
+                note: te.note,
+                active: te.active,
+                billable: te.billable,
+                billed: te.billed,
+                internal: te.internal,
+                duration: te.duration ?? 0,
+                timer: te.timer ? {
+                    id: te.timer.id,
+                    isRunning: te.timer.is_running ?? true,
+                } : null,
+            };
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+/**
+ * Wrapped handler for backward compatibility with tests
+ */
+export async function timerStartHandler(input, context) {
+    return timerStartTool.execute(input, context.client);
+}
+//# sourceMappingURL=timer-start.js.map

package/dist/tools/timer/timer-start.js.map

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

package/dist/tools/timer/timer-stop.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Timer Stop Tool
+ *
+ * Stops a running timer and logs the time using the /comments/business/.../timers endpoint.
+ * This endpoint is not supported by the SDK, so we use raw HTTP.
+ *
+ * Note: The SDK uses /timetracking/business/... but timer operations require /comments/business/...
+ */
+import { z } from "zod";
+import { TimerStopInputSchema, TimerStopOutputSchema } from "./schemas.js";
+import { ToolContext } from "../../errors/types.js";
+import { FreshBooksClientWrapper } from "../../client/freshbooks-client.js";
+/**
+ * Tool definition for timer_stop
+ */
+export declare const timerStopTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+    } & {
+        timerId: z.ZodOptional<z.ZodNumber>;
+        timeEntryId: z.ZodOptional<z.ZodNumber>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        note?: string | undefined;
+        timeEntryId?: number | undefined;
+        timerId?: number | undefined;
+    }, {
+        businessId: number;
+        note?: string | undefined;
+        timeEntryId?: number | undefined;
+        timerId?: number | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        identityId: z.ZodOptional<z.ZodNumber>;
+        isLogged: z.ZodBoolean;
+        startedAt: z.ZodString;
+        createdAt: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        projectId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        taskId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        serviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        active: z.ZodBoolean;
+        billable: z.ZodOptional<z.ZodBoolean>;
+        billed: z.ZodOptional<z.ZodBoolean>;
+        internal: z.ZodOptional<z.ZodBoolean>;
+        duration: z.ZodNumber;
+        timer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodNumber;
+            isRunning: z.ZodNullable<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            id: number;
+            isRunning: boolean | null;
+        }, {
+            id: number;
+            isRunning: boolean | null;
+        }>>>;
+        pendingClient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingProject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingTask: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        retainerId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        duration: number;
+        id: number;
+        isLogged: boolean;
+        startedAt: string;
+        active: boolean;
+        billed?: boolean | undefined;
+        taskId?: number | null | undefined;
+        createdAt?: string | undefined;
+        identityId?: number | undefined;
+        clientId?: number | null | undefined;
+        projectId?: number | null | undefined;
+        pendingClient?: string | null | undefined;
+        pendingProject?: string | null | undefined;
+        pendingTask?: string | null | undefined;
+        serviceId?: number | null | undefined;
+        note?: string | null | undefined;
+        billable?: boolean | undefined;
+        internal?: boolean | undefined;
+        retainerId?: number | null | undefined;
+        timer?: {
+            id: number;
+            isRunning: boolean | null;
+        } | null | undefined;
+    }, {
+        duration: number;
+        id: number;
+        isLogged: boolean;
+        startedAt: string;
+        active: boolean;
+        billed?: boolean | undefined;
+        taskId?: number | null | undefined;
+        createdAt?: string | undefined;
+        identityId?: number | undefined;
+        clientId?: number | null | undefined;
+        projectId?: number | null | undefined;
+        pendingClient?: string | null | undefined;
+        pendingProject?: string | null | undefined;
+        pendingTask?: string | null | undefined;
+        serviceId?: number | null | undefined;
+        note?: string | null | undefined;
+        billable?: boolean | undefined;
+        internal?: boolean | undefined;
+        retainerId?: number | null | undefined;
+        timer?: {
+            id: number;
+            isRunning: boolean | null;
+        } | null | undefined;
+    }>;
+    execute(input: z.infer<typeof TimerStopInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof TimerStopOutputSchema>>;
+};
+/**
+ * Wrapped handler for backward compatibility with tests
+ */
+export declare function timerStopHandler(input: z.infer<typeof TimerStopInputSchema>, context: ToolContext & {
+    client: FreshBooksClientWrapper;
+}): Promise<z.infer<typeof TimerStopOutputSchema>>;
+//# sourceMappingURL=timer-stop.d.ts.map

package/dist/tools/timer/timer-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer-stop.d.ts","sourceRoot":"","sources":["../../../src/tools/timer/timer-stop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AA4B5E;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAyCf,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,UACnC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;CA0IlD,CAAC;AAEF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EAC3C,OAAO,EAAE,WAAW,GAAG;IAAE,MAAM,EAAE,uBAAuB,CAAA;CAAE,GACzD,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAEhD"}

package/dist/tools/timer/timer-stop.js

@@ -0,0 +1,165 @@
+/**
+ * Timer Stop Tool
+ *
+ * Stops a running timer and logs the time using the /comments/business/.../timers endpoint.
+ * This endpoint is not supported by the SDK, so we use raw HTTP.
+ *
+ * Note: The SDK uses /timetracking/business/... but timer operations require /comments/business/...
+ */
+import { TimerStopInputSchema, TimerStopOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for timer_stop
+ */
+export const timerStopTool = {
+    name: "timer_stop",
+    description: `Stop a running timer and log the time in FreshBooks.
+
+WHEN TO USE:
+- User says "stop timer", "stop tracking", "clock out"
+- User finishes work on a task/project and wants to log the time
+- User wants to save and log the time entry
+
+HOW IT WORKS:
+1. Gets the current timer to calculate total duration
+2. Aggregates duration across all time entry segments
+3. Updates the timer to mark time as logged and billable
+
+REQUIRED:
+- businessId: FreshBooks business ID (get from user_me -> businessMemberships[].business.id)
+
+OPTIONAL:
+- timerId: ID of the timer to stop (from timer_current). If not provided, stops the current running timer.
+- note: Update the description before stopping
+
+WHAT IF NO TIMER IS RUNNING:
+- Returns error if no active timer found
+
+EXAMPLE USAGE:
+- "Stop my timer" (auto-detects current timer)
+- "Stop timer and add note: completed bug fixes"
+
+RETURNS:
+Stopped time entry with:
+- id: The time entry ID
+- timerId: The timer ID
+- active: false (timer has stopped)
+- duration: Total calculated time in seconds
+- isLogged: true (time is now logged)
+- billable: true (time is marked billable)`,
+    inputSchema: TimerStopInputSchema,
+    outputSchema: TimerStopOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('timer_stop', async (input, _context) => {
+            const { businessId, timerId, timeEntryId, note } = input;
+            // First, get current timers to find the one to stop
+            const timersResult = await client.executeRawWithRetry('GET', `/comments/business/${businessId}/timers`, undefined, 'timer_stop_get_timers');
+            if (!timersResult.ok || !timersResult.data) {
+                throw timersResult.error || new Error('Failed to fetch timers');
+            }
+            const timers = timersResult.data.timers || [];
+            if (timers.length === 0) {
+                throw new Error('No timer found to stop');
+            }
+            // Find the timer to stop
+            let targetTimer = timers[0]; // Default to first timer
+            if (timerId) {
+                const found = timers.find(t => t.id === timerId);
+                if (!found) {
+                    throw new Error(`Timer with ID ${timerId} not found`);
+                }
+                targetTimer = found;
+            }
+            else if (timeEntryId) {
+                // Legacy: find timer containing this time entry
+                const found = timers.find(t => t.time_entries?.some(te => te.id === timeEntryId));
+                if (found) {
+                    targetTimer = found;
+                }
+            }
+            if (!targetTimer) {
+                throw new Error('No timer found to stop');
+            }
+            const timeEntries = targetTimer.time_entries || [];
+            if (timeEntries.length === 0) {
+                throw new Error('Timer has no time entries');
+            }
+            // Calculate total duration across all time entry segments
+            let totalDuration = timeEntries.reduce((total, entry) => {
+                return entry.duration ? total + Math.floor(entry.duration) : total;
+            }, 0);
+            // Add duration for currently running segment (duration === null)
+            if (targetTimer.is_running) {
+                const runningEntry = timeEntries.find(te => te.duration === null);
+                if (runningEntry) {
+                    const startTime = new Date(runningEntry.started_at).getTime();
+                    const now = Date.now();
+                    const runningDuration = Math.floor((now - startTime) / 1000);
+                    totalDuration += runningDuration;
+                }
+            }
+            if (totalDuration === 0) {
+                throw new Error('No time to log, timer has no duration');
+            }
+            // Get the first time entry as the base for the update
+            const sourceEntry = timeEntries[0];
+            // Build the payload to stop and log the timer
+            // This matches the FreshBooks website behavior
+            const updatePayload = {
+                timer: {
+                    time_entries: [{
+                            id: sourceEntry.id,
+                            is_logged: sourceEntry.is_logged,
+                            started_at: sourceEntry.started_at,
+                            client_id: sourceEntry.client_id,
+                            project_id: sourceEntry.project_id,
+                            task_id: sourceEntry.task_id,
+                            service_id: sourceEntry.service_id,
+                            note: note ?? sourceEntry.note,
+                            active: false,
+                            billable: true, // Mark as billable when stopping
+                            billed: sourceEntry.billed ?? false,
+                            internal: sourceEntry.internal ?? false,
+                            duration: totalDuration,
+                        }],
+                },
+            };
+            // PUT to /timers/{id} to stop and log
+            const result = await client.executeRawWithRetry('PUT', `/comments/business/${businessId}/timers/${targetTimer.id}`, updatePayload, 'timer_stop');
+            if (!result.ok) {
+                throw result.error || new Error('Failed to stop timer');
+            }
+            // Return the stopped time entry info
+            return {
+                id: sourceEntry.id,
+                timerId: targetTimer.id,
+                identityId: undefined,
+                isLogged: true,
+                startedAt: sourceEntry.started_at,
+                createdAt: sourceEntry.created_at,
+                clientId: sourceEntry.client_id,
+                projectId: sourceEntry.project_id,
+                taskId: sourceEntry.task_id,
+                serviceId: sourceEntry.service_id,
+                note: note ?? sourceEntry.note,
+                active: false,
+                billable: true,
+                billed: sourceEntry.billed,
+                internal: sourceEntry.internal,
+                duration: totalDuration,
+                timer: {
+                    id: targetTimer.id,
+                    isRunning: false,
+                },
+            };
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+/**
+ * Wrapped handler for backward compatibility with tests
+ */
+export async function timerStopHandler(input, context) {
+    return timerStopTool.execute(input, context.client);
+}
+//# sourceMappingURL=timer-stop.js.map

package/dist/tools/timer/timer-stop.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Tool Metadata Types
+ *
+ * Defines types for tool metadata used by the hosted server
+ * to categorize and filter tools based on user permissions.
+ */
+/**
+ * Tool categories matching FreshBooks resource types
+ */
+export type ToolCategory = 'Invoice' | 'Client' | 'Project' | 'TimeEntry' | 'Timer' | 'Expense' | 'ExpenseCategory' | 'Payment' | 'Item' | 'Bill' | 'BillPayment' | 'BillVendor' | 'CreditNote' | 'OtherIncome' | 'JournalEntry' | 'JournalEntryAccount' | 'Service' | 'Task' | 'User' | 'Report' | 'PaymentOptions' | 'Callback';
+/**
+ * Metadata for a single tool
+ */
+export interface ToolMetadata {
+    /** Tool name (e.g., 'invoice_list') */
+    name: string;
+    /** Category the tool belongs to */
+    category: ToolCategory;
+    /** Whether this tool only reads data (no mutations) */
+    isReadOnly: boolean;
+    /** Human-readable display name for the tool */
+    displayName: string;
+}
+/**
+ * Category metadata for UI display
+ */
+export interface CategoryMetadata {
+    /** Category identifier */
+    id: ToolCategory;
+    /** Human-readable display name */
+    displayName: string;
+    /** Brief description of what this category covers */
+    description: string;
+    /** Number of read-only tools in this category */
+    readOnlyCount: number;
+    /** Number of write tools in this category */
+    writeCount: number;
+    /** All tools in this category */
+    tools: ToolMetadata[];
+}
+/**
+ * Display names for each category
+ */
+export declare const categoryDisplayNames: Record<ToolCategory, string>;
+/**
+ * Descriptions for each category
+ */
+export declare const categoryDescriptions: Record<ToolCategory, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,GACX,OAAO,GACP,SAAS,GACT,iBAAiB,GACjB,SAAS,GACT,MAAM,GACN,MAAM,GACN,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,cAAc,GACd,qBAAqB,GACrB,SAAS,GACT,MAAM,GACN,MAAM,GACN,QAAQ,GACR,gBAAgB,GAChB,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,YAAY,CAAC;IACvB,uDAAuD;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,EAAE,EAAE,YAAY,CAAC;IACjB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAuB7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAuB7D,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,61 @@
+/**
+ * Tool Metadata Types
+ *
+ * Defines types for tool metadata used by the hosted server
+ * to categorize and filter tools based on user permissions.
+ */
+/**
+ * Display names for each category
+ */
+export const categoryDisplayNames = {
+    Invoice: 'Invoices',
+    Client: 'Clients',
+    Project: 'Projects',
+    TimeEntry: 'Time Entries',
+    Timer: 'Timers',
+    Expense: 'Expenses',
+    ExpenseCategory: 'Expense Categories',
+    Payment: 'Payments',
+    Item: 'Items',
+    Bill: 'Bills',
+    BillPayment: 'Bill Payments',
+    BillVendor: 'Vendors',
+    CreditNote: 'Credit Notes',
+    OtherIncome: 'Other Income',
+    JournalEntry: 'Journal Entries',
+    JournalEntryAccount: 'Chart of Accounts',
+    Service: 'Services',
+    Task: 'Tasks',
+    User: 'User Info',
+    Report: 'Reports',
+    PaymentOptions: 'Payment Options',
+    Callback: 'Webhooks',
+};
+/**
+ * Descriptions for each category
+ */
+export const categoryDescriptions = {
+    Invoice: 'Create, send, and manage client invoices',
+    Client: 'Manage customers and their contact information',
+    Project: 'Track projects and their details',
+    TimeEntry: 'Log and manage time entries for billing',
+    Timer: 'Start, stop, and manage active timers',
+    Expense: 'Track business expenses and receipts',
+    ExpenseCategory: 'View expense category definitions',
+    Payment: 'Record and track invoice payments',
+    Item: 'Manage reusable invoice line items',
+    Bill: 'Track bills from vendors and suppliers',
+    BillPayment: 'Record payments made to vendors',
+    BillVendor: 'Manage vendors and suppliers',
+    CreditNote: 'Create and manage credit notes',
+    OtherIncome: 'Track income not tied to invoices',
+    JournalEntry: 'Create manual accounting entries',
+    JournalEntryAccount: 'View chart of accounts',
+    Service: 'Manage billable services and rates',
+    Task: 'Manage project tasks',
+    User: 'View current user information',
+    Report: 'Generate financial reports',
+    PaymentOptions: 'Configure payment gateway settings',
+    Callback: 'Manage webhook subscriptions',
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6DH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,cAAc;IACzB,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,UAAU;IACnB,eAAe,EAAE,oBAAoB;IACrC,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,cAAc;IAC1B,WAAW,EAAE,cAAc;IAC3B,YAAY,EAAE,iBAAiB;IAC/B,mBAAmB,EAAE,mBAAmB;IACxC,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,SAAS;IACjB,cAAc,EAAE,iBAAiB;IACjC,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,OAAO,EAAE,0CAA0C;IACnD,MAAM,EAAE,gDAAgD;IACxD,OAAO,EAAE,kCAAkC;IAC3C,SAAS,EAAE,yCAAyC;IACpD,KAAK,EAAE,uCAAuC;IAC9C,OAAO,EAAE,sCAAsC;IAC/C,eAAe,EAAE,mCAAmC;IACpD,OAAO,EAAE,mCAAmC;IAC5C,IAAI,EAAE,oCAAoC;IAC1C,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EAAE,iCAAiC;IAC9C,UAAU,EAAE,8BAA8B;IAC1C,UAAU,EAAE,gCAAgC;IAC5C,WAAW,EAAE,mCAAmC;IAChD,YAAY,EAAE,kCAAkC;IAChD,mBAAmB,EAAE,wBAAwB;IAC7C,OAAO,EAAE,oCAAoC;IAC7C,IAAI,EAAE,sBAAsB;IAC5B,IAAI,EAAE,+BAA+B;IACrC,MAAM,EAAE,4BAA4B;IACpC,cAAc,EAAE,oCAAoC;IACpD,QAAQ,EAAE,8BAA8B;CACzC,CAAC"}

package/dist/tools/user/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * User Tools - FreshBooks user account management
+ *
+ * Exports all user-related MCP tools for account information.
+ */
+export { userMeTool } from "./user-me.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/user/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/user/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/tools/user/index.js

@@ -0,0 +1,9 @@
+/**
+ * User Tools - FreshBooks user account management
+ *
+ * Exports all user-related MCP tools for account information.
+ */
+// Export schemas
+// Export tool definitions
+export { userMeTool } from "./user-me.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/user/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/user/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AAEjB,0BAA0B;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}