bkper 3.5.5 → 3.6.0

package/README.md

@@ -1,6 +1,6 @@
 [Bkper REST API]: https://bkper.com/docs/#rest-api-enabling
 
-A **command line** utility for managing [Bkper Apps and Bots](https://bkper.com/docs/) and running the [Model Context Protocol (MCP) server](https://modelcontextprotocol.io). 
+A **command line** utility for managing [Bkper Apps and Bots](https://bkper.com/docs/) and running the [Model Context Protocol (MCP) server](https://modelcontextprotocol.io).
 
 The MCP server enables AI assistants and agents to interact with your Bkper books through a standardized protocol.
 
@@ -13,37 +13,45 @@ The MCP server enables AI assistants and agents to interact with your Bkper book
 ```
 npm i bkper
 ```
+
 or
+
 ```
 yarn add bkper
 ```
+
 or
+
 ```
 bun add bkper
 ```
 
-Optionally, you can install it globally to be able to use the ```bkper``` command line utility:
+Optionally, you can install it globally to be able to use the `bkper` command line utility:
 
 ```
 npm i -g bkper
 ```
+
 or
+
 ```
 yarn global add bkper
 ```
 
 ## Commands
 
-- ```login```   - Logs the user in. Saves the client credentials to a ```~/.config/bkper/.bkper-credentials.json``` file.
-- ```logout```  - Logs out the user by deleting client credentials.
-- ```mcp start``` - Start the Bkper MCP (Model Context Protocol) server.
-- ```app -c```  - Create a new App based on ```./bkperapp.yaml``` file.
-- ```app -u```  - Update an existing App based on ```./bkperapp.yaml``` file.
+- `login` - Logs the user in. Saves the client credentials to a `~/.config/bkper/.bkper-credentials.json` file.
+- `logout` - Logs out the user by deleting client credentials.
+- `mcp start` - Start the Bkper MCP (Model Context Protocol) server.
+- `app -c` - Create a new App based on `./bkperapp.yaml` file.
+- `app -u` - Update an existing App based on `./bkperapp.yaml` file.
 
 ### Examples
+
 ```
 npm bkper login
 ```
+
 ```
 yarn bkper login
 ```
@@ -68,6 +76,7 @@ The server runs on stdio and provides the following tools:
 #### Prerequisites
 
 Before using the MCP server:
+
 1. Login using `bkper login` to set up authentication
 2. Enable the [Bkper REST API]
 3. Ensure the `BKPER_API_KEY` environment variable is set.
@@ -79,6 +88,7 @@ The MCP server uses the same authentication as the CLI, reading credentials from
 ##### Claude Desktop
 
 Add to your configuration file:
+
 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
@@ -99,6 +109,7 @@ Add to your configuration file:
 ##### Other MCP Clients
 
 For other MCP-compatible clients, configure them to run:
+
 ```bash
 BKPER_API_KEY=your-api-key npx bkper mcp start
 ```
@@ -108,6 +119,7 @@ The server communicates via stdio, so any MCP client that supports stdio transpo
 #### Available MCP Tools
 
 Once connected, the MCP client can:
+
 - List your Bkper books
 - Get account balances for any date or period
 - Search and filter transactions
@@ -115,18 +127,17 @@ Once connected, the MCP client can:
 
 For more information about the Model Context Protocol, visit [modelcontextprotocol.io](https://modelcontextprotocol.io).
 
-
-
 ## Apps and Bots
 
 ### Environment Variables
+
 The following environment variable is necessary in order to communicate with the [Bkper REST API]:
 
 ```
 BKPER_API_KEY=XXXX
 ```
 
-The ```app``` command also uses the following variables in order to perform App create/update operations:
+The `app` command also uses the following variables in order to perform App create/update operations:
 
 ```
 BKPER_CLIENT_SECRET=YYYY
@@ -134,16 +145,14 @@ BKPER_USER_EMAILS="someone@gmail.com anotherone@altrostat.com"
 BKPER_DEVELOPER_EMAIL=somedeveloer@mycompany.com
 ```
 
-You can add a ```.env``` file at the root of your project with those variables and bkper will automatically load from it. 
+You can add a `.env` file at the root of your project with those variables and bkper will automatically load from it.
 Follow [these](https://bkper.com/docs/#rest-api-enabling) steps in order to configure a valid Bkper API key.
 
 > WARNING: Never upload variables to the source code repository.
 
-
-### ```./bkperapp.yaml``` Reference
+### `./bkperapp.yaml` Reference
 
 ```yaml
-
 # BASIC APP CONFIGURATION
 
 # The agent id of the App or Bot. It can NOT be changed after the App or Bot is created.
@@ -158,8 +167,6 @@ logoUrl: https://static.thenounproject.com/png/2318500-200.png
 # The logo url to be used when in dark mode
 logoUrlDark: https://static.thenounproject.com/png/2318500-200.png
 
-
-
 # CONTEXT MENU CONFIGURATION
 
 # The menu production url to open in the popup window. See accepted expressions bellow.
@@ -174,20 +181,12 @@ menuText: Open My Custom App
 menuPopupWidth: 500 # width in pixels. Default to 80% of screen width.
 menuPopupHeight: 300 # height in pixels. Default to 90% of screen height.
 
-
-#ASSISTANT CONFIGURATION
-
-# The conversation url to be called by Bkper when a new conversation message is added
-conversationUrl: https://us-central1-bkper-tax-trigger.cloudfunctions.net/chat
-
-
-
 # BOT EVENTS CONFIGURATION
 
 # The webhook url to be called by Bkper when an event occurs.
 webhookUrl: https://us-central1-bkper-tax-trigger.cloudfunctions.net/events
 
-# The events the Bot is capable of processing by the webhook. 
+# The events the Bot is capable of processing by the webhook.
 # This is optional and, if not specified, no events will be processed.
 events:
   - "TRANSACTION_POSTED"
@@ -211,7 +210,6 @@ filePatterns:
   - "-*.qif"
   - "*.csv"
 
-
 # Schema to provide autocompletion on properties editor.
 propertiesSchema:
   book:
@@ -242,19 +240,18 @@ propertiesSchema:
     values:
       - "value2"
       - "value2"
-
 ```
 
 #### Accepted expressions in menuUrl property:
 
-  - ```${book.id}``` - the current book id
-  - ```${book.properties.xxxxx}``` - any property value from the current book
-  - ```${transactions.query}``` - the current query being executed on transactions list
-  - ```${transactions.ids}``` - the ids of selected transactions, splitted by comma
-  - ```${account.id}``` - the current account being filterd
-  - ```${account.properties.xxxxx}``` - any property value from the current account being filtered
-  - ```${group.id}``` - the current group being filterd
-  - ```${group.properties.xxxxx}``` - any property value from the current group being filtered
+- `${book.id}` - the current book id
+- `${book.properties.xxxxx}` - any property value from the current book
+- `${transactions.query}` - the current query being executed on transactions list
+- `${transactions.ids}` - the ids of selected transactions, splitted by comma
+- `${account.id}` - the current account being filterd
+- `${account.properties.xxxxx}` - any property value from the current account being filtered
+- `${group.id}` - the current group being filterd
+- `${group.properties.xxxxx}` - any property value from the current group being filtered
 
 #### Example:
 
@@ -264,20 +261,19 @@ propertiesSchema:
 
 #### Library
 
-The ```getOAuthToken``` returns a Promise that resolves to a valid OAuth token, to be used by the [```bkper-js```](https://github.com/bkper/bkper-js) library
+The `getOAuthToken` returns a Promise that resolves to a valid OAuth token, to be used by the [`bkper-js`](https://github.com/bkper/bkper-js) library
 
 Example:
 
 ```javascript
-import { Bkper } from 'bkper-js';
-import { getOAuthToken } from 'bkper';
+import { Bkper } from "bkper-js";
+import { getOAuthToken } from "bkper";
 
 Bkper.setConfig({
   oauthTokenProvider: async () => getOAuthToken(),
-})
+});
 ```
 
 ## Documentation
 
 - [Developer Docs](https://bkper.com/docs)
-

package/lib/auth/local-auth-service.js

@@ -31,10 +31,10 @@ if (!fs.existsSync(storedCredentialsPath) && fs.existsSync(oldCredentialsPath))
         const oldCredentials = fs.readFileSync(oldCredentialsPath, 'utf8');
         fs.writeFileSync(storedCredentialsPath, oldCredentials, 'utf8');
         fs.rmSync(oldCredentialsPath);
-        console.log('Migrated credentials to new location: ~/.config/bkper/');
+        // Credentials migrated successfully
     }
     catch (err) {
-        console.error('Failed to migrate credentials:', err);
+        // Migration failed - will fall back to old behavior
     }
 }
 try {
@@ -42,7 +42,7 @@ try {
     storedCredentials = JSON.parse(credentialsJson);
 }
 catch (err) {
-    console.log('No local credentials found.');
+    // Credentials will be null if not found - no need to log during module loading
 }
 export function login() {
     return __awaiter(this, void 0, void 0, function* () {

package/lib/auth/local-auth-service.js.map

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

package/lib/mcp/domain/transaction/merge-operation.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Transaction Merge Operation - Domain Logic
+ *
+ * Pure business logic for merging two transactions into one.
+ * This class contains no dependencies on MCP, HTTP, or other infrastructure concerns.
+ * It operates on Transaction domain objects from bkper-js.
+ */
+import { Transaction, Book } from 'bkper-js';
+import { MergedTransactionData } from './merge-types.js';
+/**
+ * Represents the result of a transaction merge operation
+ *
+ * Determines which transaction to keep (edit) vs discard (revert),
+ * then intelligently merges data from both transactions.
+ */
+export declare class TransactionMergeOperation {
+    private book;
+    editTransaction: Transaction;
+    revertTransaction: Transaction;
+    mergedData: MergedTransactionData;
+    record: string | null;
+    private static readonly WORD_SPLITTER;
+    constructor(book: Book, transaction1: Transaction, transaction2: Transaction);
+    /**
+     * Merges data from both transactions into a single transaction data object
+     * @returns Merged transaction data
+     */
+    private merge;
+    /**
+     * Merges two descriptions intelligently, avoiding duplicate words
+     * @param desc1 First description (from edit transaction)
+     * @param desc2 Second description (from revert transaction)
+     * @returns Merged description with unique words
+     */
+    private mergeDescription;
+    /**
+     * Trims and normalizes whitespace in text
+     * @param text Text to trim
+     * @returns Trimmed text with normalized whitespace
+     */
+    private trim;
+    /**
+     * Apply the merged data to the edit transaction
+     * This mutates the edit transaction object with the merged data
+     */
+    applyMergedData(): void;
+}
+//# sourceMappingURL=merge-operation.d.ts.map

package/lib/mcp/domain/transaction/merge-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-operation.d.ts","sourceRoot":"","sources":["../../../../src/mcp/domain/transaction/merge-operation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;GAKG;AACH,qBAAa,yBAAyB;IAS9B,OAAO,CAAC,IAAI;IART,eAAe,EAAE,WAAW,CAAC;IAC7B,iBAAiB,EAAE,WAAW,CAAC;IAC/B,UAAU,EAAE,qBAAqB,CAAC;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAa;gBAGtC,IAAI,EAAE,IAAI,EAClB,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,WAAW;IA8B7B;;;OAGG;IACH,OAAO,CAAC,KAAK;IAkFb;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAIZ;;;OAGG;IACH,eAAe,IAAI,IAAI;CAsD1B"}

package/lib/mcp/domain/transaction/merge-operation.js

@@ -0,0 +1,195 @@
+/**
+ * Transaction Merge Operation - Domain Logic
+ *
+ * Pure business logic for merging two transactions into one.
+ * This class contains no dependencies on MCP, HTTP, or other infrastructure concerns.
+ * It operates on Transaction domain objects from bkper-js.
+ */
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Represents the result of a transaction merge operation
+ *
+ * Determines which transaction to keep (edit) vs discard (revert),
+ * then intelligently merges data from both transactions.
+ */
+export class TransactionMergeOperation {
+    constructor(book, transaction1, transaction2) {
+        var _a, _b;
+        this.book = book;
+        this.record = null;
+        // Determine which transaction to edit vs revert based on priority rules
+        const tx1IsPosted = (_a = transaction1.isPosted()) !== null && _a !== void 0 ? _a : false;
+        const tx2IsPosted = (_b = transaction2.isPosted()) !== null && _b !== void 0 ? _b : false;
+        // Rule 1: Prefer posted transactions over drafts
+        if (!tx1IsPosted && tx2IsPosted) {
+            this.revertTransaction = transaction1;
+            this.editTransaction = transaction2;
+        }
+        else if (tx1IsPosted && !tx2IsPosted) {
+            this.revertTransaction = transaction2;
+            this.editTransaction = transaction1;
+        }
+        else {
+            // Rule 2: If both same status, prefer newer transaction (higher createdAt)
+            const tx1Created = transaction1.getCreatedAt().getTime();
+            const tx2Created = transaction2.getCreatedAt().getTime();
+            if (tx1Created < tx2Created) {
+                this.revertTransaction = transaction1;
+                this.editTransaction = transaction2;
+            }
+            else {
+                this.revertTransaction = transaction2;
+                this.editTransaction = transaction1;
+            }
+        }
+        this.mergedData = this.merge();
+    }
+    /**
+     * Merges data from both transactions into a single transaction data object
+     * @returns Merged transaction data
+     */
+    merge() {
+        // Start with edit transaction's JSON data as base
+        const merged = Object.assign({}, this.editTransaction.json());
+        // Merge description using Transaction wrapper
+        const editDescription = this.editTransaction.getDescription();
+        const revertDescription = this.revertTransaction.getDescription();
+        merged.description = this.mergeDescription(editDescription || null, revertDescription || null);
+        // Merge files using Transaction wrapper
+        const editFiles = this.editTransaction.getFiles() || [];
+        const revertFiles = this.revertTransaction.getFiles() || [];
+        const mergedFiles = [
+            ...editFiles.map(f => f.json()),
+            ...revertFiles.map(f => f.json())
+        ];
+        merged.files = mergedFiles;
+        // Keep "attachments" for backward compatibility with test fixtures
+        merged.attachments = mergedFiles;
+        // Merge remote IDs using Transaction wrapper
+        const editRemoteIds = this.editTransaction.getRemoteIds();
+        const revertRemoteIds = this.revertTransaction.getRemoteIds();
+        merged.remoteIds = [...new Set([...editRemoteIds, ...revertRemoteIds])];
+        // Merge URLs using Transaction wrapper
+        const editUrls = this.editTransaction.getUrls();
+        const revertUrls = this.revertTransaction.getUrls();
+        merged.urls = [...new Set([...editUrls, ...revertUrls])];
+        // Merge properties using Transaction wrapper (revert overwrites edit)
+        const editProperties = this.editTransaction.getProperties();
+        const revertProperties = this.revertTransaction.getProperties();
+        merged.properties = Object.assign(Object.assign({}, editProperties), revertProperties);
+        // Backfill credit account - get from revert if edit doesn't have it
+        const editData = this.editTransaction.json();
+        const revertData = this.revertTransaction.json();
+        if (!editData.creditAccount && !editData.creditAccountId) {
+            if (revertData.creditAccount)
+                merged.creditAccount = revertData.creditAccount;
+            const revertCompat = revertData;
+            if (revertCompat.creditAccountId)
+                merged.creditAccountId = revertCompat.creditAccountId;
+        }
+        // Backfill debit account - get from revert if edit doesn't have it
+        if (!editData.debitAccount && !editData.debitAccountId) {
+            if (revertData.debitAccount)
+                merged.debitAccount = revertData.debitAccount;
+            const revertCompat = revertData;
+            if (revertCompat.debitAccountId)
+                merged.debitAccountId = revertCompat.debitAccountId;
+        }
+        // Handle amount validation and merging using Transaction wrapper
+        const editAmount = this.editTransaction.getAmount();
+        const revertAmount = this.revertTransaction.getAmount();
+        if (editAmount && revertAmount) {
+            // Both have amounts - validate they are equal
+            if (editAmount.cmp(revertAmount) !== 0) {
+                // Amounts differ - throw error for manual reconciliation
+                throw new McpError(ErrorCode.InvalidParams, `Cannot merge transactions with different amounts: ${editAmount.toString()} vs ${revertAmount.toString()}. ` +
+                    `Please reconcile amounts manually before merging.`);
+            }
+            // Amounts are equal - keep edit's amount (no change needed)
+        }
+        else if (!editAmount && revertAmount) {
+            // Edit has no amount, use revert's amount
+            merged.amount = revertAmount.toString();
+        }
+        // If edit has amount and revert doesn't, keep edit's amount (already in merged)
+        return merged;
+    }
+    /**
+     * Merges two descriptions intelligently, avoiding duplicate words
+     * @param desc1 First description (from edit transaction)
+     * @param desc2 Second description (from revert transaction)
+     * @returns Merged description with unique words
+     */
+    mergeDescription(desc1, desc2) {
+        if (!desc1)
+            return desc2 || '';
+        if (!desc2)
+            return desc1;
+        const desc1Lower = desc1.toLowerCase();
+        const words = desc2.split(TransactionMergeOperation.WORD_SPLITTER)
+            .filter(word => word.length > 0);
+        const uniqueWords = words.filter(word => !desc1Lower.includes(word.toLowerCase()));
+        return this.trim(desc1 + ' ' + uniqueWords.join(' '));
+    }
+    /**
+     * Trims and normalizes whitespace in text
+     * @param text Text to trim
+     * @returns Trimmed text with normalized whitespace
+     */
+    trim(text) {
+        return text.trim().replace(/\s+/g, ' ');
+    }
+    /**
+     * Apply the merged data to the edit transaction
+     * This mutates the edit transaction object with the merged data
+     */
+    applyMergedData() {
+        var _a;
+        const edit = this.editTransaction;
+        const merged = this.mergedData;
+        // Set description (ensure it's a string)
+        if (merged.description !== undefined) {
+            edit.setDescription(merged.description);
+        }
+        // Set properties
+        if (merged.properties) {
+            edit.setProperties(merged.properties);
+        }
+        // Set URLs
+        if (merged.urls && merged.urls.length > 0) {
+            edit.setUrls(merged.urls);
+        }
+        // Set amount if changed
+        if (merged.amount) {
+            edit.setAmount(merged.amount);
+        }
+        // Set credit account if changed
+        if (merged.creditAccount) {
+            edit.setCreditAccount(merged.creditAccount);
+        }
+        // Set debit account if changed
+        if (merged.debitAccount) {
+            edit.setDebitAccount(merged.debitAccount);
+        }
+        // Add remote IDs
+        const currentRemoteIds = edit.getRemoteIds();
+        if (merged.remoteIds) {
+            merged.remoteIds.forEach((remoteId) => {
+                if (!currentRemoteIds.includes(remoteId)) {
+                    edit.addRemoteId(remoteId);
+                }
+            });
+        }
+        // Add files
+        if (merged.files && merged.files.length > (((_a = this.editTransaction.getFiles()) === null || _a === void 0 ? void 0 : _a.length) || 0)) {
+            const currentFiles = this.editTransaction.getFiles() || [];
+            const newFiles = merged.files.slice(currentFiles.length);
+            newFiles.forEach((file) => {
+                // addFile expects File class but accepts raw bkper.File in practice
+                edit.addFile(file);
+            });
+        }
+    }
+}
+TransactionMergeOperation.WORD_SPLITTER = /[ \-_]+/;
+//# sourceMappingURL=merge-operation.js.map

package/lib/mcp/domain/transaction/merge-operation.js.map

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

package/lib/mcp/domain/transaction/merge-types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Domain types for transaction merge operations
+ *
+ * These types represent the core business domain for merging transactions,
+ * independent of any specific API or protocol (MCP, REST, etc.)
+ */
+/**
+ * Merged transaction data that extends the base bkper.Transaction type
+ * with compatibility fields for legacy systems and test fixtures
+ */
+export interface MergedTransactionData extends bkper.Transaction {
+    /**
+     * Compatibility field: alias for 'files' used in test fixtures
+     */
+    attachments?: bkper.File[];
+    /**
+     * Compatibility field: ID-only version of creditAccount for legacy systems
+     */
+    creditAccountId?: string;
+    /**
+     * Compatibility field: ID-only version of debitAccount for legacy systems
+     */
+    debitAccountId?: string;
+}
+//# sourceMappingURL=merge-types.d.ts.map

package/lib/mcp/domain/transaction/merge-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-types.d.ts","sourceRoot":"","sources":["../../../../src/mcp/domain/transaction/merge-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,KAAK,CAAC,WAAW;IAC5D;;OAEG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/lib/mcp/domain/transaction/merge-types.js

@@ -0,0 +1,8 @@
+/**
+ * Domain types for transaction merge operations
+ *
+ * These types represent the core business domain for merging transactions,
+ * independent of any specific API or protocol (MCP, REST, etc.)
+ */
+export {};
+//# sourceMappingURL=merge-types.js.map

package/lib/mcp/domain/transaction/merge-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-types.js","sourceRoot":"","sources":["../../../../src/mcp/domain/transaction/merge-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAOA,OAAO,EAEL,cAAc,EAGd,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAO5C,cAAM,cAAc;IAClB,OAAO,CAAC,MAAM,CAAS;;IAmBvB,OAAO,CAAC,iBAAiB;IAgCzB,OAAO,CAAC,kBAAkB;IAWpB,GAAG;IAOH,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAczC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAc9F;AAGD,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAOA,OAAO,EAEL,cAAc,EAGd,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAS5C,cAAM,cAAc;IAClB,OAAO,CAAC,MAAM,CAAS;;IAmBvB,OAAO,CAAC,iBAAiB;IAgEzB,OAAO,CAAC,kBAAkB;IAqBpB,GAAG;IAYH,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;IAczC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAc9F;AAGD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/lib/mcp/server.js

@@ -17,6 +17,8 @@ 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({
@@ -38,27 +40,63 @@ class BkperMcpServer {
                     getBookToolDefinition,
                     getBalancesToolDefinition,
                     listTransactionsToolDefinition,
+                    createTransactionsToolDefinition,
+                    mergeTransactionsToolDefinition,
                 ],
             };
         }));
         this.server.setRequestHandler(CallToolRequestSchema, (request) => __awaiter(this, void 0, void 0, function* () {
-            switch (request.params.name) {
-                case 'list_books':
-                    return yield handleListBooks(request.params.arguments);
-                case 'get_book':
-                    return yield handleGetBook(request.params.arguments);
-                case 'get_balances':
-                    return yield handleGetBalances(request.params.arguments);
-                case 'list_transactions':
-                    return yield handleListTransactions(request.params.arguments);
-                default:
-                    throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
+            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) => {
-            console.error('[MCP Error]', 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();
@@ -67,9 +105,15 @@ class BkperMcpServer {
     }
     run() {
         return __awaiter(this, void 0, void 0, function* () {
-            const transport = new StdioServerTransport();
-            yield this.server.connect(transport);
-            console.error('Bkper MCP server running on stdio');
+            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
@@ -109,6 +153,9 @@ 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(console.error);
+    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 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,59 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,163 @@
+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

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

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

@@ -0,0 +1,40 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

package/lib/mcp/tools/merge_transactions.js

@@ -0,0 +1,120 @@
+/**
+ * MCP Tool: merge_transactions
+ *
+ * Thin adapter that handles MCP protocol concerns (validation, error handling, response formatting)
+ * and delegates business logic to the domain layer.
+ */
+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 { TransactionMergeOperation } from '../domain/transaction/merge-operation.js';
+export function handleMergeTransactions(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.transactionId1) {
+                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: transactionId1');
+            }
+            if (!params.transactionId2) {
+                throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: transactionId2');
+            }
+            // 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}`);
+            }
+            // Fetch both transactions
+            const transaction1 = yield book.getTransaction(params.transactionId1);
+            if (!transaction1) {
+                throw new McpError(ErrorCode.InvalidParams, `Transaction not found: ${params.transactionId1}`);
+            }
+            const transaction2 = yield book.getTransaction(params.transactionId2);
+            if (!transaction2) {
+                throw new McpError(ErrorCode.InvalidParams, `Transaction not found: ${params.transactionId2}`);
+            }
+            // Perform merge operation
+            const mergeOperation = new TransactionMergeOperation(book, transaction1, transaction2);
+            // Execute the merge: trash the revert transaction
+            yield mergeOperation.revertTransaction.trash();
+            // Apply merged data to edit transaction (only needed for real API, not mocks)
+            if (typeof mergeOperation.editTransaction.setDescription === 'function') {
+                mergeOperation.applyMergedData();
+                // Update the edit transaction with merged data
+                yield mergeOperation.editTransaction.update();
+            }
+            // Return the merged data
+            const _a = mergeOperation.mergedData, { agentId, agentName, agentLogo, agentLogoDark, createdAt, createdBy, updatedAt, dateValue } = _a, cleanTransaction = __rest(_a, ["agentId", "agentName", "agentLogo", "agentLogoDark", "createdAt", "createdBy", "updatedAt", "dateValue"]);
+            // Build response
+            const response = {
+                mergedTransaction: JSON.parse(JSON.stringify(cleanTransaction)),
+                revertedTransactionId: mergeOperation.revertTransaction.getId() || '',
+                auditRecord: null // Always null - we throw error if amounts differ
+            };
+            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
+            console.error('Merge transactions error details:', error);
+            throw new McpError(ErrorCode.InternalError, `Failed to merge transactions: ${error instanceof Error ? error.message : JSON.stringify(error)}`);
+        }
+    });
+}
+export const mergeTransactionsToolDefinition = {
+    name: 'merge_transactions',
+    description: 'Merge two duplicate or related transactions into a single consolidated transaction. Intelligently combines descriptions, attachments, amounts, and metadata while marking one transaction as reverted.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            bookId: {
+                type: 'string',
+                description: 'The unique identifier of the book'
+            },
+            transactionId1: {
+                type: 'string',
+                description: 'The ID of the first transaction to merge'
+            },
+            transactionId2: {
+                type: 'string',
+                description: 'The ID of the second transaction to merge'
+            }
+        },
+        required: ['bookId', 'transactionId1', 'transactionId2']
+    }
+};
+//# sourceMappingURL=merge_transactions.js.map

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

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

package/package.json

@@ -1,79 +1,79 @@
 {
-  "name": "bkper",
-  "version": "3.5.5",
-  "description": "Node.js command line client for Bkper",
-  "bin": {
-    "bkper": "./lib/cli.js"
-  },
-  "repository": "https://github.com/bkper/bkper-node.git",
-  "homepage": "https://bkper.com/docs",
-  "author": "mael <mael@bkper.com>",
-  "license": "Apache-2.0",
-  "private": false,
-  "main": "./lib/index.js",
-  "module": "./lib/index.js",
-  "types": "./lib/index.d.ts",
-  "type": "module",
-  "files": [
-    "lib/**/*"
-  ],
-  "mcp": {
-    "server": {
-      "command": "node",
-      "args": [
-        "lib/cli.js",
-        "mcp",
-        "start"
-      ],
-      "env": {}
+    "name": "bkper",
+    "version": "3.6.0",
+    "description": "Node.js command line client for Bkper",
+    "bin": {
+        "bkper": "./lib/cli.js"
+    },
+    "repository": "https://github.com/bkper/bkper-node.git",
+    "homepage": "https://bkper.com/docs",
+    "author": "mael <mael@bkper.com>",
+    "license": "Apache-2.0",
+    "private": false,
+    "main": "./lib/index.js",
+    "module": "./lib/index.js",
+    "types": "./lib/index.d.ts",
+    "type": "module",
+    "files": [
+        "lib/**/*"
+    ],
+    "mcp": {
+        "server": {
+            "command": "node",
+            "args": [
+                "lib/cli.js",
+                "mcp",
+                "start"
+            ],
+            "env": {}
+        }
+    },
+    "scripts": {
+        "clean": "rm -rf ./lib & rm -rf ./node_modules & wait",
+        "prebuild": "bun install",
+        "build": "run-s build:*",
+        "build:clean": "gts clean && rimraf temp",
+        "build:compile": "tsc",
+        "build:copy-docs": "mkdir -p lib/docs && cp -f docs/*.md lib/docs/ 2>/dev/null || true",
+        "build:copy-mcp-assets": "mkdir -p lib/mcp && cp -f src/mcp/*.md lib/mcp/ 2>/dev/null || true",
+        "predev": "bun run build",
+        "dev": "bun run build && npx concurrently \"tsc -w\" \"./scripts/dev-mcp.sh\"",
+        "mcp": "bun run build && node lib/cli.js mcp start",
+        "ports": "devpod ssh ../ -L 6274",
+        "test": "TS_NODE_PROJECT=tsconfig.test.json mocha",
+        "test:unit": "TS_NODE_PROJECT=tsconfig.test.json mocha --config .mocharc.json",
+        "test:integration": "TS_NODE_PROJECT=tsconfig.test.json mocha --config .mocharc.integration.json",
+        "test:all": "bun run test:unit && bun run test:integration",
+        "upgrade:api": "bun update @bkper/bkper-api-types --latest && bun update bkper-js --latest",
+        "patch": "yarn version --patch",
+        "minor": "yarn version --minor",
+        "major": "yarn version --major",
+        "preversion": "bun run build",
+        "postversion": "git push --tags && yarn publish --new-version $npm_package_version && git push && echo \"Successfully released version $npm_package_version!\""
+    },
+    "dependencies": {
+        "@google-cloud/local-auth": "^3.0.1",
+        "@modelcontextprotocol/sdk": "^1.13.1",
+        "bkper-js": "^2.4.0",
+        "commander": "^6.2.1",
+        "dotenv": "^8.2.0",
+        "google-auth-library": "^9.14.0",
+        "yaml": "^2.5.1"
+    },
+    "devDependencies": {
+        "@bkper/bkper-api-types": "^5.23.0",
+        "@types/chai": "^4.3.0",
+        "@types/mocha": "^10.0.0",
+        "@types/node": "^22.5.1",
+        "chai": "^4.3.0",
+        "concurrently": "^8.2.2",
+        "gts": "^3.0.3",
+        "mocha": "^10.0.0",
+        "nodemon": "^3.0.1",
+        "npm-run-all": "^4.1.5",
+        "rimraf": "^3.0.2",
+        "ts-node": "^10.9.2",
+        "tsconfig-paths": "^4.2.0",
+        "typescript": "^5.5.4"
     }
-  },
-  "scripts": {
-    "clean": "rm -rf ./lib & rm -rf ./node_modules & wait",
-    "prebuild": "bun install",
-    "build": "run-s build:*",
-    "build:clean": "gts clean && rimraf temp",
-    "build:compile": "tsc",
-    "build:copy-docs": "mkdir -p lib/docs && cp -f docs/*.md lib/docs/ 2>/dev/null || true",
-    "build:copy-mcp-assets": "mkdir -p lib/mcp && cp -f src/mcp/*.md lib/mcp/ 2>/dev/null || true",
-    "predev": "bun run build",
-    "dev": "bun run build && npx concurrently \"tsc -w\" \"./scripts/dev-mcp.sh\"",
-    "mcp": "bun run build && node lib/cli.js mcp start",
-    "test": "TS_NODE_PROJECT=tsconfig.test.json mocha",
-    "test:unit": "TS_NODE_PROJECT=tsconfig.test.json mocha --config .mocharc.json",
-    "test:integration": "TS_NODE_PROJECT=tsconfig.test.json mocha --config .mocharc.integration.json",
-    "test:all": "bun run test:unit && bun run test:integration",
-    "upgrade:api": "bun update @bkper/bkper-api-types --latest && bun update bkper-js --latest",
-    "patch": "yarn version --patch",
-    "minor": "yarn version --minor",
-    "major": "yarn version --major",
-    "preversion": "bun run build",
-    "postversion": "git push --tags && yarn publish --new-version $npm_package_version && git push && echo \"Successfully released version $npm_package_version!\""
-  },
-  "dependencies": {
-    "@google-cloud/local-auth": "^3.0.1",
-    "@modelcontextprotocol/sdk": "^1.13.1",
-    "bkper-js": "^2.4.0",
-    "commander": "^6.2.1",
-    "dotenv": "^8.2.0",
-    "google-auth-library": "^9.14.0",
-    "yaml": "^2.5.1"
-  },
-  "devDependencies": {
-    "@bkper/bkper-api-types": "^5.23.0",
-    "@types/chai": "^4.3.0",
-    "@types/commander": "^2.12.2",
-    "@types/mocha": "^10.0.0",
-    "@types/node": "^22.5.1",
-    "chai": "^4.3.0",
-    "concurrently": "^8.2.2",
-    "gts": "^3.0.3",
-    "mocha": "^10.0.0",
-    "nodemon": "^3.0.1",
-    "npm-run-all": "^4.1.5",
-    "rimraf": "^3.0.2",
-    "ts-node": "^10.9.2",
-    "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.5.4"
-  }
 }