@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/time-entry/timeentry-list.d.ts

@@ -0,0 +1,232 @@
+/**
+ * timeentry_list Tool
+ *
+ * List time entries from FreshBooks with filtering and pagination.
+ */
+import { z } from 'zod';
+import { TimeEntryListInputSchema, TimeEntryListOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for timeentry_list
+ */
+export declare const timeentryListTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        perPage: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        projectId: z.ZodOptional<z.ZodNumber>;
+        clientId: z.ZodOptional<z.ZodNumber>;
+        taskId: z.ZodOptional<z.ZodNumber>;
+        serviceId: z.ZodOptional<z.ZodNumber>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        billable: z.ZodOptional<z.ZodBoolean>;
+        billed: z.ZodOptional<z.ZodBoolean>;
+        startedAfter: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+        startedBefore: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+    } & {
+        sortBy: z.ZodOptional<z.ZodEnum<["duration" | "started_at" | "created_at", ...("duration" | "started_at" | "created_at")[]]>>;
+        sortOrder: z.ZodOptional<z.ZodDefault<z.ZodEnum<["asc", "desc"]>>>;
+    } & {
+        include: z.ZodOptional<z.ZodArray<z.ZodEnum<["task" | "client" | "project" | "service", ...("task" | "client" | "project" | "service")[]]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        billed?: boolean | undefined;
+        taskId?: number | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        sortBy?: "duration" | "started_at" | "created_at" | undefined;
+        sortOrder?: "asc" | "desc" | undefined;
+        include?: ("task" | "client" | "project" | "service")[] | undefined;
+        clientId?: number | undefined;
+        projectId?: number | undefined;
+        serviceId?: number | undefined;
+        active?: boolean | undefined;
+        billable?: boolean | undefined;
+        startedAfter?: string | undefined;
+        startedBefore?: string | undefined;
+    }, {
+        businessId: number;
+        billed?: boolean | undefined;
+        taskId?: number | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        sortBy?: "duration" | "started_at" | "created_at" | undefined;
+        sortOrder?: "asc" | "desc" | undefined;
+        include?: ("task" | "client" | "project" | "service")[] | undefined;
+        clientId?: number | undefined;
+        projectId?: number | undefined;
+        serviceId?: number | undefined;
+        active?: boolean | undefined;
+        billable?: boolean | undefined;
+        startedAfter?: string | undefined;
+        startedBefore?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        timeEntries: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<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>>;
+            pendingClient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            pendingProject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            pendingTask: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            taskId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            serviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            active: z.ZodOptional<z.ZodBoolean>;
+            billable: z.ZodOptional<z.ZodBoolean>;
+            billed: z.ZodOptional<z.ZodBoolean>;
+            internal: z.ZodOptional<z.ZodBoolean>;
+            retainerId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            duration: z.ZodNumber;
+            timer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                id: z.ZodOptional<z.ZodNumber>;
+                isRunning: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            }, "strip", z.ZodTypeAny, {
+                id?: number | undefined;
+                isRunning?: boolean | null | undefined;
+            }, {
+                id?: number | undefined;
+                isRunning?: boolean | null | undefined;
+            }>>>;
+        }, "strip", z.ZodTypeAny, {
+            duration: number;
+            isLogged: boolean;
+            startedAt: string;
+            billed?: boolean | undefined;
+            taskId?: number | null | undefined;
+            createdAt?: string | undefined;
+            id?: number | 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;
+            active?: boolean | undefined;
+            billable?: boolean | undefined;
+            internal?: boolean | undefined;
+            retainerId?: number | null | undefined;
+            timer?: {
+                id?: number | undefined;
+                isRunning?: boolean | null | undefined;
+            } | null | undefined;
+        }, {
+            duration: number;
+            isLogged: boolean;
+            startedAt: string;
+            billed?: boolean | undefined;
+            taskId?: number | null | undefined;
+            createdAt?: string | undefined;
+            id?: number | 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;
+            active?: boolean | undefined;
+            billable?: boolean | undefined;
+            internal?: boolean | undefined;
+            retainerId?: number | null | undefined;
+            timer?: {
+                id?: number | undefined;
+                isRunning?: boolean | null | undefined;
+            } | null | 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, {
+        timeEntries: {
+            duration: number;
+            isLogged: boolean;
+            startedAt: string;
+            billed?: boolean | undefined;
+            taskId?: number | null | undefined;
+            createdAt?: string | undefined;
+            id?: number | 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;
+            active?: boolean | undefined;
+            billable?: boolean | undefined;
+            internal?: boolean | undefined;
+            retainerId?: number | null | undefined;
+            timer?: {
+                id?: number | undefined;
+                isRunning?: boolean | null | undefined;
+            } | null | undefined;
+        }[];
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+    }, {
+        timeEntries: {
+            duration: number;
+            isLogged: boolean;
+            startedAt: string;
+            billed?: boolean | undefined;
+            taskId?: number | null | undefined;
+            createdAt?: string | undefined;
+            id?: number | 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;
+            active?: boolean | undefined;
+            billable?: boolean | undefined;
+            internal?: boolean | undefined;
+            retainerId?: number | null | undefined;
+            timer?: {
+                id?: number | undefined;
+                isRunning?: boolean | null | undefined;
+            } | null | undefined;
+        }[];
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof TimeEntryListInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof TimeEntryListOutputSchema>>;
+};
+//# sourceMappingURL=timeentry-list.d.ts.map

package/dist/tools/time-entry/timeentry-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeentry-list.d.ts","sourceRoot":"","sources":["../../../src/tools/time-entry/timeentry-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAMhE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4D5B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CAkGtD,CAAC"}

package/dist/tools/time-entry/timeentry-list.js

@@ -0,0 +1,154 @@
+/**
+ * timeentry_list Tool
+ *
+ * List time entries from FreshBooks with filtering and pagination.
+ */
+import { TimeEntryListInputSchema, TimeEntryListOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+import { logger } from '../../utils/logger.js';
+import { buildQueryBuilders } from '../base-tool.js';
+/**
+ * Tool definition for timeentry_list
+ */
+export const timeentryListTool = {
+    name: 'timeentry_list',
+    description: `List time entries from FreshBooks.
+
+WHEN TO USE:
+- User asks to see their time entries, logged hours, or time tracking history
+- User wants to review time for a specific project or client
+- User needs to find entries within a date range
+- User wants to see active/running timers
+- User asks "show my time entries", "what time did I log today", "time on project X"
+
+REQUIRED:
+- businessId: FreshBooks business ID (get from user_me -> businessMemberships[].business.id)
+
+OPTIONAL FILTERS:
+- projectId: Filter by specific project
+- clientId: Filter by specific client
+- taskId: Filter by specific task
+- serviceId: Filter by specific service
+- active: Filter by active status (true = running timers only)
+- billable: Filter by billable status
+- billed: Filter by whether already billed
+- startedAfter: Show entries after this date (ISO 8601)
+- startedBefore: Show entries before this date (ISO 8601)
+
+SORTING:
+- sortBy: Field to sort by (started_at, created_at, duration)
+- sortOrder: Sort direction (asc or desc, default: desc for most recent first)
+
+INCLUDES:
+- include: Related data to fetch (client, project, task, service)
+  - client: Client details associated with the time entry
+  - project: Project details for the time entry
+  - task: Task information if assigned
+  - service: Service type for billing categorization
+
+PAGINATION:
+- page: Page number (default: 1)
+- perPage: Results per page (default: 30, max: 100)
+
+RETURNS:
+Array of time entries with:
+- duration: Time in seconds
+- note: Description of work
+- startedAt: When the entry began
+- projectId, clientId, taskId, serviceId: Associated entities
+- billable, billed: Billing status
+- active: Whether timer is currently running
+Plus pagination metadata (page, pages, total)
+
+EXAMPLES:
+- "Show my time entries for today"
+- "List time logged on project 123"
+- "Show billable time entries from last week"
+- "Find active timers sorted by duration"
+- "Get time entries with project details included"`,
+    inputSchema: TimeEntryListInputSchema,
+    outputSchema: TimeEntryListOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('timeentry_list', async (input, _context) => {
+            logger.debug('Listing time entries', {
+                businessId: input.businessId,
+                filters: {
+                    projectId: input.projectId,
+                    clientId: input.clientId,
+                    active: input.active,
+                },
+            });
+            const result = await client.executeWithRetry('timeentry_list', async (fbClient) => {
+                // Build query builders using the helper
+                const queryBuilders = await buildQueryBuilders({
+                    page: input.page,
+                    perPage: input.perPage,
+                    sortBy: input.sortBy,
+                    sortOrder: input.sortOrder,
+                    include: input.include,
+                    searchFilters: (search) => {
+                        if (input.projectId) {
+                            search.equals('project_id', input.projectId);
+                        }
+                        if (input.clientId) {
+                            search.equals('client_id', input.clientId);
+                        }
+                        if (input.taskId) {
+                            search.equals('task_id', input.taskId);
+                        }
+                        if (input.serviceId) {
+                            search.equals('service_id', input.serviceId);
+                        }
+                        if (input.active !== undefined) {
+                            search.boolean('active', input.active);
+                        }
+                        if (input.billable !== undefined) {
+                            search.boolean('billable', input.billable);
+                        }
+                        if (input.billed !== undefined) {
+                            search.boolean('billed', input.billed);
+                        }
+                        if (input.startedAfter) {
+                            search.between('started_at', {
+                                min: input.startedAfter,
+                                max: input.startedBefore || new Date().toISOString(),
+                            });
+                        }
+                        else if (input.startedBefore) {
+                            search.between('started_at', {
+                                min: '1970-01-01T00:00:00Z',
+                                max: input.startedBefore,
+                            });
+                        }
+                    },
+                });
+                // Call FreshBooks API
+                const response = await fbClient.timeEntries.list(input.businessId, queryBuilders);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                const responseData = response.data;
+                const paginationData = responseData?.pages || {};
+                return {
+                    timeEntries: responseData?.timeEntries || [],
+                    pagination: {
+                        page: paginationData.page || 1,
+                        pages: paginationData.pages || 1,
+                        perPage: paginationData.per_page || paginationData.perPage || 30,
+                        total: paginationData.total || 0,
+                    },
+                };
+            });
+            logger.info('Time entries listed successfully', {
+                count: result.timeEntries.length,
+                total: result.pagination.total,
+            });
+            return result;
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+//# sourceMappingURL=timeentry-list.js.map

package/dist/tools/time-entry/timeentry-list.js.map

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

package/dist/tools/time-entry/timeentry-single.d.ts

@@ -0,0 +1,109 @@
+/**
+ * timeentry_single Tool
+ *
+ * Retrieve a single time entry by ID from FreshBooks.
+ */
+import { z } from 'zod';
+import { TimeEntrySingleInputSchema, TimeEntrySingleOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for timeentry_single
+ */
+export declare const timeentrySingleTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        timeEntryId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        timeEntryId: number;
+    }, {
+        businessId: number;
+        timeEntryId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodOptional<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>>;
+        pendingClient: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingProject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pendingTask: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taskId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        serviceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        active: z.ZodOptional<z.ZodBoolean>;
+        billable: z.ZodOptional<z.ZodBoolean>;
+        billed: z.ZodOptional<z.ZodBoolean>;
+        internal: z.ZodOptional<z.ZodBoolean>;
+        retainerId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        duration: z.ZodNumber;
+        timer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodOptional<z.ZodNumber>;
+            isRunning: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            id?: number | undefined;
+            isRunning?: boolean | null | undefined;
+        }, {
+            id?: number | undefined;
+            isRunning?: boolean | null | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        duration: number;
+        isLogged: boolean;
+        startedAt: string;
+        billed?: boolean | undefined;
+        taskId?: number | null | undefined;
+        createdAt?: string | undefined;
+        id?: number | 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;
+        active?: boolean | undefined;
+        billable?: boolean | undefined;
+        internal?: boolean | undefined;
+        retainerId?: number | null | undefined;
+        timer?: {
+            id?: number | undefined;
+            isRunning?: boolean | null | undefined;
+        } | null | undefined;
+    }, {
+        duration: number;
+        isLogged: boolean;
+        startedAt: string;
+        billed?: boolean | undefined;
+        taskId?: number | null | undefined;
+        createdAt?: string | undefined;
+        id?: number | 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;
+        active?: boolean | undefined;
+        billable?: boolean | undefined;
+        internal?: boolean | undefined;
+        retainerId?: number | null | undefined;
+        timer?: {
+            id?: number | undefined;
+            isRunning?: boolean | null | undefined;
+        } | null | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof TimeEntrySingleInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof TimeEntrySingleOutputSchema>>;
+};
+//# sourceMappingURL=timeentry-single.d.ts.map

package/dist/tools/time-entry/timeentry-single.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeentry-single.d.ts","sourceRoot":"","sources":["../../../src/tools/time-entry/timeentry-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAKhE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmC9B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,UACzC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;CAiDxD,CAAC"}

package/dist/tools/time-entry/timeentry-single.js

@@ -0,0 +1,75 @@
+/**
+ * timeentry_single Tool
+ *
+ * Retrieve a single time entry by ID from FreshBooks.
+ */
+import { TimeEntrySingleInputSchema, TimeEntrySingleOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Tool definition for timeentry_single
+ */
+export const timeentrySingleTool = {
+    name: 'timeentry_single',
+    description: `Get a single time entry by ID from FreshBooks.
+
+WHEN TO USE:
+- User wants to see details of a specific time entry
+- User references a time entry ID and wants full information
+- User asks "show time entry 123", "get details for entry X"
+- Need to retrieve a time entry before updating or deleting it
+
+REQUIRED:
+- businessId: FreshBooks business ID (get from user_me -> businessMemberships[].business.id)
+- timeEntryId: The ID of the time entry to retrieve
+
+RETURNS:
+Complete time entry object with:
+- id: Time entry ID
+- duration: Time in seconds
+- note: Description of work
+- startedAt: When the entry began
+- createdAt: When the entry was created
+- projectId, clientId, taskId, serviceId: Associated entities
+- billable, billed: Billing status
+- active: Whether timer is currently running
+- timer: Active timer object if running
+- All other time entry fields
+
+EXAMPLES:
+- "Show me time entry 456"
+- "Get details for time entry ID 789"
+- "What's in time entry 123?"`,
+    inputSchema: TimeEntrySingleInputSchema,
+    outputSchema: TimeEntrySingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('timeentry_single', async (input, _context) => {
+            logger.debug('Retrieving time entry', {
+                businessId: input.businessId,
+                timeEntryId: input.timeEntryId,
+            });
+            const result = await client.executeWithRetry('timeentry_single', async (fbClient) => {
+                const response = await fbClient.timeEntries.single(input.businessId, input.timeEntryId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                if (!response.data) {
+                    throw ErrorHandler.createNotFoundError('TimeEntry', input.timeEntryId, {
+                        businessId: input.businessId,
+                    });
+                }
+                return response.data;
+            });
+            logger.info('Time entry retrieved successfully', {
+                timeEntryId: input.timeEntryId,
+                duration: result.duration,
+            });
+            return result;
+        });
+        return handler(input, { businessId: input.businessId, entityId: input.timeEntryId });
+    },
+};
+//# sourceMappingURL=timeentry-single.js.map

package/dist/tools/time-entry/timeentry-single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeentry-single.js","sourceRoot":"","sources":["../../../src/tools/time-entry/timeentry-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA4Be;IAE5B,WAAW,EAAE,0BAA0B;IACvC,YAAY,EAAE,2BAA2B;IAEzC;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAiD,EACjD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,kBAAkB,EAClB,KAAK,EACH,KAAiD,EACjD,QAAqB,EACrB,EAAE;YACF,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACpC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,kBAAkB,EAClB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAChD,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,WAAW,CAClB,CAAC;gBAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACnB,MAAM,YAAY,CAAC,mBAAmB,CACpC,WAAW,EACX,KAAK,CAAC,WAAW,EACjB;wBACE,UAAU,EAAE,KAAK,CAAC,UAAU;qBAC7B,CACF,CAAC;gBACJ,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CACF,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;gBAC/C,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YAEH,OAAO,MAAa,CAAC;QACvB,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAQ,CAAC;IAC9F,CAAC;CACF,CAAC"}