@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/credit-note/schemas.d.ts.map

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

package/dist/tools/credit-note/schemas.js

@@ -0,0 +1,196 @@
+/**
+ * Zod schemas for CreditNote entity
+ *
+ * Credit note schemas for FreshBooks API
+ */
+import { z } from 'zod';
+import { MoneySchema, PaginationMetadataSchema, VisStateSchema } from '../base-tool.js';
+/**
+ * Credit note status enum
+ */
+export const CreditNoteStatusEnum = z.enum([
+    'created',
+    'sent',
+    'applied',
+    'void',
+]);
+/**
+ * Credit note line item schema
+ */
+export const CreditNoteLineSchema = z.object({
+    name: z.string().describe('Line item description'),
+    description: z.string().optional().describe('Detailed description'),
+    taxName1: z.string().nullable().optional().describe('First tax name'),
+    taxAmount1: z.string().nullable().optional().describe('First tax amount'),
+    taxName2: z.string().nullable().optional().describe('Second tax name'),
+    taxAmount2: z.string().nullable().optional().describe('Second tax amount'),
+    quantity: z.number().optional().describe('Quantity'),
+    unitCost: MoneySchema.optional().describe('Unit cost'),
+    amount: MoneySchema.describe('Line total amount'),
+});
+/**
+ * Full CreditNote schema with all properties
+ * NOTE: Field names and types match the FreshBooks SDK CreditNote model
+ */
+export const CreditNoteSchema = z.object({
+    id: z.number().optional().describe('Unique credit note identifier'),
+    creditId: z.number().optional().describe('Alternate credit note identifier'),
+    creditNumber: z.string().optional().describe('Credit note number'),
+    // Legacy field name - some API responses may use this
+    creditNoteNumber: z.string().optional().describe('Credit note number (alternate)'),
+    clientId: z.union([z.string(), z.number()]).optional().describe('Client receiving credit'),
+    createDate: z.any().optional().describe('Creation date'),
+    amount: MoneySchema.optional().describe('Total credit amount'),
+    currencyCode: z.string().optional().describe('Currency code (e.g., USD)'),
+    status: CreditNoteStatusEnum.optional().describe('Credit note status'),
+    lines: z.array(CreditNoteLineSchema).optional().describe('Credit note line items'),
+    notes: z.string().nullable().optional().describe('Internal notes'),
+    terms: z.string().nullable().optional().describe('Terms and conditions'),
+    language: z.string().optional().describe('Language code'),
+    displayStatus: z.string().optional().describe('Display-friendly status'),
+    disputeStatus: z.string().nullable().optional().describe('Dispute status'),
+    organization: z.string().optional().describe('Client organization'),
+    currentOrganization: z.string().optional().describe('Current organization name'),
+    fName: z.string().optional().describe('Client first name'),
+    lName: z.string().optional().describe('Client last name'),
+    email: z.string().optional().describe('Client email'),
+    street: z.string().optional().describe('Client street address'),
+    street2: z.string().optional().describe('Client street address line 2'),
+    city: z.string().optional().describe('Client city'),
+    province: z.string().optional().describe('Client province/state'),
+    code: z.string().optional().describe('Client postal code'),
+    country: z.string().optional().describe('Client country'),
+    visState: VisStateSchema.optional().describe('Visibility state (0=active, 1=deleted)'),
+    paid: MoneySchema.optional().describe('Amount already applied'),
+    paymentStatus: z.string().optional().describe('Payment status'),
+    description: z.string().optional().describe('Credit note description'),
+    accountingSystemId: z.string().optional().describe('Accounting system ID'),
+}).passthrough();
+/**
+ * Input schema for creating a credit note
+ */
+export const CreditNoteCreateInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    clientId: z.number().describe('Client to credit (required)'),
+    // Accept both "YYYY-MM-DD" and full ISO datetime formats
+    createDate: z.string().describe('Credit note date (YYYY-MM-DD or ISO 8601)').transform((val) => {
+        if (/^\d{4}-\d{2}-\d{2}$/.test(val)) {
+            return `${val}T00:00:00Z`;
+        }
+        return val;
+    }),
+    currencyCode: z.string().default('USD').optional().describe('Currency code (e.g., USD)'),
+    lines: z.array(z.object({
+        name: z.string().describe('Line item description'),
+        description: z.string().optional().describe('Detailed description'),
+        quantity: z.number().default(1).optional().describe('Quantity'),
+        unitCost: z.object({
+            amount: z.string().describe('Unit cost amount'),
+            code: z.string().describe('Currency code'),
+        }).optional().describe('Unit cost'),
+        amount: z.object({
+            amount: z.string().describe('Line total amount'),
+            code: z.string().describe('Currency code'),
+        }).describe('Line total'),
+    })).min(1).describe('Credit note line items (at least one required)'),
+    notes: z.string().optional().describe('Internal notes'),
+    terms: z.string().optional().describe('Terms and conditions'),
+    language: z.string().optional().describe('Language code (e.g., en)'),
+});
+/**
+ * Input schema for updating a credit note
+ */
+export const CreditNoteUpdateInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    creditNoteId: z.number().describe('Credit note ID to update'),
+    // Accept both "YYYY-MM-DD" and full ISO datetime formats
+    createDate: z.string().optional().describe('Credit note date (YYYY-MM-DD or ISO 8601)').transform((val) => {
+        if (!val)
+            return val;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(val)) {
+            return `${val}T00:00:00Z`;
+        }
+        return val;
+    }),
+    lines: z.array(z.object({
+        name: z.string().describe('Line item description'),
+        description: z.string().optional().describe('Detailed description'),
+        quantity: z.number().optional().describe('Quantity'),
+        unitCost: z.object({
+            amount: z.string().describe('Unit cost amount'),
+            code: z.string().describe('Currency code'),
+        }).optional().describe('Unit cost'),
+        amount: z.object({
+            amount: z.string().describe('Line total amount'),
+            code: z.string().describe('Currency code'),
+        }).describe('Line total'),
+    })).optional().describe('Updated credit note line items'),
+    notes: z.string().optional().describe('Internal notes'),
+    terms: z.string().optional().describe('Terms and conditions'),
+});
+/**
+ * Input schema for listing credit notes
+ */
+export const CreditNoteListInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    page: z.number().int().min(1).default(1).optional().describe('Page number (1-indexed)'),
+    perPage: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(30)
+        .optional()
+        .describe('Number of results per page (max 100)'),
+    clientId: z.number().optional().describe('Filter by client ID'),
+    status: CreditNoteStatusEnum.optional().describe('Filter by status'),
+    dateFrom: z.string().optional().describe('Filter credit notes after date (YYYY-MM-DD or ISO 8601)').transform((val) => {
+        if (!val)
+            return val;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(val)) {
+            return `${val}T00:00:00Z`;
+        }
+        return val;
+    }),
+    dateTo: z.string().optional().describe('Filter credit notes before date (YYYY-MM-DD or ISO 8601)').transform((val) => {
+        if (!val)
+            return val;
+        if (/^\d{4}-\d{2}-\d{2}$/.test(val)) {
+            return `${val}T23:59:59Z`;
+        }
+        return val;
+    }),
+});
+/**
+ * Input schema for getting a single credit note
+ */
+export const CreditNoteSingleInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    creditNoteId: z.number().describe('Credit note ID to retrieve'),
+});
+/**
+ * Input schema for deleting a credit note
+ */
+export const CreditNoteDeleteInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    creditNoteId: z.number().describe('Credit note ID to delete'),
+});
+/**
+ * Output schema for credit note list
+ */
+export const CreditNoteListOutputSchema = z.object({
+    creditNotes: z.array(CreditNoteSchema).describe('Array of credit notes'),
+    pagination: PaginationMetadataSchema.describe('Pagination information'),
+});
+/**
+ * Output schema for single credit note operations
+ */
+export const CreditNoteSingleOutputSchema = CreditNoteSchema;
+/**
+ * Output schema for credit note deletion
+ */
+export const CreditNoteDeleteOutputSchema = z.object({
+    success: z.boolean().describe('Whether deletion was successful'),
+    creditNoteId: z.number().describe('ID of deleted credit note'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/credit-note/schemas.js.map

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

package/dist/tools/expense/expense-create.d.ts

@@ -0,0 +1,196 @@
+/**
+ * expense_create Tool
+ *
+ * Create a new business expense in FreshBooks.
+ */
+import { z } from 'zod';
+import { ExpenseCreateInputSchema, ExpenseSingleOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for expense_create
+ */
+export declare const expenseCreateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        categoryId: z.ZodNumber;
+        staffId: z.ZodNumber;
+        date: z.ZodString;
+        amount: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        vendor: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodOptional<z.ZodNumber>;
+        projectId: z.ZodOptional<z.ZodNumber>;
+        markupPercent: z.ZodOptional<z.ZodNumber>;
+        taxName1: z.ZodOptional<z.ZodString>;
+        taxPercent1: z.ZodOptional<z.ZodString>;
+        taxName2: z.ZodOptional<z.ZodString>;
+        taxPercent2: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        date: string;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        categoryId: number;
+        staffId: number;
+        clientId?: number | undefined;
+        projectId?: number | undefined;
+        taxName1?: string | undefined;
+        taxName2?: string | undefined;
+        notes?: string | undefined;
+        vendor?: string | undefined;
+        markupPercent?: number | undefined;
+        taxPercent1?: string | undefined;
+        taxPercent2?: string | undefined;
+    }, {
+        accountId: string;
+        date: string;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        categoryId: number;
+        staffId: number;
+        clientId?: number | undefined;
+        projectId?: number | undefined;
+        taxName1?: string | undefined;
+        taxName2?: string | undefined;
+        notes?: string | undefined;
+        vendor?: string | undefined;
+        markupPercent?: number | undefined;
+        taxPercent1?: string | undefined;
+        taxPercent2?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        expenseId: z.ZodOptional<z.ZodNumber>;
+        categoryId: z.ZodNumber;
+        staffId: z.ZodNumber;
+        date: z.ZodString;
+        amount: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        vendor: z.ZodNullable<z.ZodString>;
+        notes: z.ZodString;
+        clientId: z.ZodOptional<z.ZodNumber>;
+        projectId: z.ZodOptional<z.ZodNumber>;
+        invoiceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        status: z.ZodOptional<z.ZodEnum<["outstanding", "invoiced", "partial", "paid"]>>;
+        hasReceipt: z.ZodOptional<z.ZodBoolean>;
+        markupPercent: z.ZodOptional<z.ZodNumber>;
+        taxName1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taxPercent1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taxAmount1: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>>;
+        taxName2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taxPercent2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        taxAmount2: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        updated: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        date: string;
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        notes: string;
+        categoryId: number;
+        staffId: number;
+        vendor: string | null;
+        status?: "partial" | "outstanding" | "paid" | "invoiced" | undefined;
+        clientId?: number | undefined;
+        projectId?: number | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+        updated?: string | undefined;
+        taxName1?: string | null | undefined;
+        taxAmount1?: {
+            code: string;
+            amount: string;
+        } | null | undefined;
+        taxName2?: string | null | undefined;
+        taxAmount2?: {
+            code: string;
+            amount: string;
+        } | null | undefined;
+        invoiceId?: number | null | undefined;
+        expenseId?: number | undefined;
+        hasReceipt?: boolean | undefined;
+        markupPercent?: number | undefined;
+        taxPercent1?: string | null | undefined;
+        taxPercent2?: string | null | undefined;
+    }, {
+        date: string;
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        notes: string;
+        categoryId: number;
+        staffId: number;
+        vendor: string | null;
+        status?: "partial" | "outstanding" | "paid" | "invoiced" | undefined;
+        clientId?: number | undefined;
+        projectId?: number | undefined;
+        visState?: 0 | 1 | 2 | undefined;
+        updated?: string | undefined;
+        taxName1?: string | null | undefined;
+        taxAmount1?: {
+            code: string;
+            amount: string;
+        } | null | undefined;
+        taxName2?: string | null | undefined;
+        taxAmount2?: {
+            code: string;
+            amount: string;
+        } | null | undefined;
+        invoiceId?: number | null | undefined;
+        expenseId?: number | undefined;
+        hasReceipt?: boolean | undefined;
+        markupPercent?: number | undefined;
+        taxPercent1?: string | null | undefined;
+        taxPercent2?: string | null | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof ExpenseCreateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ExpenseSingleOutputSchema>>;
+};
+//# sourceMappingURL=expense-create.d.ts.map

package/dist/tools/expense/expense-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expense-create.d.ts","sourceRoot":"","sources":["../../../src/tools/expense/expense-create.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;AAKhE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsC5B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CA6DtD,CAAC"}

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

@@ -0,0 +1,103 @@
+/**
+ * expense_create Tool
+ *
+ * Create a new business expense in FreshBooks.
+ */
+import { ExpenseCreateInputSchema, ExpenseSingleOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Tool definition for expense_create
+ */
+export const expenseCreateTool = {
+    name: 'expense_create',
+    description: `Create a new business expense in FreshBooks.
+
+WHEN TO USE:
+- User wants to record a business expense
+- User says "add expense", "create expense", "log expense"
+- Recording receipts or vendor payments
+- Tracking billable client expenses
+
+REQUIRED:
+- accountId: FreshBooks account ID (get from auth_status if not specified)
+- categoryId: Expense category (use expensecategory_list to see options)
+- staffId: Staff member who incurred the expense
+- date: When the expense occurred (ISO 8601 format)
+- amount: Expense amount with currency code
+
+OPTIONAL BUT HELPFUL:
+- vendor: Who was paid (vendor/merchant name)
+- notes: What the expense was for
+- clientId: Client to bill (makes expense billable)
+- projectId: Associated project (for project expense tracking)
+- markupPercent: Markup percentage when billing to client (0-100)
+- taxName1/taxPercent1: First tax (e.g., "GST", "5")
+- taxName2/taxPercent2: Second tax (e.g., "PST", "7")
+
+EXAMPLE PROMPTS:
+- "Add a $150 office supplies expense from Staples"
+- "Record a $500 travel expense for client project Alpha"
+- "Create an expense: $85 for software subscription, category 12"
+- "Log a client lunch expense for $67.50 with 15% tax"
+
+RETURNS:
+Created expense with ID and all details.`,
+    inputSchema: ExpenseCreateInputSchema,
+    outputSchema: ExpenseSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('expense_create', async (input, _context) => {
+            const { accountId, ...expenseData } = input;
+            logger.debug('Creating expense', {
+                accountId,
+                categoryId: expenseData.categoryId,
+                amount: expenseData.amount,
+            });
+            // Build expense object using camelCase properties
+            // The FreshBooks SDK's transformExpenseRequest() will convert to API format
+            const expense = {
+                categoryId: expenseData.categoryId,
+                staffId: expenseData.staffId,
+                date: expenseData.date,
+                amount: expenseData.amount,
+            };
+            // Add optional fields if provided
+            if (expenseData.vendor !== undefined)
+                expense.vendor = expenseData.vendor;
+            if (expenseData.notes !== undefined)
+                expense.notes = expenseData.notes;
+            if (expenseData.clientId !== undefined)
+                expense.clientId = expenseData.clientId;
+            if (expenseData.projectId !== undefined)
+                expense.projectId = expenseData.projectId;
+            if (expenseData.markupPercent !== undefined)
+                expense.markupPercent = expenseData.markupPercent;
+            if (expenseData.taxName1 !== undefined)
+                expense.taxName1 = expenseData.taxName1;
+            if (expenseData.taxPercent1 !== undefined)
+                expense.taxPercent1 = expenseData.taxPercent1;
+            if (expenseData.taxName2 !== undefined)
+                expense.taxName2 = expenseData.taxName2;
+            if (expenseData.taxPercent2 !== undefined)
+                expense.taxPercent2 = expenseData.taxPercent2;
+            const result = await client.executeWithRetry('expense_create', async (fbClient) => {
+                const response = await fbClient.expenses.create(expense, accountId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { expense: { ... } }
+            const createdExpense = result.expense ?? result;
+            logger.info('Expense created successfully', {
+                expenseId: createdExpense.id,
+            });
+            return createdExpense;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=expense-create.js.map

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

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

package/dist/tools/expense/expense-delete.d.ts

@@ -0,0 +1,40 @@
+/**
+ * expense_delete Tool
+ *
+ * Delete an expense from FreshBooks.
+ */
+import { z } from 'zod';
+import { ExpenseDeleteInputSchema, ExpenseDeleteOutputSchema } from './schemas.js';
+import { FreshBooksClientWrapper } from '../../client/index.js';
+/**
+ * Tool definition for expense_delete
+ */
+export declare const expenseDeleteTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        expenseId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        expenseId: number;
+    }, {
+        accountId: string;
+        expenseId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        success: z.ZodBoolean;
+        expenseId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        expenseId: number;
+    }, {
+        success: boolean;
+        expenseId: number;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof ExpenseDeleteInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ExpenseDeleteOutputSchema>>;
+};
+//# sourceMappingURL=expense-delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expense-delete.d.ts","sourceRoot":"","sources":["../../../src/tools/expense/expense-delete.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;AAKhE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;IAmC5B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CAwCtD,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * expense_delete Tool
+ *
+ * Delete an expense from FreshBooks.
+ */
+import { ExpenseDeleteInputSchema, ExpenseDeleteOutputSchema } from './schemas.js';
+import { ErrorHandler } from '../../errors/error-handler.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Tool definition for expense_delete
+ */
+export const expenseDeleteTool = {
+    name: 'expense_delete',
+    description: `Delete an expense from FreshBooks.
+
+WHEN TO USE:
+- User wants to permanently remove an expense
+- User says "delete expense", "remove expense"
+- Expense was entered in error
+- Need to clean up duplicate or test expenses
+
+REQUIRED:
+- accountId: FreshBooks account ID (get from auth_status if not specified)
+- expenseId: ID of expense to delete
+
+IMPORTANT NOTES:
+- Deletion is permanent and cannot be undone
+- Consider using expense_update with visState=2 to archive instead
+- Cannot delete expenses that have been invoiced
+- All associated data (receipts, etc.) will be removed
+
+ALTERNATIVES:
+- Archive: Use expense_update with visState=2 to hide but preserve
+- Mark inactive: Use expense_update with visState=1
+
+EXAMPLE PROMPTS:
+- "Delete expense 12345"
+- "Remove the duplicate expense 67890"
+- "Delete that test expense I just created"
+
+RETURNS:
+Confirmation of successful deletion with the expense ID.`,
+    inputSchema: ExpenseDeleteInputSchema,
+    outputSchema: ExpenseDeleteOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('expense_delete', async (input, _context) => {
+            const { accountId, expenseId } = input;
+            logger.debug('Deleting expense', {
+                accountId,
+                expenseId,
+            });
+            await client.executeWithRetry('expense_delete', async (fbClient) => {
+                const response = await fbClient.expenses.delete(accountId, String(expenseId));
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            logger.info('Expense deleted successfully', {
+                expenseId,
+            });
+            return {
+                success: true,
+                expenseId,
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=expense-delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expense-delete.js","sourceRoot":"","sources":["../../../src/tools/expense/expense-delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEnF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDA4B0C;IAEvD,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB;IAEvC;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAA+C,EAC/C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,gBAAgB,EAChB,KAAK,EACH,KAA+C,EAC/C,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;YAEvC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE;gBAC/B,SAAS;gBACT,SAAS;aACV,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,gBAAgB,CAC3B,gBAAgB,EAChB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;gBAE9E,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,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;gBAC1C,SAAS;aACV,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS;aACV,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}