@hoagsmedia/frgur-mcp-server 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.3.1 — 2026-07-06
+
+- **Skip the double AI pass (HOA-423).** `import_receipt_file` now takes an optional `extracted` object (`{vendor, amountCents, date, category?}`) — the fields your AI client already read off the receipt. When provided, frugr uses them directly instead of running (and billing) its own server-side vision extraction. The tool description instructs the model to include it whenever it has seen the receipt. Fields still land in Needs Review for human approval either way.
+
 ## 0.3.0 — 2026-07-06
 
 - **Import receipts from a local file (HOA-416).** New client-side tool `import_receipt_file({ filePath })`: reads a receipt (PDF/JPEG/PNG/WebP/GIF/HEIC, ≤3 MB) from your machine, base64s it, and forwards to frugr's new `propose_expense_from_receipt` server tool. frugr extracts the receipt and either attaches it to the matching unreceipted expense or files a provisional draft in **Needs Review** — never a direct ledger write. Ask your AI client: _"import ~/Downloads/receipt.pdf into my books."_

package/index.mjs

@@ -92,15 +92,35 @@ export function mimeFromExtension(filePath) {
 const IMPORT_RECEIPT_TOOL = {
 	name: 'import_receipt_file',
 	description:
-		'Import a receipt from a file on THIS computer (e.g. ~/Downloads/receipt.pdf). Reads the ' +
-		'file locally and proposes it to frugr, which files it in the Needs Review queue for your ' +
-		'approval. Max 3 MB; PDF, JPEG, PNG, WebP, GIF, or HEIC.',
+		'Import a receipt from a file on the machine running THIS MCP bridge process (e.g. ' +
+		"~/Downloads/receipt.pdf on the user's computer). filePath resolves against the bridge " +
+		"host's filesystem ONLY — paths from a chat-upload sandbox (e.g. /mnt/user-data/uploads/…) " +
+		'or any other machine will NEVER resolve here; do not retry them. For files you can read ' +
+		'but the bridge cannot, call propose_expense_from_receipt with base64 instead (3 MB decoded ' +
+		'cap; downscale large scans first). Max 3 MB; PDF, JPEG, PNG, WebP, GIF, or HEIC. If you ' +
+		'have already seen the receipt contents, ALWAYS include `extracted` — frugr then uses your ' +
+		'reading instead of running (and billing) its own AI extraction.',
 	inputSchema: {
 		type: 'object',
 		properties: {
 			filePath: {
 				type: 'string',
 				description: 'Absolute or ~-relative path to the receipt file on this machine.'
+			},
+			extracted: {
+				type: 'object',
+				description:
+					'The fields you already read off this receipt. Preferred whenever you have seen it.',
+				properties: {
+					vendor: { type: 'string', description: 'Merchant name as printed.' },
+					amountCents: {
+						type: 'integer',
+						description: 'Receipt TOTAL in cents, positive (e.g. $31.03 -> 3103).'
+					},
+					date: { type: 'string', description: 'Receipt date, YYYY-MM-DD.' },
+					category: { type: 'string', description: 'Optional expense category suggestion.' }
+				},
+				required: ['amountCents']
 			}
 		},
 		required: ['filePath']
@@ -132,7 +152,14 @@ async function importReceiptFile(args) {
 	const data = await readFile(filePath);
 	return call('tools/call', {
 		name: 'propose_expense_from_receipt',
-		arguments: { filename: basename(filePath), mimeType, dataBase64: data.toString('base64') }
+		arguments: {
+			filename: basename(filePath),
+			mimeType,
+			dataBase64: data.toString('base64'),
+			...(args?.extracted && typeof args.extracted === 'object'
+				? { extracted: args.extracted }
+				: {})
+		}
 	});
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hoagsmedia/frgur-mcp-server",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"description": "MCP bridge to your frugr books — read tools (P&L, transactions, invoices, bills, reconciliation, time/mileage, snapshots) plus review-queue proposals incl. importing a receipt from a local file. Bring your own AI client.",
 	"type": "module",
 	"bin": {