@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/server.js

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+/**
+ * FreshBooks MCP Server
+ *
+ * Main entry point for the FreshBooks Model Context Protocol server.
+ * Provides Claude with access to FreshBooks time tracking, invoicing,
+ * expense management, and more through MCP tools.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { getConfig } from './config/index.js';
+import { logger } from './utils/logger.js';
+import { FreshBooksOAuth } from './auth/oauth.js';
+import { EncryptedFileTokenStore } from './auth/token-store.js';
+import { FreshBooksClientWrapper } from './client/index.js';
+import { handleError, createAuthError } from './errors/index.js';
+/**
+ * Main server class
+ */
+class FreshBooksServer {
+    server;
+    oauth;
+    client;
+    constructor() {
+        // Initialize MCP server
+        this.server = new Server({
+            name: 'freshbooks-mcp',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Load configuration
+        const config = getConfig();
+        // Initialize OAuth and client
+        const tokenStore = new EncryptedFileTokenStore(config.server.tokenStorePath);
+        this.oauth = new FreshBooksOAuth({
+            clientId: config.freshbooks.clientId,
+            clientSecret: config.freshbooks.clientSecret,
+            redirectUri: config.freshbooks.redirectUri,
+        }, tokenStore);
+        this.client = new FreshBooksClientWrapper(this.oauth);
+        // Set up handlers
+        this.setupHandlers();
+        logger.info('FreshBooks MCP Server initialized', {
+            serverName: 'freshbooks-mcp',
+            version: '1.0.0',
+        });
+    }
+    /**
+     * Set up MCP protocol handlers
+     */
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            logger.debug('Listing available tools');
+            return {
+                tools: [
+                    // Authentication tools
+                    {
+                        name: 'auth_status',
+                        description: 'Check current FreshBooks authentication status',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {},
+                        },
+                    },
+                    {
+                        name: 'auth_get_url',
+                        description: 'Get OAuth authorization URL to authenticate with FreshBooks',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {},
+                        },
+                    },
+                    {
+                        name: 'auth_exchange_code',
+                        description: 'Exchange OAuth authorization code for access tokens',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                code: {
+                                    type: 'string',
+                                    description: 'Authorization code from OAuth redirect',
+                                },
+                            },
+                            required: ['code'],
+                        },
+                    },
+                    {
+                        name: 'auth_revoke',
+                        description: 'Revoke current authentication and clear tokens',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {},
+                        },
+                    },
+                    // TODO: Additional tools will be registered here by other agents
+                ],
+            };
+        });
+        // Handle tool execution
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            logger.debug('Tool execution requested', {
+                tool: name,
+                hasArgs: !!args,
+            });
+            try {
+                // Route to appropriate tool handler
+                switch (name) {
+                    case 'auth_status':
+                        return await this.handleAuthStatus();
+                    case 'auth_get_url':
+                        return await this.handleAuthGetUrl();
+                    case 'auth_exchange_code':
+                        return await this.handleAuthExchangeCode(args);
+                    case 'auth_revoke':
+                        return await this.handleAuthRevoke();
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                const mcpError = handleError(error, { tool: name });
+                logger.error(`Tool ${name} failed`, error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: {
+                                    code: mcpError.code,
+                                    message: mcpError.message,
+                                    recoverable: mcpError.data.recoverable,
+                                    suggestion: mcpError.data.suggestion,
+                                },
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Handle auth_status tool
+     */
+    async handleAuthStatus() {
+        const status = await this.oauth.getStatus();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(status, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Handle auth_get_url tool
+     */
+    async handleAuthGetUrl() {
+        const url = this.oauth.generateAuthorizationUrl();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        authorizationUrl: url,
+                        instructions: [
+                            '1. Visit the authorization URL in your browser',
+                            '2. Log in to FreshBooks and authorize the application',
+                            '3. Copy the authorization code from the redirect URL',
+                            '4. Call auth_exchange_code with the authorization code',
+                        ],
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Handle auth_exchange_code tool
+     */
+    async handleAuthExchangeCode(args) {
+        if (!args || !args.code) {
+            throw createAuthError('Authorization code is required');
+        }
+        const tokenData = await this.oauth.exchangeCode(args.code);
+        // Set account if provided in token
+        if (tokenData.accountId) {
+            this.client.setAccountId(tokenData.accountId);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: 'Authentication successful',
+                        accountId: tokenData.accountId,
+                        expiresIn: tokenData.expiresAt - Math.floor(Date.now() / 1000),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Handle auth_revoke tool
+     */
+    async handleAuthRevoke() {
+        await this.oauth.revokeToken();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: 'Authentication revoked successfully',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    /**
+     * Start the server
+     */
+    async start() {
+        const transport = new StdioServerTransport();
+        logger.info('Starting FreshBooks MCP server');
+        await this.server.connect(transport);
+        logger.info('FreshBooks MCP server running', {
+            transport: 'stdio',
+        });
+    }
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    try {
+        const server = new FreshBooksServer();
+        await server.start();
+        // Handle graceful shutdown
+        process.on('SIGINT', () => {
+            logger.info('Received SIGINT, shutting down gracefully');
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            logger.info('Received SIGTERM, shutting down gracefully');
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        logger.error('Failed to start server', error);
+        process.exit(1);
+    }
+}
+// Run the server
+main();
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/base-tool.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Base tool utilities and common patterns
+ *
+ * Provides shared schemas, helper functions, and base patterns
+ * for creating consistent MCP tools across all FreshBooks entities.
+ */
+import { z } from 'zod';
+import type { Client } from '@freshbooks/api';
+import { PaginationQueryBuilder, SearchQueryBuilder, IncludesQueryBuilder, SortQueryBuilder, joinQueries, type QueryBuilderType } from '@freshbooks/api/dist/models/builders/index.js';
+/**
+ * Standard account ID schema (required for all FreshBooks operations)
+ */
+export declare const AccountIdSchema: z.ZodObject<{
+    accountId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+}, {
+    accountId: string;
+}>;
+/**
+ * Business ID schema (used for services and some other resources)
+ */
+export declare const BusinessIdSchema: z.ZodObject<{
+    businessId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    businessId: number;
+}, {
+    businessId: number;
+}>;
+/**
+ * Standard pagination schema for list operations
+ */
+export declare const PaginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    perPage: number;
+}, {
+    page?: number | undefined;
+    perPage?: number | undefined;
+}>;
+/**
+ * Standard pagination metadata in responses
+ */
+export declare const PaginationMetadataSchema: 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;
+}>;
+/**
+ * Common visibility state enum
+ */
+export declare const VisStateSchema: z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+/**
+ * Money type (amount + currency code)
+ */
+export declare const MoneySchema: z.ZodObject<{
+    amount: z.ZodString;
+    code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    amount: string;
+}, {
+    code: string;
+    amount: string;
+}>;
+/**
+ * Tool configuration for createTool helper
+ */
+export interface ToolConfig<TInput, TOutput> {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType<TInput>;
+    outputSchema: z.ZodType<TOutput>;
+    handler: (input: TInput, client: Client) => Promise<TOutput>;
+}
+/**
+ * Create a standardized MCP tool with validation and error handling
+ *
+ * @param config Tool configuration
+ * @returns Tool object with name, schema, and handler
+ */
+export declare function createTool<TInput, TOutput>(config: ToolConfig<TInput, TOutput>): {
+    name: string;
+    schema: {
+        description: string;
+        input: z.ZodType<TInput, z.ZodTypeDef, TInput>;
+        output: z.ZodType<TOutput, z.ZodTypeDef, TOutput>;
+    };
+    handler: (input: TInput, client: Client) => Promise<TOutput>;
+};
+/**
+ * Export query builders for use in tools
+ */
+export { PaginationQueryBuilder, SearchQueryBuilder, IncludesQueryBuilder, SortQueryBuilder, joinQueries, type QueryBuilderType, };
+/**
+ * Sort direction enum - used for list operations
+ */
+export declare const SortDirectionSchema: z.ZodEnum<["asc", "desc"]>;
+/**
+ * Generic sort schema factory - creates entity-specific sort schemas
+ */
+export declare function createSortSchema<T extends string>(sortableFields: readonly T[], fieldDescriptions?: Record<T, string>): z.ZodObject<{
+    sortBy: z.ZodOptional<z.ZodEnum<[T, ...T[]]>>;
+    sortOrder: z.ZodOptional<z.ZodDefault<z.ZodEnum<["asc", "desc"]>>>;
+}, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    sortBy: z.ZodOptional<z.ZodEnum<[T, ...T[]]>>;
+    sortOrder: z.ZodOptional<z.ZodDefault<z.ZodEnum<["asc", "desc"]>>>;
+}>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{
+    sortBy: z.ZodOptional<z.ZodEnum<[T, ...T[]]>>;
+    sortOrder: z.ZodOptional<z.ZodDefault<z.ZodEnum<["asc", "desc"]>>>;
+}> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+/**
+ * Generic includes schema factory - creates entity-specific includes schemas
+ */
+export declare function createIncludesSchema<T extends string>(includeOptions: readonly T[], includeDescriptions: Record<T, string>): z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<[T, ...T[]]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    include?: T[] | undefined;
+}, {
+    include?: T[] | undefined;
+}>;
+/**
+ * Helper function to build query builders array with sort and includes
+ */
+export declare function buildQueryBuilders(options: {
+    page?: number | undefined;
+    perPage?: number | undefined;
+    sortBy?: string | undefined;
+    sortOrder?: 'asc' | 'desc' | undefined;
+    include?: string[] | undefined;
+    searchFilters?: ((search: InstanceType<typeof SearchQueryBuilder>) => void) | undefined;
+}): Promise<QueryBuilderType[]>;
+//# sourceMappingURL=base-tool.d.ts.map

package/dist/tools/base-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-tool.d.ts","sourceRoot":"","sources":["../../src/tools/base-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,KAAK,gBAAgB,EACtB,MAAM,+CAA+C,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAS3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,iEAEqC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;EAGtB,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,EAAE,OAAO;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;qCAT5C,MAAM;EAmBxC;AAED;;GAEG;AACH,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,KAAK,gBAAgB,GACtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,4BAE/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,cAAc,EAAE,SAAS,CAAC,EAAE,EAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC;;;;;;;;;kEAkBtC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACnD,cAAc,EAAE,SAAS,CAAC,EAAE,EAC5B,mBAAmB,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC;;;;;;GAYvC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,kBAAkB,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACzF,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA+C9B"}

package/dist/tools/base-tool.js

@@ -0,0 +1,161 @@
+/**
+ * Base tool utilities and common patterns
+ *
+ * Provides shared schemas, helper functions, and base patterns
+ * for creating consistent MCP tools across all FreshBooks entities.
+ */
+import { z } from 'zod';
+import { PaginationQueryBuilder, SearchQueryBuilder, IncludesQueryBuilder, SortQueryBuilder, joinQueries, } from '@freshbooks/api/dist/models/builders/index.js';
+/**
+ * Standard account ID schema (required for all FreshBooks operations)
+ */
+export const AccountIdSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+});
+/**
+ * Business ID schema (used for services and some other resources)
+ */
+export const BusinessIdSchema = z.object({
+    businessId: z.number().int().positive().describe('FreshBooks business ID'),
+});
+/**
+ * Standard pagination schema for list operations
+ */
+export const PaginationSchema = z.object({
+    page: z.number().int().min(1).default(1).describe('Page number (1-indexed)'),
+    perPage: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(30)
+        .describe('Number of results per page (max 100)'),
+});
+/**
+ * Standard pagination metadata in responses
+ */
+export const PaginationMetadataSchema = z.object({
+    page: z.number(),
+    pages: z.number(),
+    perPage: z.number(),
+    total: z.number(),
+});
+/**
+ * Common visibility state enum
+ */
+export const VisStateSchema = z
+    .union([z.literal(0), z.literal(1), z.literal(2)])
+    .describe('Visibility state: 0=active, 1=deleted, 2=archived');
+/**
+ * Money type (amount + currency code)
+ */
+export const MoneySchema = z.object({
+    amount: z.string().describe('Decimal amount as string'),
+    code: z.string().describe('Currency code (e.g., USD)'),
+});
+/**
+ * Create a standardized MCP tool with validation and error handling
+ *
+ * @param config Tool configuration
+ * @returns Tool object with name, schema, and handler
+ */
+export function createTool(config) {
+    return {
+        name: config.name,
+        schema: {
+            description: config.description,
+            input: config.inputSchema,
+            output: config.outputSchema,
+        },
+        handler: config.handler,
+    };
+}
+/**
+ * Export query builders for use in tools
+ */
+export { PaginationQueryBuilder, SearchQueryBuilder, IncludesQueryBuilder, SortQueryBuilder, joinQueries, };
+/**
+ * Sort direction enum - used for list operations
+ */
+export const SortDirectionSchema = z.enum(['asc', 'desc']).describe('Sort direction: asc (ascending, A-Z, oldest first) or desc (descending, Z-A, newest first)');
+/**
+ * Generic sort schema factory - creates entity-specific sort schemas
+ */
+export function createSortSchema(sortableFields, fieldDescriptions) {
+    const fieldEnum = z.enum(sortableFields);
+    return z.object({
+        sortBy: fieldEnum
+            .optional()
+            .describe(`Field to sort by. Options: ${sortableFields.join(', ')}` +
+            (fieldDescriptions
+                ? '. ' + Object.entries(fieldDescriptions).map(([k, v]) => `${k}: ${v}`).join('; ')
+                : '')),
+        sortOrder: SortDirectionSchema
+            .default('desc')
+            .optional()
+            .describe('Sort order (default: desc for newest first)'),
+    });
+}
+/**
+ * Generic includes schema factory - creates entity-specific includes schemas
+ */
+export function createIncludesSchema(includeOptions, includeDescriptions) {
+    return z.object({
+        include: z.array(z.enum(includeOptions))
+            .optional()
+            .describe(`Related resources to include in response. Options:\n` +
+            Object.entries(includeDescriptions)
+                .map(([key, desc]) => `- ${key}: ${desc}`)
+                .join('\n')),
+    });
+}
+/**
+ * Helper function to build query builders array with sort and includes
+ */
+export async function buildQueryBuilders(options) {
+    const queryBuilders = [];
+    // Pagination
+    if (options.page !== undefined || options.perPage !== undefined) {
+        const pagination = new PaginationQueryBuilder();
+        if (options.page)
+            pagination.page(options.page);
+        if (options.perPage)
+            pagination.perPage(options.perPage);
+        queryBuilders.push(pagination);
+    }
+    // Sort
+    if (options.sortBy) {
+        const sort = new SortQueryBuilder();
+        if (options.sortOrder === 'asc') {
+            sort.asc(options.sortBy);
+        }
+        else {
+            sort.desc(options.sortBy);
+        }
+        queryBuilders.push(sort);
+    }
+    // Includes
+    if (options.include && options.include.length > 0) {
+        const includes = new IncludesQueryBuilder();
+        for (const inc of options.include) {
+            includes.includes(inc);
+        }
+        queryBuilders.push(includes);
+    }
+    // Search filters (entity-specific)
+    // The callback is responsible for adding filters to the search builder.
+    // We always add the search builder if a callback is provided, as even
+    // an empty search builder is valid and the callback may conditionally add filters.
+    if (options.searchFilters) {
+        const search = new SearchQueryBuilder();
+        options.searchFilters(search);
+        // Only add if there are actual query parameters
+        // Check if the search builder has any query string content
+        const queryString = search.build();
+        if (queryString && queryString.length > 0) {
+            queryBuilders.push(search);
+        }
+    }
+    return queryBuilders;
+}
+//# sourceMappingURL=base-tool.js.map

package/dist/tools/base-tool.js.map

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

package/dist/tools/bill/bill-archive.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Bill Archive Tool
+ *
+ * Archive a bill in FreshBooks (soft delete).
+ */
+import { z } from "zod";
+import { BillArchiveInputSchema, BillArchiveOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for bill_archive
+ */
+export declare const billArchiveTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        billId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        billId: number;
+    }, {
+        accountId: string;
+        billId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        success: z.ZodBoolean;
+        billId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        billId: number;
+    }, {
+        success: boolean;
+        billId: number;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillArchiveInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillArchiveOutputSchema>>;
+};
+//# sourceMappingURL=bill-archive.d.ts.map

package/dist/tools/bill/bill-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-archive.d.ts","sourceRoot":"","sources":["../../../src/tools/bill/bill-archive.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;IA6B1B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,UACrC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;CAyCpD,CAAC"}