@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/timer/schemas.d.ts

@@ -0,0 +1,520 @@
+/**
+ * Timer Tool Schemas
+ *
+ * Zod schemas for Timer operations.
+ * Note: Timer is not a standalone resource - it's managed through TimeEntry.
+ */
+import { z } from "zod";
+/**
+ * Base schema for all timer operations
+ * All timer operations require a business ID (since timers use the timeEntries SDK which expects businessId)
+ */
+export declare const TimerBusinessIdSchema: z.ZodObject<{
+    businessId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    businessId: number;
+}, {
+    businessId: number;
+}>;
+/**
+ * Input schema for starting a new timer
+ */
+export declare const TimerStartInputSchema: z.ZodObject<{
+    businessId: z.ZodNumber;
+} & {
+    projectId: z.ZodOptional<z.ZodNumber>;
+    clientId: z.ZodOptional<z.ZodNumber>;
+    serviceId: z.ZodOptional<z.ZodNumber>;
+    taskId: z.ZodOptional<z.ZodNumber>;
+    note: z.ZodOptional<z.ZodString>;
+    billable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    internal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    businessId: number;
+    billable: boolean;
+    internal: boolean;
+    taskId?: number | undefined;
+    clientId?: number | undefined;
+    projectId?: number | undefined;
+    serviceId?: number | undefined;
+    note?: string | undefined;
+}, {
+    businessId: number;
+    taskId?: number | undefined;
+    clientId?: number | undefined;
+    projectId?: number | undefined;
+    serviceId?: number | undefined;
+    note?: string | undefined;
+    billable?: boolean | undefined;
+    internal?: boolean | undefined;
+}>;
+/**
+ * Input schema for stopping a running timer
+ * Note: timerId is preferred. If not provided, will auto-detect from current running timer.
+ */
+export declare const TimerStopInputSchema: 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;
+}>;
+/**
+ * Input schema for getting the current timer
+ * Only requires businessId - will return active timers for the user
+ */
+export declare const TimerCurrentInputSchema: z.ZodObject<{
+    businessId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    businessId: number;
+}, {
+    businessId: number;
+}>;
+/**
+ * Input schema for discarding a timer
+ * Note: timerId is preferred. If not provided, will auto-detect from current timer.
+ */
+export declare const TimerDiscardInputSchema: z.ZodObject<{
+    businessId: z.ZodNumber;
+} & {
+    timerId: z.ZodOptional<z.ZodNumber>;
+    timeEntryId: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    businessId: number;
+    timeEntryId?: number | undefined;
+    timerId?: number | undefined;
+}, {
+    businessId: number;
+    timeEntryId?: number | undefined;
+    timerId?: number | undefined;
+}>;
+/**
+ * Timer object embedded in TimeEntry
+ * This matches the Timer structure from FreshBooks
+ */
+export declare const TimerSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    isRunning: z.ZodNullable<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    isRunning: boolean | null;
+}, {
+    id: number;
+    isRunning: boolean | null;
+}>;
+/**
+ * Time Entry schema (simplified for timer operations)
+ */
+export declare const TimeEntrySchema: 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;
+}>;
+/**
+ * Output schema for timer_start
+ * Returns the created time entry with active timer
+ */
+export declare const TimerStartOutputSchema: 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;
+}>;
+/**
+ * Output schema for timer_stop
+ * Returns the stopped time entry with calculated duration
+ */
+export declare const TimerStopOutputSchema: 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;
+}>;
+/**
+ * Output schema for timer_current
+ * Returns array of active time entries (typically 0 or 1)
+ */
+export declare const TimerCurrentOutputSchema: z.ZodObject<{
+    activeTimers: z.ZodArray<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;
+    }>, "many">;
+    count: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    count: number;
+    activeTimers: {
+        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;
+    }[];
+}, {
+    count: number;
+    activeTimers: {
+        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;
+    }[];
+}>;
+/**
+ * Output schema for timer_discard
+ * Returns confirmation of deletion
+ */
+export declare const TimerDiscardOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    timeEntryId: z.ZodNumber;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    success: boolean;
+    timeEntryId: number;
+}, {
+    message: string;
+    success: boolean;
+    timeEntryId: number;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/timer/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/timer/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;EAI/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;EAAwB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;EAGlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;EAGtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB1B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAkB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAkB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC"}

package/dist/tools/timer/schemas.js

@@ -0,0 +1,109 @@
+/**
+ * Timer Tool Schemas
+ *
+ * Zod schemas for Timer operations.
+ * Note: Timer is not a standalone resource - it's managed through TimeEntry.
+ */
+import { z } from "zod";
+/**
+ * Base schema for all timer operations
+ * All timer operations require a business ID (since timers use the timeEntries SDK which expects businessId)
+ */
+export const TimerBusinessIdSchema = z.object({
+    businessId: z.number().int().positive().describe("FreshBooks business ID (get from user_me -> businessMemberships[].business.id)"),
+});
+/**
+ * Input schema for starting a new timer
+ */
+export const TimerStartInputSchema = TimerBusinessIdSchema.extend({
+    projectId: z.number().optional().describe("Project to associate with timer"),
+    clientId: z.number().optional().describe("Client to associate with timer"),
+    serviceId: z.number().optional().describe("Service/task type being worked on"),
+    taskId: z.number().optional().describe("Specific task being worked on"),
+    note: z.string().optional().describe("Description of work being performed"),
+    billable: z.boolean().optional().default(true).describe("Whether this time is billable"),
+    internal: z.boolean().optional().default(false).describe("Whether this is internal work"),
+});
+/**
+ * Input schema for stopping a running timer
+ * Note: timerId is preferred. If not provided, will auto-detect from current running timer.
+ */
+export const TimerStopInputSchema = TimerBusinessIdSchema.extend({
+    timerId: z.number().optional().describe("ID of the timer to stop (from timer_current -> timerId). If not provided, stops the current running timer."),
+    timeEntryId: z.number().optional().describe("DEPRECATED: Use timerId instead. Kept for backwards compatibility."),
+    note: z.string().optional().describe("Update the note/description before stopping"),
+});
+/**
+ * Input schema for getting the current timer
+ * Only requires businessId - will return active timers for the user
+ */
+export const TimerCurrentInputSchema = TimerBusinessIdSchema;
+/**
+ * Input schema for discarding a timer
+ * Note: timerId is preferred. If not provided, will auto-detect from current timer.
+ */
+export const TimerDiscardInputSchema = TimerBusinessIdSchema.extend({
+    timerId: z.number().optional().describe("ID of the timer to discard (from timer_current -> timerId). If not provided, discards the current timer."),
+    timeEntryId: z.number().optional().describe("DEPRECATED: Use timerId instead. Kept for backwards compatibility."),
+});
+/**
+ * Timer object embedded in TimeEntry
+ * This matches the Timer structure from FreshBooks
+ */
+export const TimerSchema = z.object({
+    id: z.number().describe("Timer ID"),
+    isRunning: z.boolean().nullable().describe("Whether timer is currently running"),
+});
+/**
+ * Time Entry schema (simplified for timer operations)
+ */
+export const TimeEntrySchema = z.object({
+    id: z.number().describe("Time entry ID"),
+    identityId: z.number().optional().describe("User identity ID"),
+    isLogged: z.boolean().describe("Whether time is logged"),
+    startedAt: z.string().describe("When timer started (ISO 8601)"),
+    createdAt: z.string().optional().describe("When entry was created (ISO 8601)"),
+    clientId: z.number().nullable().optional().describe("Associated client ID"),
+    projectId: z.number().nullable().optional().describe("Associated project ID"),
+    taskId: z.number().nullable().optional().describe("Associated task ID"),
+    serviceId: z.number().nullable().optional().describe("Associated service ID"),
+    note: z.string().nullable().optional().describe("Work description"),
+    active: z.boolean().describe("Whether timer is active/running"),
+    billable: z.boolean().optional().describe("Whether time is billable"),
+    billed: z.boolean().optional().describe("Whether time has been billed"),
+    internal: z.boolean().optional().describe("Whether this is internal work"),
+    duration: z.number().describe("Duration in seconds"),
+    timer: TimerSchema.nullable().optional().describe("Active timer object if present"),
+    pendingClient: z.string().nullable().optional().describe("Unconfirmed client name"),
+    pendingProject: z.string().nullable().optional().describe("Unconfirmed project name"),
+    pendingTask: z.string().nullable().optional().describe("Unconfirmed task name"),
+    retainerId: z.number().nullable().optional().describe("Associated retainer ID"),
+});
+/**
+ * Output schema for timer_start
+ * Returns the created time entry with active timer
+ */
+export const TimerStartOutputSchema = TimeEntrySchema;
+/**
+ * Output schema for timer_stop
+ * Returns the stopped time entry with calculated duration
+ */
+export const TimerStopOutputSchema = TimeEntrySchema;
+/**
+ * Output schema for timer_current
+ * Returns array of active time entries (typically 0 or 1)
+ */
+export const TimerCurrentOutputSchema = z.object({
+    activeTimers: z.array(TimeEntrySchema).describe("Currently running timers"),
+    count: z.number().describe("Number of active timers"),
+});
+/**
+ * Output schema for timer_discard
+ * Returns confirmation of deletion
+ */
+export const TimerDiscardOutputSchema = z.object({
+    success: z.boolean().describe("Whether timer was successfully discarded"),
+    timeEntryId: z.number().describe("ID of the discarded time entry"),
+    message: z.string().describe("Confirmation message"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/timer/schemas.js.map

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