@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/item/item-list.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Item List Tool
+ *
+ * List reusable invoice line items with pagination and optional filtering.
+ */
+import { z } from "zod";
+import { ItemListInputSchema, ItemListOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for item_list
+ */
+export declare const itemListTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        perPage: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        name: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["product", "service", "discount"]>>;
+        sku: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        name?: string | undefined;
+        type?: "service" | "discount" | "product" | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        sku?: string | undefined;
+    }, {
+        accountId: string;
+        name?: string | undefined;
+        type?: "service" | "discount" | "product" | undefined;
+        page?: number | undefined;
+        perPage?: number | undefined;
+        sku?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodNumber;
+            name: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            type: z.ZodEnum<["product", "service", "discount"]>;
+            rate: z.ZodNullable<z.ZodObject<{
+                amount: z.ZodString;
+                code: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                amount: string;
+            }, {
+                code: string;
+                amount: string;
+            }>>;
+            quantity: z.ZodOptional<z.ZodNumber>;
+            taxable: z.ZodBoolean;
+            tax1: z.ZodNullable<z.ZodString>;
+            tax2: z.ZodNullable<z.ZodString>;
+            inventory: z.ZodNullable<z.ZodNumber>;
+            sku: z.ZodNullable<z.ZodString>;
+            accountingSystemId: z.ZodNullable<z.ZodString>;
+            visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string | null;
+            name: string;
+            type: "service" | "discount" | "product";
+            createdAt: string;
+            id: number;
+            rate: {
+                code: string;
+                amount: string;
+            } | null;
+            updatedAt: string;
+            taxable: boolean;
+            tax1: string | null;
+            tax2: string | null;
+            inventory: number | null;
+            sku: string | null;
+            accountingSystemId: string | null;
+            visState?: 0 | 1 | 2 | undefined;
+            quantity?: number | undefined;
+        }, {
+            description: string | null;
+            name: string;
+            type: "service" | "discount" | "product";
+            createdAt: string;
+            id: number;
+            rate: {
+                code: string;
+                amount: string;
+            } | null;
+            updatedAt: string;
+            taxable: boolean;
+            tax1: string | null;
+            tax2: string | null;
+            inventory: number | null;
+            sku: string | null;
+            accountingSystemId: string | null;
+            visState?: 0 | 1 | 2 | undefined;
+            quantity?: number | 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, {
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+        items: {
+            description: string | null;
+            name: string;
+            type: "service" | "discount" | "product";
+            createdAt: string;
+            id: number;
+            rate: {
+                code: string;
+                amount: string;
+            } | null;
+            updatedAt: string;
+            taxable: boolean;
+            tax1: string | null;
+            tax2: string | null;
+            inventory: number | null;
+            sku: string | null;
+            accountingSystemId: string | null;
+            visState?: 0 | 1 | 2 | undefined;
+            quantity?: number | undefined;
+        }[];
+    }, {
+        pagination: {
+            total: number;
+            page: number;
+            perPage: number;
+            pages: number;
+        };
+        items: {
+            description: string | null;
+            name: string;
+            type: "service" | "discount" | "product";
+            createdAt: string;
+            id: number;
+            rate: {
+                code: string;
+                amount: string;
+            } | null;
+            updatedAt: string;
+            taxable: boolean;
+            tax1: string | null;
+            tax2: string | null;
+            inventory: number | null;
+            sku: string | null;
+            accountingSystemId: string | null;
+            visState?: 0 | 1 | 2 | undefined;
+            quantity?: number | undefined;
+        }[];
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof ItemListInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ItemListOutputSchema>>;
+};
+//# sourceMappingURL=item-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"item-list.d.ts","sourceRoot":"","sources":["../../../src/tools/item/item-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgCvB;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,UAClC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;CA2FjD,CAAC"}

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

@@ -0,0 +1,112 @@
+/**
+ * Item List Tool
+ *
+ * List reusable invoice line items with pagination and optional filtering.
+ */
+import { ItemListInputSchema, ItemListOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for item_list
+ */
+export const itemListTool = {
+    name: "item_list",
+    description: `List reusable invoice line items from FreshBooks with optional filtering and pagination.
+
+WHEN TO USE:
+- User asks to "see items", "list products", "show services"
+- User wants to find items for invoice creation
+- User needs to see available products or services
+
+FILTERING OPTIONS:
+- name: Search by item name (partial match)
+- type: Filter by type (product, service, discount)
+- sku: Filter by stock keeping unit
+
+PAGINATION:
+- Use page/perPage for large result sets
+- Default: 30 results per page
+- Maximum: 100 results per page
+
+EXAMPLE PROMPTS:
+- "Show me all billable items"
+- "List products in inventory"
+- "Find service items"
+- "What items can I add to invoices?"
+
+RETURNS:
+Array of reusable items with names, rates, descriptions, and inventory info.
+Includes pagination metadata for navigating large result sets.`,
+    inputSchema: ItemListInputSchema,
+    outputSchema: ItemListOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('item_list', async (input, _context) => {
+            const { accountId, page, perPage, ...filters } = input;
+            logger.debug('Listing items', {
+                accountId,
+                page,
+                perPage,
+                filters,
+            });
+            const result = await client.executeWithRetry('item_list', async (fbClient) => {
+                // Import query builders from SDK
+                const { SearchQueryBuilder, 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()
+                        .page(page || 1)
+                        .perPage(perPage || 30);
+                    queryBuilders.push(pagination);
+                }
+                // Add search filters if any specified
+                if (Object.keys(filters).length > 0) {
+                    const search = new SearchQueryBuilder();
+                    if (filters.name !== undefined) {
+                        search.like("name", filters.name);
+                    }
+                    if (filters.type !== undefined) {
+                        search.equals("type", filters.type);
+                    }
+                    if (filters.sku !== undefined) {
+                        search.equals("sku", filters.sku);
+                    }
+                    queryBuilders.push(search);
+                }
+                // Call FreshBooks API
+                const response = await fbClient.items.list(accountId, queryBuilders);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                const data = response.data;
+                const items = data.items || [];
+                const paginationData = data.pages || {
+                    page: 1,
+                    pages: 1,
+                    total: items.length,
+                    per_page: 30,
+                };
+                return {
+                    items,
+                    pagination: {
+                        page: paginationData.page,
+                        pages: paginationData.pages,
+                        perPage: paginationData.per_page || paginationData.perPage || 30,
+                        total: paginationData.total,
+                    },
+                };
+            });
+            logger.info('Items listed successfully', {
+                count: result.items.length,
+                total: result.pagination.total,
+            });
+            return result;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=item-list.js.map

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

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

package/dist/tools/item/item-single.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Item Single Tool
+ *
+ * Retrieve a single item by ID.
+ */
+import { z } from "zod";
+import { ItemSingleInputSchema, ItemSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for item_single
+ */
+export declare const itemSingleTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        itemId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        itemId: number;
+    }, {
+        accountId: string;
+        itemId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        type: z.ZodEnum<["product", "service", "discount"]>;
+        rate: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        quantity: z.ZodOptional<z.ZodNumber>;
+        taxable: z.ZodBoolean;
+        tax1: z.ZodNullable<z.ZodString>;
+        tax2: z.ZodNullable<z.ZodString>;
+        inventory: z.ZodNullable<z.ZodNumber>;
+        sku: z.ZodNullable<z.ZodString>;
+        accountingSystemId: z.ZodNullable<z.ZodString>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string | null;
+        name: string;
+        type: "service" | "discount" | "product";
+        createdAt: string;
+        id: number;
+        rate: {
+            code: string;
+            amount: string;
+        } | null;
+        updatedAt: string;
+        taxable: boolean;
+        tax1: string | null;
+        tax2: string | null;
+        inventory: number | null;
+        sku: string | null;
+        accountingSystemId: string | null;
+        visState?: 0 | 1 | 2 | undefined;
+        quantity?: number | undefined;
+    }, {
+        description: string | null;
+        name: string;
+        type: "service" | "discount" | "product";
+        createdAt: string;
+        id: number;
+        rate: {
+            code: string;
+            amount: string;
+        } | null;
+        updatedAt: string;
+        taxable: boolean;
+        tax1: string | null;
+        tax2: string | null;
+        inventory: number | null;
+        sku: string | null;
+        accountingSystemId: string | null;
+        visState?: 0 | 1 | 2 | undefined;
+        quantity?: number | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof ItemSingleInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ItemSingleOutputSchema>>;
+};
+//# sourceMappingURL=item-single.d.ts.map

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * Item Single Tool
+ *
+ * Retrieve a single item by ID.
+ */
+import { ItemSingleInputSchema, ItemSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for item_single
+ */
+export const itemSingleTool = {
+    name: "item_single",
+    description: `Retrieve a single reusable item by ID from FreshBooks.
+
+WHEN TO USE:
+- User asks for details about a specific item
+- User references an item ID or SKU
+- User wants to see full item information before adding to invoice
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- itemId: The specific item ID to retrieve
+
+EXAMPLE PROMPTS:
+- "Show me item 12345"
+- "Get details for that product"
+- "What's the rate for item #PROD-001?"
+
+RETURNS:
+Complete item details including name, description, rate, type, inventory,
+SKU, and tax settings.`,
+    inputSchema: ItemSingleInputSchema,
+    outputSchema: ItemSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('item_single', async (input, _context) => {
+            const { accountId, itemId } = input;
+            logger.debug('Retrieving item', {
+                accountId,
+                itemId,
+            });
+            const result = await client.executeWithRetry('item_single', async (fbClient) => {
+                const response = await fbClient.items.single(accountId, String(itemId));
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { item: { ... } }
+            const item = result.item ?? result;
+            logger.info('Item retrieved successfully', {
+                itemId,
+            });
+            return item;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=item-single.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"item-single.js","sourceRoot":"","sources":["../../../src/tools/item/item-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;;;;;;;uBAkBQ;IAErB,WAAW,EAAE,qBAAqB;IAClC,YAAY,EAAE,sBAAsB;IAEpC;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAA4C,EAC5C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,aAAa,EACb,KAAK,EACH,KAA4C,EAC5C,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;YAEpC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;gBAC9B,SAAS;gBACT,MAAM;aACP,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,aAAa,EACb,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBAExE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CACF,CAAC;YAEF,wCAAwC;YACxC,MAAM,IAAI,GAAI,MAA6B,CAAC,IAAI,IAAI,MAAM,CAAC;YAE3D,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACzC,MAAM;aACP,CAAC,CAAC;YAEH,OAAO,IAA8C,CAAC;QACxD,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/item/item-update.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Item Update Tool
+ *
+ * Update an existing reusable invoice line item in FreshBooks.
+ */
+import { z } from "zod";
+import { ItemUpdateInputSchema, ItemSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for item_update
+ */
+export declare const itemUpdateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        itemId: z.ZodNumber;
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["product", "service", "discount"]>>;
+        rate: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        quantity: z.ZodOptional<z.ZodNumber>;
+        taxable: z.ZodOptional<z.ZodBoolean>;
+        tax1: z.ZodOptional<z.ZodString>;
+        tax2: z.ZodOptional<z.ZodString>;
+        inventory: z.ZodOptional<z.ZodNumber>;
+        sku: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        itemId: number;
+        description?: string | undefined;
+        name?: string | undefined;
+        type?: "service" | "discount" | "product" | undefined;
+        rate?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        quantity?: number | undefined;
+        taxable?: boolean | undefined;
+        tax1?: string | undefined;
+        tax2?: string | undefined;
+        inventory?: number | undefined;
+        sku?: string | undefined;
+    }, {
+        accountId: string;
+        itemId: number;
+        description?: string | undefined;
+        name?: string | undefined;
+        type?: "service" | "discount" | "product" | undefined;
+        rate?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        quantity?: number | undefined;
+        taxable?: boolean | undefined;
+        tax1?: string | undefined;
+        tax2?: string | undefined;
+        inventory?: number | undefined;
+        sku?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        type: z.ZodEnum<["product", "service", "discount"]>;
+        rate: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        quantity: z.ZodOptional<z.ZodNumber>;
+        taxable: z.ZodBoolean;
+        tax1: z.ZodNullable<z.ZodString>;
+        tax2: z.ZodNullable<z.ZodString>;
+        inventory: z.ZodNullable<z.ZodNumber>;
+        sku: z.ZodNullable<z.ZodString>;
+        accountingSystemId: z.ZodNullable<z.ZodString>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string | null;
+        name: string;
+        type: "service" | "discount" | "product";
+        createdAt: string;
+        id: number;
+        rate: {
+            code: string;
+            amount: string;
+        } | null;
+        updatedAt: string;
+        taxable: boolean;
+        tax1: string | null;
+        tax2: string | null;
+        inventory: number | null;
+        sku: string | null;
+        accountingSystemId: string | null;
+        visState?: 0 | 1 | 2 | undefined;
+        quantity?: number | undefined;
+    }, {
+        description: string | null;
+        name: string;
+        type: "service" | "discount" | "product";
+        createdAt: string;
+        id: number;
+        rate: {
+            code: string;
+            amount: string;
+        } | null;
+        updatedAt: string;
+        taxable: boolean;
+        tax1: string | null;
+        tax2: string | null;
+        inventory: number | null;
+        sku: string | null;
+        accountingSystemId: string | null;
+        visState?: 0 | 1 | 2 | undefined;
+        quantity?: number | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof ItemUpdateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ItemSingleOutputSchema>>;
+};
+//# sourceMappingURL=item-update.d.ts.map

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

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

package/dist/tools/item/item-update.js

@@ -0,0 +1,74 @@
+/**
+ * Item Update Tool
+ *
+ * Update an existing reusable invoice line item in FreshBooks.
+ */
+import { ItemUpdateInputSchema, ItemSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for item_update
+ */
+export const itemUpdateTool = {
+    name: "item_update",
+    description: `Update an existing reusable invoice line item in FreshBooks.
+
+WHEN TO USE:
+- User wants to update item pricing or details
+- Item description or rate needs to be changed
+- Inventory quantities need updating
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- itemId: The item ID to update
+
+OPTIONAL (at least one should be provided):
+- name: Updated item name/description
+- description: Updated detailed description
+- type: Updated item type
+- rate: Updated unit price
+- quantity: Updated default quantity
+- taxable: Updated taxable status
+- tax1, tax2: Updated tax names
+- inventory: Updated inventory quantity
+- sku: Updated SKU
+
+EXAMPLE PROMPTS:
+- "Update item 123 to $175/hour"
+- "Change the description for item 'Consulting'"
+- "Increase inventory for item #PROD-001 to 50 units"
+- "Update SKU for item 456"
+
+RETURNS:
+Updated item with all current details.`,
+    inputSchema: ItemUpdateInputSchema,
+    outputSchema: ItemSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('item_update', async (input, _context) => {
+            const { accountId, itemId, ...updateData } = input;
+            logger.debug('Updating item', {
+                accountId,
+                itemId,
+                fields: Object.keys(updateData),
+            });
+            const result = await client.executeWithRetry('item_update', async (fbClient) => {
+                const response = await fbClient.items.update(accountId, String(itemId), updateData);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { item: { ... } }
+            const updatedItem = result.item ?? result;
+            logger.info('Item updated successfully', {
+                itemId,
+            });
+            return updatedItem;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=item-update.js.map