bkper 3.8.0 → 4.0.0

package/lib/mcp/server.js

@@ -1,161 +0,0 @@
-#!/usr/bin/env node
-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 dotenv from 'dotenv';
-dotenv.config();
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from '@modelcontextprotocol/sdk/types.js';
-import { handleGetBook, getBookToolDefinition } from './tools/get_book.js';
-import { handleGetBalances, getBalancesToolDefinition } from './tools/get_balances.js';
-import { handleListTransactions, listTransactionsToolDefinition } from './tools/list_transactions.js';
-import { handleListBooks, listBooksToolDefinition } from './tools/list_books.js';
-import { handleCreateTransactions, createTransactionsToolDefinition } from './tools/create_transactions.js';
-import { handleMergeTransactions, mergeTransactionsToolDefinition } from './tools/merge_transactions.js';
-class BkperMcpServer {
-    constructor() {
-        this.server = new Server({
-            name: 'bkper-mcp-server',
-            version: '1.0.0',
-        }, {
-            capabilities: {
-                tools: {}
-            }
-        });
-        this.setupToolHandlers();
-        this.setupErrorHandling();
-    }
-    setupToolHandlers() {
-        this.server.setRequestHandler(ListToolsRequestSchema, () => __awaiter(this, void 0, void 0, function* () {
-            return {
-                tools: [
-                    listBooksToolDefinition,
-                    getBookToolDefinition,
-                    getBalancesToolDefinition,
-                    listTransactionsToolDefinition,
-                    createTransactionsToolDefinition,
-                    mergeTransactionsToolDefinition,
-                ],
-            };
-        }));
-        this.server.setRequestHandler(CallToolRequestSchema, (request) => __awaiter(this, void 0, void 0, function* () {
-            const toolName = request.params.name;
-            const toolArgs = request.params.arguments;
-            let result;
-            try {
-                switch (toolName) {
-                    case 'list_books':
-                        result = yield handleListBooks(toolArgs);
-                        break;
-                    case 'get_book':
-                        result = yield handleGetBook(toolArgs);
-                        break;
-                    case 'get_balances':
-                        result = yield handleGetBalances(toolArgs);
-                        break;
-                    case 'list_transactions':
-                        result = yield handleListTransactions(toolArgs);
-                        break;
-                    case 'create_transactions':
-                        result = yield handleCreateTransactions(toolArgs);
-                        break;
-                    case 'merge_transactions':
-                        result = yield handleMergeTransactions(toolArgs);
-                        break;
-                    default:
-                        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${toolName}`);
-                }
-                return result;
-            }
-            catch (error) {
-                // Only log actual errors, not debug info
-                if (!(error instanceof McpError)) {
-                    // Convert unexpected errors to MCP errors
-                    throw new McpError(ErrorCode.InternalError, `Tool ${toolName} failed: ${error instanceof Error ? error.message : String(error)}`);
-                }
-                throw error;
-            }
-        }));
-    }
-    setupErrorHandling() {
-        this.server.onerror = (error) => {
-            // Log critical server errors to a file or syslog in production
-            // Avoid console output during MCP stdio mode as it contaminates the stream
-            if (process.env.NODE_ENV !== 'production') {
-                // In development, log to stderr only if not in MCP mode
-                const isStdioMode = process.argv.includes('mcp') && process.argv.includes('start');
-                if (!isStdioMode) {
-                    console.error('[MCP Server Error]:', error instanceof Error ? error.message : String(error));
-                }
-            }
-            // TODO: In production, implement proper logging to file/syslog
-            // Example: logger.error('MCP Server Error', { error: error.message, stack: error.stack });
-        };
-        process.on('SIGINT', () => __awaiter(this, void 0, void 0, function* () {
-            yield this.server.close();
-            process.exit(0);
-        }));
-    }
-    run() {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                const transport = new StdioServerTransport();
-                yield this.server.connect(transport);
-                // Server is now ready and listening on stdio
-            }
-            catch (error) {
-                // Do not log startup errors as they contaminate stdio stream
-                throw error;
-            }
-        });
-    }
-    // Test helper methods for accessing MCP handlers directly
-    testListTools() {
-        return __awaiter(this, void 0, void 0, function* () {
-            // Call the list tools handler directly for testing
-            const requestHandlers = this.server._requestHandlers;
-            const handler = requestHandlers.get('tools/list');
-            if (!handler)
-                throw new Error('ListTools handler not found');
-            // Create proper MCP request format
-            const request = {
-                method: 'tools/list',
-                params: {}
-            };
-            return yield handler(request);
-        });
-    }
-    testCallTool(name_1) {
-        return __awaiter(this, arguments, void 0, function* (name, args = {}) {
-            // Call the call tool handler directly for testing  
-            const requestHandlers = this.server._requestHandlers;
-            const handler = requestHandlers.get('tools/call');
-            if (!handler)
-                throw new Error('CallTool handler not found');
-            // Create proper MCP request format
-            const request = {
-                method: 'tools/call',
-                params: { name, arguments: args }
-            };
-            return yield handler(request);
-        });
-    }
-}
-// Export the class for testing
-export { BkperMcpServer };
-// Only run the server if this file is executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-    const server = new BkperMcpServer();
-    server.run().catch(() => {
-        // Exit silently on error to avoid contaminating stdio stream
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=server.js.map

package/lib/mcp/server.js.map

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

package/lib/mcp/system-prompt.md

@@ -1,192 +0,0 @@
-# Bkper MCP Usage Guide
-
-## Essential Tools
-
-### Discovery
-- `list_books()` - Find available books
-- `get_book({ bookId })` - Book details, structure, and group hierarchies
-
-### Analysis
-- `get_balances({ bookId, query })` - **THE** tool for all balance analysis
-- `list_transactions({ bookId, query })` - Transaction inspection only (never for balance calculations)
-
-## Core Rules
-
-### 1. Root Group Discovery
-**Always discover and use root groups dynamically based on account group types:**
-1. Call `get_book({ bookId })` to see the hierarchy
-2. Look for the top-level group that contains:
-   - **For Balance Sheet**: Both ASSET and LIABILITY account types
-   - **For P&L**: Both INCOMING and OUTGOING account types
-3. Use that group name (not its children) in your queries
-
-**Example**: If you see this structure:
-```
-"Total Equity" (root)
-├── "Assets" (type: ASSET)
-├── "Liabilities" (type: LIABILITY)
-```
-Then use `group:'Total Equity'` - NOT `group:'Assets'` or `group:'Liabilities'`
-
-### 2. Date Filter Matching
-
-- **Permanent accounts** (ASSET, LIABILITY): Use `before:` dates for point-in-time
-- **Non-permanent accounts** (INCOMING, OUTGOING): Use `after:` and `before:` for periods
-
-- **IMPORTANT:** `after:` is inclusive and `before:` is exclusive, so, for example, to filter the whole 2024 year, the range might be `after:2024-01-01 before:2025-01-01` 
-
-### 3. Correct Tool Selection
-- **Balance analysis**: Always use `get_balances`
-- **Transaction inspection**: Use `list_transactions` (never for calculations)
-
-### 4. Balance Analysis Query Requirements (MANDATORY)
-- **MUST include either `group:` or `account:` operator in EVERY query**
-- Never query subgroups directly (Assets, Liabilities, Revenue, Expenses) - use root groups
-- When using `account:`, be specific about individual accounts
-- Always include appropriate date filters
-- Balance analysis queries without group/account operators will be rejected with an error
-- Transaction queries can be without group/account operators
-
-## Examples
-
-### Balance Sheet Analysis
-```javascript
-// After discovering root group for ASSET + LIABILITY accounts
-get_balances({ 
-  bookId: "book-123", 
-  query: "group:'Total Equity' before:$m" 
-})
-```
-
-### P&L Analysis
-```javascript
-// After discovering root group for INCOMING + OUTGOING accounts
-get_balances({ 
-  bookId: "book-123", 
-  query: "group:'Profit & Loss' after:$m-12 before:$m" 
-})
-```
-
-### Complete Financial Statements
-```javascript
-// After discovering both root groups
-const balanceSheet = await get_balances({ 
-  bookId: "book-123", 
-  query: "group:'Total Equity' before:$m+1" 
-});
-
-const pnl = await get_balances({ 
-  bookId: "book-123", 
-  query: "group:'Profit & Loss' after:$m-1 before:$m" 
-});
-```
-
-### Transaction Inspection
-```javascript
-// Recent transactions (inspection only)
-list_transactions({ 
-  bookId: "book-123", 
-  query: "after:$d-30" 
-})
-
-// Large transactions
-list_transactions({ 
-  bookId: "book-123", 
-  query: "amount>1000 after:$m-1 before:$m" 
-})
-```
-
-## Account Structure Reference
-
-### Account Types
-| Type | Nature | Examples |
-|------|--------|----------|
-| **ASSET** | Permanent | Cash, Accounts Receivable |
-| **LIABILITY** | Permanent | Accounts Payable, Loans |
-| **INCOMING** | Non-permanent | Sales, Interest Income |
-| **OUTGOING** | Non-permanent | Rent, Utilities |
-
-### Example Group Hierarchies
-
-**Example 1: Permanent Accounts (Balance Sheet Analysis)**
-```
-"Total Equity"
-├── Assets
-│   ├── Current Assets
-│   └── Fixed Assets
-└── Liabilities
-    ├── Current Liabilities
-    └── Long-term Liabilities
-```
-
-**Example 2: Non-Permanent Accounts (Profit & Loss Analysis)**
-```
-"Profit & Loss"
-├── Revenue
-│   ├── Product Sales
-│   └── Service Revenue
-└── Expenses
-    ├── Operating Expenses
-    └── Administrative Expenses
-```
-
-**Note**: Root group names vary by book. Always discover the actual names using `get_book()` which includes group hierarchies.
-
-## Quick Reference
-
-### Date Variables
-- `$d` - Today
-- `$m` - Current month end
-- `$y` - Current year end
-- `$d-N` - N days ago
-- `$m-N` - N months ago
-
-### Query Patterns
-```
-group:'[ROOT_GROUP_NAME]' before:$m                      // Balance sheet (permanent accounts)
-group:'[ROOT_GROUP_NAME]' after:$m-1 before:$m      // P&L (non-permanent accounts)
-after:2024-01-01 before:2025-01-01                  // Date range
-amount>1000                                          // Amount filter (transactions only)
-```
-
-### Analysis Workflow
-1. **Discover**: `list_books()` → `get_book()` (includes groups)
-2. **Identify Root Groups**: Find groups containing the group types you need
-3. **Analyze**: `get_balances()` with discovered root groups
-4. **Inspect**: `list_transactions()` for transaction details
-
-## Reports and Insights Formatting
-
-### Markdown Output Preference
-When generating financial insights, reports, or analysis, **strongly prefer well-structured Markdown** for better readability across platforms (cloud, desktop, mobile). Use tables for financial data, clear headers for sections, bold formatting for totals and key metrics, and icons to enhance visual appeal.
-
-
-## Common Mistakes to Avoid
-
-❌ **Wrong**: `get_balances({ query: "before:$m" })` - Missing group/account operator!  
-✅ **Right**: `get_balances({ query: "group:'[ROOT_GROUP]' before:$m" })`
-
-❌ **Wrong**: `get_balances({ query: "after:2024-01-01" })` - Missing group/account operator!  
-✅ **Right**: `get_balances({ query: "group:'[ROOT_GROUP]' after:2024-01-01 before:2025-01-01" })`
-
-❌ **Wrong**: `get_balances({ query: "group:'Assets'" })` - Using subgroup instead of root group  
-✅ **Right**: `get_balances({ query: "group:'[ROOT_GROUP_WITH_ASSETS]' before:$m" })`
-
-❌ **Wrong**: Query without any filtering  
-✅ **Right**: Always include `group:` or `account:` operator for focused analysis
-
-❌ **Wrong**: Using `list_transactions` for balance calculations  
-✅ **Right**: Use `get_balances` for all balance analysis
-
-❌ **Wrong**: Using `before:` without `after:` dates with non-permanent accounts  
-✅ **Right**: Use `after:` and `before:` with INCOMING/OUTGOING accounts
-
-❌ **Wrong**: Using different date variables on same query. E.g.`after:$y-1` and `before:$d`
-✅ **Right**: Use same date variables on same query. E.g. `after:$y-1` and `before:$y`
-
-❌ **Wrong**: Assuming fixed root group names  
-✅ **Right**: Always discover root groups using `get_book()` then navigate its `groups` property
-
-## CRITICAL REQUIREMENT
-
-**⚠️ ALL get_balances queries MUST include either `group:` or `account:` operator.**

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

@@ -1,59 +0,0 @@
-import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-interface TransactionInput {
-    date: string;
-    amount: number;
-    from_account?: string;
-    to_account?: string;
-    description: string;
-}
-interface CreateTransactionsParams {
-    bookId: string;
-    transactions: TransactionInput[];
-}
-export declare function handleCreateTransactions(params: CreateTransactionsParams): Promise<CallToolResult>;
-export declare const createTransactionsToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            bookId: {
-                type: string;
-                description: string;
-            };
-            transactions: {
-                type: string;
-                items: {
-                    type: string;
-                    properties: {
-                        date: {
-                            type: string;
-                            description: string;
-                        };
-                        amount: {
-                            type: string;
-                            description: string;
-                        };
-                        from_account: {
-                            type: string;
-                            description: string;
-                        };
-                        to_account: {
-                            type: string;
-                            description: string;
-                        };
-                        description: {
-                            type: string;
-                            description: string;
-                        };
-                    };
-                    required: string[];
-                };
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export {};
-//# sourceMappingURL=create_transactions.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"create_transactions.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/create_transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAC;AAIzF,UAAU,gBAAgB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,wBAAwB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,gBAAgB,EAAE,CAAC;CACpC;AAMD,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiJxG;AAED,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C5C,CAAC"}

package/lib/mcp/tools/create_transactions.js

@@ -1,163 +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';
-import { Transaction } from 'bkper-js';
-export function handleCreateTransactions(params) {
-    return __awaiter(this, void 0, void 0, function* () {
-        try {
-            // Debug logging removed to prevent stdio contamination
-            // Validate required parameters
-            if (!params.bookId) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: bookId');
-            }
-            if (!params.transactions) {
-                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: transactions');
-            }
-            if (!Array.isArray(params.transactions)) {
-                throw new McpError(ErrorCode.InvalidParams, 'Parameter transactions must be an array');
-            }
-            // Handle empty array case
-            if (params.transactions.length === 0) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({ transactions: [] }, null, 2),
-                        },
-                    ],
-                };
-            }
-            // Validate each transaction
-            params.transactions.forEach((tx, index) => {
-                if (!tx.date || typeof tx.date !== 'string' || tx.date.trim() === '') {
-                    throw new McpError(ErrorCode.InvalidParams, `Transaction at index ${index}: Missing or empty required field 'date'`);
-                }
-                if (tx.amount === undefined || tx.amount === null || typeof tx.amount !== 'number') {
-                    throw new McpError(ErrorCode.InvalidParams, `Transaction at index ${index}: Missing or invalid required field 'amount'`);
-                }
-                if (!tx.description || typeof tx.description !== 'string' || tx.description.trim() === '') {
-                    throw new McpError(ErrorCode.InvalidParams, `Transaction at index ${index}: Missing or empty required field 'description'`);
-                }
-            });
-            // Get configured Bkper instance
-            const bkperInstance = getBkperInstance();
-            // Get the book
-            const book = yield bkperInstance.getBook(params.bookId);
-            if (!book) {
-                throw new McpError(ErrorCode.InvalidParams, `Book not found: ${params.bookId}`);
-            }
-            // Create Transaction objects with description built from structured data
-            const bkperTransactions = params.transactions.map((tx) => {
-                const transaction = new Transaction(book);
-                // Build description with optional accounts
-                const parts = [];
-                if (tx.from_account && tx.from_account.trim()) {
-                    parts.push(tx.from_account.trim());
-                }
-                if (tx.to_account && tx.to_account.trim()) {
-                    parts.push(tx.to_account.trim());
-                }
-                parts.push(tx.description);
-                const fullDescription = parts.join(' ');
-                transaction.setDate(tx.date);
-                transaction.setAmount(tx.amount);
-                transaction.setDescription(fullDescription);
-                return transaction;
-            });
-            // Batch create transactions
-            const createdTransactions = yield book.batchCreateTransactions(bkperTransactions);
-            // Clean response by removing internal fields and ensure JSON serializable
-            const transactions = createdTransactions.map((transaction) => {
-                const transactionJson = transaction.json();
-                const { agentId, agentName, agentLogo, agentLogoDark, createdAt, createdBy, updatedAt, dateValue } = transactionJson, cleanTransaction = __rest(transactionJson, ["agentId", "agentName", "agentLogo", "agentLogoDark", "createdAt", "createdBy", "updatedAt", "dateValue"]);
-                // Ensure all values are JSON serializable
-                return JSON.parse(JSON.stringify(cleanTransaction));
-            });
-            // Build response
-            const response = {
-                transactions
-            };
-            const responseText = JSON.stringify(response, null, 2);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: responseText,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            // Re-throw MCP errors as-is
-            if (error instanceof McpError) {
-                throw error;
-            }
-            // Handle other errors
-            throw new McpError(ErrorCode.InternalError, `Failed to create transactions: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    });
-}
-export const createTransactionsToolDefinition = {
-    name: 'create_transactions',
-    description: 'Create transactions in batch from structured data. Accounts are specified by name and resolved by Bkper.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            bookId: {
-                type: 'string',
-                description: 'The unique identifier of the book'
-            },
-            transactions: {
-                type: 'array',
-                items: {
-                    type: 'object',
-                    properties: {
-                        date: {
-                            type: 'string',
-                            description: 'Transaction date in ISO format (YYYY-MM-DD) or book date format'
-                        },
-                        amount: {
-                            type: 'number',
-                            description: 'Transaction amount'
-                        },
-                        from_account: {
-                            type: 'string',
-                            description: 'Origin/Credit account name'
-                        },
-                        to_account: {
-                            type: 'string',
-                            description: 'Destination/Debit account name'
-                        },
-                        description: {
-                            type: 'string',
-                            description: 'Transaction description (can include #hashtags)'
-                        }
-                    },
-                    required: ['date', 'amount', 'description']
-                },
-                description: 'Array of transactions to create'
-            }
-        },
-        required: ['bookId', 'transactions']
-    }
-};
-//# sourceMappingURL=create_transactions.js.map

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"get_balances.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/get_balances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,oCAAoC,CAAC;AAIzF,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AASD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoG1F;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;CAiBrC,CAAC"}