bkper 3.8.1 → 4.0.0

package/lib/mcp/tools/get_balances.js

@@ -1,106 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { getBkperInstance } from '../bkper-factory.js';
-import { BalanceType } from 'bkper-js';
-export function handleGetBalances(params) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            // Validate required parameters
-            if (!params.bookId) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: bookId');
-            }
-            if (!params.query) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: query');
-            }
-            // Validate query contains either group: or account: operator
-            if (!params.query.includes('group:') && !params.query.includes('account:')) {
-                throw new McpError(ErrorCode.InvalidParams, 'Query must include either \'group:\' or \'account:\' operator for proper balance filtering. Example: "group:\'Assets\' before:$m" or "account:\'Cash\' before:$m"');
-            }
-            // Get configured Bkper instance
-            const bkper = getBkperInstance();
-            // Get the book first
-            const book = yield bkper.getBook(params.bookId, true);
-            if (!book) {
-                throw new McpError(ErrorCode.InvalidParams, `Book not found: ${params.bookId}`);
-            }
-            // Get balances from the book with query (required by bkper-js)
-            let actualQuery = params.query;
-            // Enforce monthly periodicity by modifying query
-            if (actualQuery.includes('by:d')) {
-                // Replace daily periodicity with monthly
-                actualQuery = actualQuery.replace(/by:d/g, 'by:m');
-            }
-            else if (actualQuery.includes('by:y')) {
-                // Replace yearly periodicity with monthly
-                actualQuery = actualQuery.replace(/by:y/g, 'by:m');
-            }
-            else if (!actualQuery.includes('by:')) {
-                // Append monthly periodicity if no by: operator present
-                actualQuery = actualQuery + ' by:m';
-            }
-            // If by:m is already present, keep it unchanged
-            // Get the first container to access createDataTable
-            const balancesReport = yield book.getBalancesReport(actualQuery);
-            // Determine balance type based on presence of after: operator
-            const type = actualQuery.includes('after:') ? BalanceType.PERIOD : BalanceType.CUMULATIVE;
-            // Use BalancesDataTableBuilder to generate matrix
-            let matrix;
-            // Get the first container to access createDataTable
-            const dataTableBuilder = balancesReport.createDataTable()
-                .formatValues(false) // Raw numbers for LLMs
-                .formatDates(true) // YYYY-MM-DD dates
-                .raw(true) // Raw balances
-                .expanded(4)
-                .type(type); // 
-            matrix = dataTableBuilder.build();
-            // Build response with matrix format
-            const response = {
-                matrix,
-                query: actualQuery
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(response, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            // Re-throw MCP errors as-is
-            if (error instanceof McpError) {
-                throw error;
-            }
-            // Handle other errors
-            throw new McpError(ErrorCode.InternalError, `Failed to get balances: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    });
-}
-export const getBalancesToolDefinition = {
-    name: 'get_balances',
-    description: 'Get account balances with query filtering. Use get_book first to understand group hierarchy and usage rules.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            bookId: {
-                type: 'string',
-                description: 'The unique identifier of the book'
-            },
-            query: {
-                type: 'string',
-                description: 'Required query to filter balances (e.g., "account:\'Cash\'", "group:\'Assets\'", "before:2024-01-31")'
-            }
-        },
-        required: ['bookId', 'query']
-    }
-};
-//# sourceMappingURL=get_balances.js.map

package/lib/mcp/tools/get_balances.js.map

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

package/lib/mcp/tools/get_book.d.ts

@@ -1,21 +0,0 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-interface GetBookParams {
-    bookId: string;
-}
-export declare function handleGetBook(params: GetBookParams): Promise<CallToolResult>;
-export declare const getBookToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            bookId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export {};
-//# sourceMappingURL=get_book.d.ts.map

package/lib/mcp/tools/get_book.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get_book.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get_book.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAC;AAOzF,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAkED,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAqElF;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAajC,CAAC"}

package/lib/mcp/tools/get_book.js

@@ -1,126 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { getBkperInstance } from '../bkper-factory.js';
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-function buildHierarchicalStructure(groups) {
-    const groupMap = new Map();
-    const rootGroups = [];
-    // First pass: create all group nodes
-    groups.forEach(group => {
-        const node = {
-            id: group.getId() || '',
-            name: group.getName() || '',
-            type: group.getType() || '',
-            hidden: group.isHidden() || false,
-            permanent: group.isPermanent() || false,
-            properties: group.getProperties() || {},
-            children: []
-        };
-        groupMap.set(node.id, node);
-    });
-    // Second pass: build hierarchy
-    groups.forEach(group => {
-        const node = groupMap.get(group.getId() || '');
-        if (!node)
-            return;
-        const parent = group.getParent();
-        if (parent) {
-            const parentNode = groupMap.get(parent.getId() || '');
-            if (parentNode) {
-                parentNode.children.push(node);
-            }
-        }
-        else {
-            // No parent = root group
-            rootGroups.push(node);
-        }
-    });
-    return rootGroups;
-}
-function loadSystemPrompt() {
-    try {
-        // Get the directory where this file is located and navigate to the parent mcp directory
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = dirname(__filename);
-        const mcpPath = join(__dirname, '..');
-        const systemPrompt = readFileSync(join(mcpPath, 'system-prompt.md'), 'utf-8');
-        return systemPrompt;
-    }
-    catch (error) {
-        return `# Bkper MCP System Prompt\n\nDocumentation not available.\nError: ${error instanceof Error ? error.message : String(error)}\nPath attempted: ${join(dirname(fileURLToPath(import.meta.url)), '..', 'system-prompt.md')}`;
-    }
-}
-export function handleGetBook(params) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            // Validate required parameters
-            if (!params.bookId) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: bookId');
-            }
-            // Get configured Bkper instance
-            const bkperInstance = getBkperInstance();
-            // Get the specific book
-            const book = yield bkperInstance.getBook(params.bookId, false, true);
-            if (!book) {
-                throw new McpError(ErrorCode.InvalidParams, `Book not found: ${params.bookId}`);
-            }
-            // Get book JSON data
-            const bookJson = book.json();
-            // Get groups from the book
-            const groups = yield book.getGroups();
-            // Build hierarchical structure
-            const hierarchicalGroups = buildHierarchicalStructure(groups || []);
-            bookJson.groups = hierarchicalGroups;
-            // Build response with book data and groups
-            const response = {
-                book: bookJson,
-                readme: loadSystemPrompt()
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(response, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            // Handle specific book not found errors
-            if (error instanceof Error && error.message.includes('not found')) {
-                throw new McpError(ErrorCode.InvalidParams, `Book not found: ${params.bookId}`);
-            }
-            // Re-throw MCP errors as-is
-            if (error instanceof McpError) {
-                throw error;
-            }
-            // Handle other errors
-            throw new McpError(ErrorCode.InternalError, `Failed to get book: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    });
-}
-export const getBookToolDefinition = {
-    name: 'get_book',
-    description: 'Retrieve detailed information about a specific book including its group hierarchy and system prompt',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            bookId: {
-                type: 'string',
-                description: 'The unique identifier of the book to retrieve'
-            }
-        },
-        required: ['bookId']
-    }
-};
-//# sourceMappingURL=get_book.js.map

package/lib/mcp/tools/get_book.js.map

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

package/lib/mcp/tools/list_books.d.ts

@@ -1,21 +0,0 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-interface ListBooksParams {
-    filter: string;
-}
-export declare function handleListBooks(params: ListBooksParams): Promise<CallToolResult>;
-export declare const listBooksToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            filter: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export {};
-//# sourceMappingURL=list_books.d.ts.map

package/lib/mcp/tools/list_books.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list_books.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/list_books.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAC;AAGzF,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsBD,wBAAsB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BtF;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;CAanC,CAAC"}

package/lib/mcp/tools/list_books.js

@@ -1,67 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { getBkperInstance } from '../bkper-factory.js';
-function fetchBooks(filter) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // Get configured Bkper instance
-        const bkperInstance = getBkperInstance();
-        // Get books using high-level wrapper with required filter
-        const bkperBooks = yield bkperInstance.getBooks(filter);
-        // Return full book JSON data - no filtering, no transforming
-        const books = bkperBooks.map((book) => book.json());
-        const total = books.length;
-        return { books, total };
-    });
-}
-export function handleListBooks(params) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            // Fetch all books with required filter
-            const { books, total } = yield fetchBooks(params.filter);
-            // Build response
-            const response = {
-                total,
-                books
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(response, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            // Re-throw MCP errors as-is
-            if (error instanceof McpError) {
-                throw error;
-            }
-            // Handle other errors
-            throw new McpError(ErrorCode.InternalError, `Failed to list books: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    });
-}
-export const listBooksToolDefinition = {
-    name: 'list_books',
-    description: 'List books with mandatory filtering by name or property',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            filter: {
-                type: 'string',
-                description: 'Required filter to search books by name or property (case-insensitive substring match)'
-            }
-        },
-        required: ['filter']
-    }
-};
-//# sourceMappingURL=list_books.js.map

package/lib/mcp/tools/list_books.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"list_books.js","sourceRoot":"","sources":["../../../src/mcp/tools/list_books.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAkB,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAWvD,SAAe,UAAU,CAAC,MAAc;;QACtC,gCAAgC;QAChC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;QAEzC,0DAA0D;QAC1D,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAExD,6DAA6D;QAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAEzD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;QAE3B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;CAAA;AAED,MAAM,UAAgB,eAAe,CAAC,MAAuB;;QAC3D,IAAI,CAAC;YACH,uCAAuC;YACvC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAEzD,iBAAiB;YACjB,MAAM,QAAQ,GAAkB;gBAC9B,KAAK;gBACL,KAAK;aACN,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,4BAA4B;YAC5B,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,sBAAsB;YACtB,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClF,CAAC;QACJ,CAAC;IACH,CAAC;CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,yDAAyD;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wFAAwF;aACtG;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC"}

package/lib/mcp/tools/list_transactions.d.ts

@@ -1,38 +0,0 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-interface ListTransactionsParams {
-    bookId: string;
-    cursor?: string;
-    query: string;
-    limit?: number;
-}
-export declare function handleListTransactions(params: ListTransactionsParams): Promise<CallToolResult>;
-export declare const listTransactionsToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            bookId: {
-                type: string;
-                description: string;
-            };
-            cursor: {
-                type: string;
-                description: string;
-            };
-            query: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                description: string;
-                minimum: number;
-                maximum: number;
-            };
-        };
-        required: string[];
-    };
-};
-export {};
-//# sourceMappingURL=list_transactions.d.ts.map

package/lib/mcp/tools/list_transactions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list_transactions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/list_transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAC;AAGzF,UAAU,sBAAsB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuFpG;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B1C,CAAC"}

package/lib/mcp/tools/list_transactions.js

@@ -1,109 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { getBkperInstance } from '../bkper-factory.js';
-export function handleListTransactions(params) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            // Validate required parameters
-            if (!params.bookId) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: bookId');
-            }
-            if (!params.query) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: query');
-            }
-            // Get configured Bkper instance
-            const bkperInstance = getBkperInstance();
-            // Get the book first
-            const book = yield bkperInstance.getBook(params.bookId);
-            if (!book) {
-                throw new McpError(ErrorCode.InvalidParams, `Book not found: ${params.bookId}`);
-            }
-            // Set up pagination parameters
-            const limit = Math.min(params.limit || 25, 100); // Default 25, max 100
-            // Get transactions using native API pagination
-            const transactionList = yield book.listTransactions(params.query, limit, params.cursor);
-            // Get transactions from list
-            const transactionItems = transactionList.getItems();
-            const transactions = transactionItems.map((transaction) => {
-                const _a = transaction.json(), { agentId, agentName, agentLogo, agentLogoDark, createdAt, createdBy, updatedAt, dateValue } = _a, cleanTransaction = __rest(_a, ["agentId", "agentName", "agentLogo", "agentLogoDark", "createdAt", "createdBy", "updatedAt", "dateValue"]);
-                return cleanTransaction;
-            });
-            // Get pagination info from list
-            const hasMore = transactionItems.length > 0;
-            const nextCursor = transactionList.getCursor() || null;
-            // Build response
-            const response = {
-                transactions,
-                hasMore,
-                cursor: nextCursor,
-                limit
-            };
-            // Include query in response (now always provided)
-            response.query = params.query;
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(response, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            // Re-throw MCP errors as-is
-            if (error instanceof McpError) {
-                throw error;
-            }
-            // Handle other errors
-            throw new McpError(ErrorCode.InternalError, `Failed to list transactions: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    });
-}
-export const listTransactionsToolDefinition = {
-    name: 'list_transactions',
-    description: 'List transactions with native API cursor-based pagination and query filtering. Use get_book first to understand query syntax and usage rules.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            bookId: {
-                type: 'string',
-                description: 'The unique identifier of the book'
-            },
-            cursor: {
-                type: 'string',
-                description: 'Pagination cursor for next page (provided by previous response)'
-            },
-            query: {
-                type: 'string',
-                description: 'Required query string to filter transactions using comprehensive syntax (account:, from:, to:, group:, on:, after:, before:, amount:, text search, logical operators, etc.)'
-            },
-            limit: {
-                type: 'number',
-                description: 'Number of transactions per page (default: 25, maximum: 100)',
-                minimum: 1,
-                maximum: 100
-            }
-        },
-        required: ['bookId', 'query']
-    }
-};
-//# sourceMappingURL=list_transactions.js.map

package/lib/mcp/tools/list_transactions.js.map

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

package/lib/mcp/tools/merge_transactions.d.ts

@@ -1,40 +0,0 @@
-/**
- * MCP Tool: merge_transactions
- *
- * Thin adapter that handles MCP protocol concerns (validation, error handling, response formatting)
- * and delegates business logic to the domain layer.
- */
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-/**
- * MCP-specific request parameters
- */
-interface MergeTransactionsParams {
-    bookId: string;
-    transactionId1: string;
-    transactionId2: string;
-}
-export declare function handleMergeTransactions(params: MergeTransactionsParams): Promise<CallToolResult>;
-export declare const mergeTransactionsToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            bookId: {
-                type: string;
-                description: string;
-            };
-            transactionId1: {
-                type: string;
-                description: string;
-            };
-            transactionId2: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export {};
-//# sourceMappingURL=merge_transactions.d.ts.map

package/lib/mcp/tools/merge_transactions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge_transactions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/merge_transactions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAC;AAKzF;;GAEG;AACH,UAAU,uBAAuB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAWD,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC,CA6GtG;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;CAqB3C,CAAC"}