@kirjapro/mcp-server 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## [Unreleased]
+
+## [0.14.0] - 2026-10-05
+
+Prepared, not yet published. Publish only after (1) `db:deploy` of the round-3
+migrations `20261005170000`–`20261005200000` (AI-työtila 2.0 batches 10–13;
+`kirjapro_send_invoice` needs `20261005180100`, the delivery intents), (2)
+`npm run functions:deploy -- dispatch-invoice` from the same main, which resumes a
+delivery under its intent, and (3) a commit of `src/database.types.ts` regenerated
+from production with `--schema public`, so `check:types-drift` passes. Until then
+0.13.0 keeps working unchanged against the current database.
+
+- `kirjapro_get_ar_aging` shares its result shaping with Kirjapro; an unexpected
+  report payload now returns a sanitized error instead of an internal exception.
+- `kirjapro_create_invoice`: `paymentTermDays` has no schema default any more, so
+  the customer's own payment term applies before 14 days (0.13.0 always used 14).
+  `vatRate` defaults to `25.5` only when a line has no `vatTreatmentCode`; an
+  explicit rate that contradicts the code is refused as `VAT_RATE_MISMATCH`
+  instead of the code winning silently. Lines take `discountPercent` (0–100, two
+  decimals, before VAT), and the historical `24`/`14` rates
+  (`legacy_standard_24` until 31.8.2024, `legacy_standard_14` until 31.12.2025)
+  are accepted inside their windows. Fingerprint changes.
+- `kirjapro_send_invoice` caches only a confirmed result. A lost transport, relay
+  error, 5xx or a delivery whose provider outcome is still pending returns
+  `IDEMPOTENCY_OUTCOME_UNKNOWN` and leaves the claim pending; 0.13.0 cached it as a
+  failure, which invited a retry with a new key. A confirmed refusal returns
+  `CODE: viesti` and a send returns `delivery_id`. Needs the database migration
+  `20261005180100` and the matching `dispatch-invoice` deploy (delivery intents).
+- The generated copies `src/compliance/purchase-vat-allocation.ts`,
+  `src/compliance/date-local.ts` and the new `src/shared/invoice-delivery.ts` are
+  byte-guarded by the test suite like `src/shared/invoice-draft.ts`.
+- `kirjapro_search_transactions` with `minAmount` or `maxAmount` returns
+  `FILTER_TOO_BROAD: …` when more than 1 000 transactions (or an unknown number)
+  match the other filters, instead of filtering only the first 1 000 and
+  reporting that sample's size as `total_count`. Up to 1 000 matches the count
+  stays exact. Narrow `dateFrom`/`dateTo` or `query` to search further.
+
 ## [0.13.0] - 2026-10-04
 
 No database prerequisite: every function, rule and VAT treatment it uses was

package/dist/index.js

@@ -4625,7 +4625,7 @@ var require_core = __commonJS({
       errorsText(errors = this.errors, { separator = ", ", dataVar = "data" } = {}) {
         if (!errors || errors.length === 0)
           return "No errors";
-        return errors.map((e) => `${dataVar}${e.instancePath} ${e.message}`).reduce((text, msg) => text + separator + msg);
+        return errors.map((e) => `${dataVar}${e.instancePath} ${e.message}`).reduce((text2, msg) => text2 + separator + msg);
       }
       $dataMetaSchema(metaSchema, keywordsJsonPointers) {
         const rules = this.RULES.all;
@@ -19919,8 +19919,8 @@ function ko_default() {
 }
 
 // node_modules/zod/v4/locales/lt.js
-var capitalizeFirstCharacter = (text) => {
-  return text.charAt(0).toUpperCase() + text.slice(1);
+var capitalizeFirstCharacter = (text2) => {
+  return text2.charAt(0).toUpperCase() + text2.slice(1);
 };
 function getUnitTypeFromNumber(number4) {
   const abs = Math.abs(number4);
@@ -35679,7 +35679,7 @@ var StdioServerTransport = class {
 import { createClient } from "@supabase/supabase-js";
 
 // src/version.ts
-var VERSION = "0.13.0";
+var VERSION = "0.14.0";
 
 // src/auth.ts
 var SUPABASE_PROJECT_URL = "https://tifewzsimmyoiepblhld.supabase.co";
@@ -36017,15 +36017,15 @@ function resultErrorCode(result) {
   const match = textPart?.text.match(/^([A-Z][A-Z0-9_]{1,63}):/);
   const candidate = match?.[1];
   if (candidate && SAFE_TOOL_ERROR_CODES.has(candidate)) return candidate;
-  const text = (textPart?.text ?? "").replace(/^MCP error -?\d+: /, "");
-  if (text.startsWith("Input validation error:")) return "INVALID_ARGUMENTS";
-  if (text.startsWith("Output validation error:")) {
+  const text2 = (textPart?.text ?? "").replace(/^MCP error -?\d+: /, "");
+  if (text2.startsWith("Input validation error:")) return "INVALID_ARGUMENTS";
+  if (text2.startsWith("Output validation error:")) {
     return "OUTPUT_VALIDATION_ERROR";
   }
-  if (text.startsWith("Tool ") && text.endsWith(" not found")) {
+  if (text2.startsWith("Tool ") && text2.endsWith(" not found")) {
     return "UNKNOWN_TOOL";
   }
-  if (text.startsWith("Tool ") && text.endsWith(" disabled")) {
+  if (text2.startsWith("Tool ") && text2.endsWith(" disabled")) {
     return "TOOL_DISABLED";
   }
   return "TOOL_ERROR";
@@ -36217,11 +36217,11 @@ function instrumentToolCalls(server2, options) {
 }
 
 // src/utils.ts
-function formatCurrency(amount) {
+function formatCurrency(amount2) {
   return new Intl.NumberFormat("fi-FI", {
     style: "currency",
     currency: "EUR"
-  }).format(amount);
+  }).format(amount2);
 }
 function helsinkiDateString(now = /* @__PURE__ */ new Date()) {
   const parts = new Intl.DateTimeFormat("fi-FI", {
@@ -36363,8 +36363,8 @@ async function invokeEdgeFunction(supabase2, name, body) {
   }
   return { data, error: null };
 }
-function roundCents(amount) {
-  return Math.round(amount * 100) / 100;
+function roundCents(amount2) {
+  return Math.round(amount2 * 100) / 100;
 }
 var ZERO_WIDTH = /[\u200B-\u200D\u2060\uFEFF]/g;
 var CONTROL = /[\u0000-\u001F\u007F]/g;
@@ -36818,6 +36818,13 @@ function registerTransactionTools(server2) {
           "Failed to search transactions. Check your filters and try again."
         );
       }
+      const knownCount = Number.isSafeInteger(count) ? count : null;
+      if (hasAmountFilter && (knownCount === null || knownCount > AMOUNT_FILTER_CAP)) {
+        const matches = knownCount !== null ? `${knownCount} match the other filters` : "the number matching the other filters is unknown";
+        return toErrorContent(
+          `FILTER_TOO_BROAD: Amount filters read at most ${AMOUNT_FILTER_CAP} transactions, and ${matches}. Narrow dateFrom/dateTo or query; no partial count is returned.`
+        );
+      }
       let results = (data || []).map(
         (t) => {
           const totalDebit = roundCents(
@@ -36858,10 +36865,9 @@ function registerTransactionTools(server2) {
         }
         const filteredTotal = results.length;
         const paginatedResults = results.slice(offset, offset + limit);
-        const cappedWarning = (count || 0) >= AMOUNT_FILTER_CAP ? " (results capped at 1000 rows \u2014 narrow your date range for complete results)" : "";
         return toResult({
           ...paginate(paginatedResults, filteredTotal, offset, limit),
-          amount_filter_note: `Filtered client-side from ${count || 0} transactions${cappedWarning}`
+          amount_filter_note: `Filtered client-side from ${count} transactions`
         });
       }
       return toResult(paginate(results, count || 0, offset, limit));
@@ -37312,15 +37318,17 @@ var INVOICE_VAT_TREATMENT_CODES = [
   "exempt_education",
   "exempt_financial",
   "exempt_insurance",
-  "exempt_other"
+  "exempt_other",
+  "legacy_standard_24",
+  "legacy_standard_14"
 ];
-var INVOICE_VAT_RATES = ["25.5", "13.5", "10", "0"];
+var INVOICE_VAT_RATES = ["25.5", "13.5", "10", "0", "24", "14"];
 var INVOICE_DRAFT_MAX_LINES = 100;
 var INVOICE_DRAFT_CUSTOMER_COLUMNS = "id, name, payment_term_days, customer_kind, business_id, vat_number, country";
 var ERROR_MESSAGES = {
   INVALID_INPUT: (detail) => `Laskun tiedoissa on virhe: ${detail}.`,
   CUSTOMER_NOT_FOUND: (detail) => `Asiakasta ei l\xF6ydy t\xE4st\xE4 yrityksest\xE4${detail ? ` (${detail})` : ""}.`,
-  CUSTOMER_AMBIGUOUS: (detail) => `Useita asiakkaita osuu hakuun: ${detail}. Tarkenna nime\xE4.`,
+  CUSTOMER_AMBIGUOUS: (detail) => `Asiakas pit\xE4\xE4 valita t\xE4sm\xE4llisesti: ${detail}. K\xE4yt\xE4 t\xE4sm\xE4llist\xE4 nime\xE4 tai asiakasnumeroa.`,
   LOOKUP_FAILED: () => "Laskun tietojen haku ep\xE4onnistui. Mit\xE4\xE4n ei tallennettu; voit yritt\xE4\xE4 uudelleen.",
   FISCAL_YEAR_REQUIRED: () => "Ei tilikautta valittuna.",
   FISCAL_YEAR_NOT_FOUND: () => "Tilikautta ei l\xF6ydy. Tarkista valinta.",
@@ -37329,6 +37337,7 @@ var ERROR_MESSAGES = {
   VAT_SELLER_NOT_REGISTERED: () => "ALV-rekisteriin kuulumaton myyj\xE4 voi k\xE4ytt\xE4\xE4 vain Ei ALV-rekisteriss\xE4 -k\xE4sittely\xE4.",
   VAT_SELLER_REGISTERED: () => "ALV-rekisteriss\xE4 oleva myyj\xE4 ei voi k\xE4ytt\xE4\xE4 Ei ALV-rekisteriss\xE4 -k\xE4sittely\xE4.",
   VAT_RATE_NOT_IN_FORCE: (detail) => `ALV-kanta ${detail}.`,
+  VAT_RATE_MISMATCH: (detail) => `ALV-kanta ja ALV-k\xE4sittely ovat ristiriidassa (${detail}). Anna vain k\xE4sittely tai sit\xE4 vastaava kanta.`,
   VAT_REQUIRES_BUSINESS_CUSTOMER: () => "Valittu ALV-k\xE4sittely vaatii yritysasiakkaan.",
   VAT_REQUIRES_FINNISH_BUSINESS_ID: () => "Kotimainen k\xE4\xE4nnetty verovelvollisuus vaatii ostajan kelvollisen Y-tunnuksen.",
   VAT_REQUIRES_EU_VAT_NUMBER: () => "EU-myynti vaatii muun EU-maan maakoodin ja sit\xE4 vastaavan ostajan ALV-tunnisteen.",
@@ -37353,9 +37362,9 @@ function roundNumericMoney(value) {
   const digits = Math.abs(value).toPrecision(15);
   if (digits.includes("e")) return 0;
   const [whole = "0", fraction = ""] = digits.split(".");
-  const cents2 = Number(whole) * 100 + Number(fraction.slice(0, 2).padEnd(2, "0")) + (Number(fraction.charAt(2) || "0") >= 5 ? 1 : 0);
-  if (cents2 === 0) return 0;
-  return value < 0 ? -cents2 / 100 : cents2 / 100;
+  const cents3 = Number(whole) * 100 + Number(fraction.slice(0, 2).padEnd(2, "0")) + (Number(fraction.charAt(2) || "0") >= 5 ? 1 : 0);
+  if (cents3 === 0) return 0;
+  return value < 0 ? -cents3 / 100 : cents3 / 100;
 }
 function calculateLineTotals(quantity, unitPrice, vatRate, priceEntryMode = "vat_exclusive", discountPercent = 0) {
   const discountFactor = 1 - discountPercent / 100;
@@ -37399,17 +37408,24 @@ function addDaysIso(date5, days) {
 var TREATMENT_RATES = {
   standard_25_5: 25.5,
   standard_13_5: 13.5,
-  standard_10: 10
+  standard_10: 10,
+  legacy_standard_24: 24,
+  legacy_standard_14: 14
 };
 var STANDARD_TREATMENTS = {
   "25.5": "standard_25_5",
   "13.5": "standard_13_5",
-  "10": "standard_10"
+  "10": "standard_10",
+  "24": "legacy_standard_24",
+  "14": "legacy_standard_14"
 };
 function resolveInvoiceVatTreatment(vatRate, code) {
   const resolved = code ?? (vatRate === void 0 ? void 0 : STANDARD_TREATMENTS[vatRate]);
   if (!resolved) return invoiceDraftError("VAT_TREATMENT_REQUIRED");
-  return { code: resolved, rate: TREATMENT_RATES[resolved] ?? 0 };
+  const rate = TREATMENT_RATES[resolved] ?? 0;
+  if (vatRate !== void 0 && Number(vatRate) !== rate)
+    return invoiceDraftError("VAT_RATE_MISMATCH", `${vatRate} % ja ${resolved}`);
+  return { code: resolved, rate };
 }
 var EU_COUNTRY_CODES = [
   "AT",
@@ -37461,6 +37477,10 @@ function invoiceVatTreatmentError(code, sellerAlvRegistered, customer, documentD
     return invoiceDraftError("VAT_RATE_NOT_IN_FORCE", "25,5 % ei ole voimassa ennen 1.9.2024");
   if (code === "standard_13_5" && documentDate < "2026-01-01")
     return invoiceDraftError("VAT_RATE_NOT_IN_FORCE", "13,5 % ei ole voimassa ennen 1.1.2026");
+  if (code === "legacy_standard_24" && documentDate > "2024-08-31")
+    return invoiceDraftError("VAT_RATE_NOT_IN_FORCE", "24 % on voimassa vain 31.8.2024 asti");
+  if (code === "legacy_standard_14" && documentDate > "2025-12-31")
+    return invoiceDraftError("VAT_RATE_NOT_IN_FORCE", "14 % on voimassa vain 31.12.2025 asti");
   if ((code.startsWith("reverse_") || code === "intra_eu_goods" || code === "service_outside_eu") && customer.customer_kind !== "business")
     return invoiceDraftError("VAT_REQUIRES_BUSINESS_CUSTOMER");
   if ((code === "reverse_construction" || code === "reverse_scrap") && !isFinnishBusinessId(customer.business_id ?? ""))
@@ -37496,6 +37516,9 @@ function inputError(input2) {
     if (!Number.isFinite(line.unitPrice) || line.unitPrice < 0 || line.unitPrice > 1e9)
       return `${row}: yksikk\xF6hinnan pit\xE4\xE4 olla 0\u20131 000 000 000 \u20AC`;
     if (line.quantity * line.unitPrice > 1e12) return `${row}: rivin summa on liian suuri`;
+    const discount = line.discountPercent;
+    if (discount !== void 0 && (!Number.isFinite(discount) || discount < 0 || discount > 100 || Math.abs(discount * 100 - Math.round(discount * 100)) > 1e-9))
+      return `${row}: alennuksen pit\xE4\xE4 olla 0\u2013100 % enint\xE4\xE4n kahdella desimaalilla`;
   }
   return null;
 }
@@ -37514,11 +37537,13 @@ function prepareInvoiceDraft(input2, facts) {
       input2.invoiceDate
     );
     if (ineligible) return { ok: false, error: ineligible };
+    const discountPercent = line.discountPercent ?? 0;
     const amounts = calculateLineTotals(
       line.quantity,
       line.unitPrice,
       treatment.rate,
-      input2.priceEntryMode
+      input2.priceEntryMode,
+      discountPercent
     );
     lines.push({
       line_number: index + 1,
@@ -37527,6 +37552,7 @@ function prepareInvoiceDraft(input2, facts) {
       unit: line.unit,
       unit_price: line.unitPrice,
       entered_unit_price: line.unitPrice,
+      discount_percent: discountPercent,
       vat_rate: treatment.rate,
       vat_treatment_code: treatment.code,
       vat_treatment_overridden: true,
@@ -37633,6 +37659,47 @@ function calculateInvoiceBalance(total2, payments, creditedTotal) {
   return { paidTotal, remainingBalance: roundCents(total2 - paidTotal - creditedTotal) };
 }
 
+// src/shared/invoice-delivery.ts
+var MESSAGES = {
+  INVOICE_NOT_FOUND: "Laskua ei l\xF6ydy t\xE4st\xE4 yrityksest\xE4. Tarkista laskun numero.",
+  INVOICE_NOT_DRAFT: "Vain luonnostilassa olevan laskun voi l\xE4hett\xE4\xE4. Laskua ei l\xE4hetetty.",
+  DELIVERY_RECIPIENT_MISSING: "Asiakkaalta puuttuu valitun kanavan vastaanottaja (s\xE4hk\xF6postiosoite tai verkkolaskuosoite ja operaattori). Laskua ei l\xE4hetetty.",
+  DELIVERY_CHANGED: "Laskun sis\xE4lt\xF6 tai vastaanottaja muuttui hyv\xE4ksynn\xE4n j\xE4lkeen. Laskua ei l\xE4hetetty; pyyd\xE4 l\xE4hetys uudelleen.",
+  DELIVERY_IN_PROGRESS: "Laskun l\xE4hetys on jo k\xE4sittelyss\xE4 toisessa pyynn\xF6ss\xE4. Tarkista laskun tila ennen uutta yrityst\xE4.",
+  DELIVERY_FAILED: "Laskun l\xE4hetys ep\xE4onnistui. Laskua ei l\xE4hetetty.",
+  DELIVERY_OUTCOME_UNKNOWN: "L\xE4hetyksen tila on ep\xE4varma. \xC4l\xE4 l\xE4het\xE4 laskua uudelleen ennen kuin olet tarkistanut sen tilan.",
+  DELIVERY_UNAVAILABLE: "Laskun l\xE4hetys ei ole k\xE4ytett\xE4viss\xE4 AI-chatissa.",
+  DELIVERY_STOPPED: "L\xE4hetyst\xE4 ei tehty: keskustelun ty\xF6 p\xE4\xE4ttyi tai pys\xE4ytettiin ennen l\xE4hetyst\xE4."
+};
+function invoiceDeliveryMessage(code) {
+  return MESSAGES[code];
+}
+var KNOWN_CODES = Object.keys(MESSAGES);
+function invoiceDeliveryErrorCode(value) {
+  return typeof value === "string" && KNOWN_CODES.includes(value) ? value : "DELIVERY_FAILED";
+}
+var text = (value) => typeof value === "string" && value ? value : null;
+function classifyInvoiceDelivery(response) {
+  const body = response.body && typeof response.body === "object" ? response.body : null;
+  const deliveryId = text(body?.deliveryId);
+  const unknown2 = { status: "unknown", deliveryId, errorCode: "DELIVERY_OUTCOME_UNKNOWN" };
+  if (response.httpStatus === 200 && body) {
+    if (body.deliveryStatus === "sent" && body.success === true)
+      return {
+        status: "sent",
+        deliveryId,
+        transmissionId: text(body.transmissionId),
+        messageId: text(body.messageId)
+      };
+    if (body.deliveryStatus === "failed")
+      return { status: "failed", deliveryId, errorCode: invoiceDeliveryErrorCode(body.errorCode) };
+    return unknown2;
+  }
+  if (response.httpStatus !== null && response.httpStatus >= 400 && response.httpStatus < 500)
+    return { status: "failed", deliveryId, errorCode: "DELIVERY_FAILED" };
+  return unknown2;
+}
+
 // src/tools/invoices.ts
 var LIST_INVOICES_ROW_SHAPE = {
   id: external_exports.string().uuid(),
@@ -37688,7 +37755,7 @@ var GET_INVOICE_OUTPUT_SHAPE = {
 var CREATE_INVOICE_INPUT_SHAPE = {
   customerId: external_exports.string().uuid().describe("Customer UUID"),
   invoiceDate: ISO_DATE_SCHEMA.describe("Invoice date (YYYY-MM-DD)"),
-  paymentTermDays: external_exports.number().min(0).max(365).default(14).describe("Payment term in days (default 14)"),
+  paymentTermDays: external_exports.number().min(0).max(365).optional().describe("Payment term in days (default: the customer's payment term, else 14)"),
   notes: external_exports.string().max(2e3).optional().describe("Notes printed on the invoice"),
   priceEntryMode: external_exports.enum(["vat_exclusive", "vat_inclusive"]).default("vat_exclusive").describe("Whether entered unit prices exclude or include VAT"),
   reverseChargeConfirmed: external_exports.boolean().default(false).describe("Explicit document-level confirmation that the business buyer qualifies for the selected reverse-charge treatment"),
@@ -37702,7 +37769,8 @@ var CREATE_INVOICE_INPUT_SHAPE = {
       quantity: external_exports.number().finite().positive().max(1e6).describe("Quantity (must be > 0)"),
       unit: external_exports.string().max(20).default("kpl").describe("Unit (kpl, h, kk, etc.)"),
       unitPrice: external_exports.number().finite().min(0).max(1e9).describe("Entered unit price in EUR (must be >= 0)"),
-      vatRate: external_exports.enum(INVOICE_VAT_RATES).default("25.5").describe("VAT rate"),
+      vatRate: external_exports.enum(INVOICE_VAT_RATES).optional().describe("VAT rate (default 25.5 when no vatTreatmentCode is given). Must match the treatment's rate when both are given. 24 and 14 are historical rates (until 31.8.2024 and 31.12.2025)"),
+      discountPercent: external_exports.number().min(0).max(100).optional().describe("Line discount in percent (0-100, at most two decimals), applied before VAT"),
       vatTreatmentCode: external_exports.enum(INVOICE_VAT_TREATMENT_CODES).optional().describe("Structured VAT treatment. Required when VAT rate is 0. service_outside_eu is ONLY for AVL 65 general-rule B2B services: verify business use, evidence of buyer status and receiving establishment outside the EU; special place-of-supply services are excluded. Check foreign buyer liability and invoice notes. PDF delivery only; e-invoice delivery is blocked.")
     })
   ).min(1).max(MAX_DOCUMENT_LINES).describe(`Invoice line items (max ${MAX_DOCUMENT_LINES})`),
@@ -37727,7 +37795,10 @@ async function createInvoiceDraftCommand(ctx, params) {
       notes: params.notes,
       reverseChargeConfirmed: params.reverseChargeConfirmed,
       euGoodsTransportConfirmed: params.euGoodsTransportConfirmed,
-      lines: params.lines
+      // A rate defaults to 25.5 only when neither a rate nor a treatment is given.
+      lines: params.lines.map(
+        (line) => line.vatRate === void 0 && line.vatTreatmentCode === void 0 ? { ...line, vatRate: "25.5" } : line
+      )
     },
     { sellerAlvRegistered: company.alv_registered, customer }
   );
@@ -37775,6 +37846,51 @@ async function createInvoiceDraftCommand(ctx, params) {
     }
   });
 }
+async function sendInvoiceCommand(ctx, params) {
+  const { data: invoice, error: invoiceError } = await ctx.supabase.from("invoices").select("id, invoice_number, status").eq("id", params.invoiceId).eq("company_id", ctx.companyId).maybeSingle();
+  if (invoiceError || !invoice) {
+    return toErrorContent(`Invoice ${params.invoiceId} not found.`);
+  }
+  if (invoice.status !== "draft") {
+    return toErrorContent(
+      `Invoice ${invoice.invoice_number} cannot be delivered from status "${invoice.status}". Only draft invoices can be sent.`
+    );
+  }
+  let httpStatus = null;
+  let body = null;
+  try {
+    const { data, error: error61, response } = await ctx.supabase.functions.invoke("dispatch-invoice", {
+      body: { invoiceId: invoice.id, channel: params.channel }
+    });
+    const failed = error61?.context;
+    if (!error61) {
+      httpStatus = response?.status ?? 200;
+      body = data;
+    } else if (failed instanceof Response) {
+      httpStatus = failed.status;
+      body = await failed.json().catch(() => null);
+    }
+  } catch {
+  }
+  const outcome = classifyInvoiceDelivery({ httpStatus, body });
+  if (outcome.status === "unknown") {
+    return toWriteOutcomeUnknown("kirjapro_send_invoice", "kirjapro_get_invoice");
+  }
+  if (outcome.status === "failed") {
+    const detail = body && typeof body === "object" && typeof body.error === "string" ? body.error : invoiceDeliveryMessage(outcome.errorCode);
+    return toErrorContent(`${outcome.errorCode}: ${detail}`);
+  }
+  return toResult({
+    message: `Invoice ${invoice.invoice_number} delivered via ${params.channel}`,
+    invoice_id: invoice.id,
+    invoice_number: invoice.invoice_number,
+    channel: params.channel,
+    delivery_id: outcome.deliveryId,
+    transmission_id: outcome.transmissionId,
+    message_id: outcome.messageId,
+    status: "sent"
+  });
+}
 function registerInvoiceTools(server2) {
   server2.registerTool(
     "kirjapro_list_invoices",
@@ -37854,42 +37970,14 @@ function registerInvoiceTools(server2) {
       annotations: WRITE_EXTERNAL_ANNOTATIONS
     },
     async (params) => {
-      const supabase2 = getSupabase();
-      const companyId2 = getCompanyId();
+      const ctx = { supabase: getSupabase(), companyId: getCompanyId() };
       return withIdempotency(
-        supabase2,
-        companyId2,
+        ctx.supabase,
+        ctx.companyId,
         "kirjapro_send_invoice",
         params.idempotencyKey,
         params,
-        async () => {
-          const { data: invoice, error: invoiceError } = await supabase2.from("invoices").select("id, invoice_number, status").eq("id", params.invoiceId).eq("company_id", companyId2).maybeSingle();
-          if (invoiceError || !invoice) {
-            return toErrorContent(`Invoice ${params.invoiceId} not found.`);
-          }
-          if (invoice.status !== "draft") {
-            return toErrorContent(
-              `Invoice ${invoice.invoice_number} cannot be delivered from status "${invoice.status}". Only draft invoices can be sent.`
-            );
-          }
-          const { data, error: error61 } = await supabase2.functions.invoke("dispatch-invoice", {
-            body: { invoiceId: invoice.id, channel: params.channel }
-          });
-          if (error61 || !data?.success) {
-            return toErrorContent(
-              data?.error || error61?.message || `Failed to deliver invoice ${invoice.invoice_number}.`
-            );
-          }
-          return toResult({
-            message: `Invoice ${invoice.invoice_number} delivered via ${params.channel}`,
-            invoice_id: invoice.id,
-            invoice_number: invoice.invoice_number,
-            channel: data.channel,
-            transmission_id: data.transmissionId ?? null,
-            message_id: data.messageId ?? null,
-            status: "sent"
-          });
-        }
+        () => sendInvoiceCommand(ctx, params)
       );
     }
   );
@@ -38285,9 +38373,9 @@ var PRH_LOOKUP_OUTPUT_SHAPE = {
   website: external_exports.string().nullable(),
   phone: external_exports.string().nullable()
 };
-function sanitizeText(text) {
-  if (!text) return null;
-  return text.trim().replace(/\s+/g, " ").slice(0, 500);
+function sanitizeText(text2) {
+  if (!text2) return null;
+  return text2.trim().replace(/\s+/g, " ").slice(0, 500);
 }
 function registerCustomerTools(server2) {
   server2.registerTool(
@@ -38557,6 +38645,62 @@ function registerCustomerTools(server2) {
   );
 }
 
+// src/shared/ar-aging-report.ts
+var AR_AGING_TOOL = {
+  name: "kirjapro_get_ar_aging",
+  description: "Get an exact, bounded accounts-receivable aging summary as of today in Europe/Helsinki. Outstanding amounts account for partial payments and sent credit notes. Returns aggregate 0-30, 31-60, 61-90, 90+ and missing-due-date buckets; it intentionally does not return an unbounded invoice list.",
+  // Equal to the MCP package's READ_ONLY_ANNOTATIONS (tool fingerprint).
+  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
+};
+var NUMERIC_FIELDS = [
+  "bucket_0_30_count",
+  "bucket_0_30_amount",
+  "bucket_31_60_count",
+  "bucket_31_60_amount",
+  "bucket_61_90_count",
+  "bucket_61_90_amount",
+  "bucket_90_plus_count",
+  "bucket_90_plus_amount",
+  "no_due_date_count",
+  "no_due_date_amount",
+  "total_count",
+  "total_receivables",
+  "weighted_average_days_overdue"
+];
+var cents = (amount2) => Math.round(amount2 * 100) / 100;
+var eur = (amount2) => new Intl.NumberFormat("fi-FI", { style: "currency", currency: "EUR" }).format(amount2);
+var amount = (count, total2) => ({
+  count,
+  total: cents(total2),
+  total_formatted: eur(total2)
+});
+function isRawArAging(data) {
+  if (typeof data !== "object" || data === null || Array.isArray(data)) return false;
+  const row = data;
+  return typeof row.as_of_date === "string" && /^\d{4}-\d{2}-\d{2}$/.test(row.as_of_date) && NUMERIC_FIELDS.every((field) => {
+    const value = row[field];
+    return typeof value === "number" && Number.isFinite(value);
+  });
+}
+function toArAgingReport(data) {
+  if (!isRawArAging(data)) return null;
+  return {
+    as_of_date: data.as_of_date,
+    buckets: [
+      { label: "0-30 days", ...amount(data.bucket_0_30_count, data.bucket_0_30_amount) },
+      { label: "31-60 days", ...amount(data.bucket_31_60_count, data.bucket_31_60_amount) },
+      { label: "61-90 days", ...amount(data.bucket_61_90_count, data.bucket_61_90_amount) },
+      { label: "90+ days", ...amount(data.bucket_90_plus_count, data.bucket_90_plus_amount) }
+    ],
+    no_due_date: amount(data.no_due_date_count, data.no_due_date_amount),
+    total_count: data.total_count,
+    total_receivables: cents(data.total_receivables),
+    total_receivables_formatted: eur(data.total_receivables),
+    weighted_average_days_overdue: data.weighted_average_days_overdue,
+    metric_note: "weighted_average_days_overdue is the amount-weighted age of currently outstanding receivables with a due date; it is not revenue-based DSO."
+  };
+}
+
 // src/compliance/omavero-fields.ts
 var OMAVERO_FIELD_NUMBERS = [
   "301",
@@ -38597,7 +38741,7 @@ var LEGACY_ALV_SUMMARY_KEYS = [
   "reverse_charge_base",
   "omavero"
 ];
-function cents(value) {
+function cents2(value) {
   return Math.round(value * 100) / 100;
 }
 function num(value) {
@@ -38622,7 +38766,7 @@ function omaveroFieldsFromSummary(s) {
     "314": num(s.field_309_base),
     "318": num(s.output_vat_construction_scrap),
     "319": num(s.reverse_charge_sales_base),
-    "320": cents(num(s.field_310_base) + num(s.field_313_base))
+    "320": cents2(num(s.field_310_base) + num(s.field_313_base))
   };
   const map2 = s.omavero;
   if (map2 && typeof map2 === "object") {
@@ -38814,8 +38958,8 @@ function alvReconciliationWarning(reconciliation) {
   if (!reconciliation || typeof reconciliation !== "object") return void 0;
   const r = reconciliation;
   if (r.status !== "mismatch" && r.status !== "explained") return void 0;
-  const amount = (value) => (Number(value) || 0).toFixed(2);
-  return `VAT amounts or the audit trail need review (output VAT difference ${amount(r.output_difference)} \u20AC, input VAT difference ${amount(r.input_difference)} \u20AC). Equal amounts do not link a manual VAT row to a voucher. Review reconciliation before filing; do not duplicate the purchase expense.`;
+  const amount2 = (value) => (Number(value) || 0).toFixed(2);
+  return `VAT amounts or the audit trail need review (output VAT difference ${amount2(r.output_difference)} \u20AC, input VAT difference ${amount2(r.input_difference)} \u20AC). Equal amounts do not link a manual VAT row to a voucher. Review reconciliation before filing; do not duplicate the purchase expense.`;
 }
 var BALANCE_SHEET_ROW_SHAPE = external_exports.object({
   account_number: external_exports.string(),
@@ -39167,12 +39311,12 @@ function registerReportTools(server2) {
     }
   );
   server2.registerTool(
-    "kirjapro_get_ar_aging",
+    AR_AGING_TOOL.name,
     {
-      description: "Get an exact, bounded accounts-receivable aging summary as of today in Europe/Helsinki. Outstanding amounts account for partial payments and sent credit notes. Returns aggregate 0-30, 31-60, 61-90, 90+ and missing-due-date buckets; it intentionally does not return an unbounded invoice list.",
+      description: AR_AGING_TOOL.description,
       inputSchema: {},
       outputSchema: AR_AGING_OUTPUT_SHAPE,
-      annotations: READ_ONLY_ANNOTATIONS
+      annotations: AR_AGING_TOOL.annotations
     },
     async () => {
       const supabase2 = getSupabase();
@@ -39183,32 +39327,8 @@ function registerReportTools(server2) {
       if (error61) {
         return toErrorContent(sanitizeDbError("Failed to get AR aging", error61));
       }
-      const aging = data;
-      const buckets = [
-        { label: "0-30 days", count: aging.bucket_0_30_count, total: aging.bucket_0_30_amount },
-        { label: "31-60 days", count: aging.bucket_31_60_count, total: aging.bucket_31_60_amount },
-        { label: "61-90 days", count: aging.bucket_61_90_count, total: aging.bucket_61_90_amount },
-        { label: "90+ days", count: aging.bucket_90_plus_count, total: aging.bucket_90_plus_amount }
-      ];
-      return toResult({
-        as_of_date: aging.as_of_date,
-        buckets: buckets.map((b) => ({
-          label: b.label,
-          count: b.count,
-          total: roundCents(b.total),
-          total_formatted: formatCurrency(b.total)
-        })),
-        no_due_date: {
-          count: aging.no_due_date_count,
-          total: roundCents(aging.no_due_date_amount),
-          total_formatted: formatCurrency(aging.no_due_date_amount)
-        },
-        total_count: aging.total_count,
-        total_receivables: roundCents(aging.total_receivables),
-        total_receivables_formatted: formatCurrency(aging.total_receivables),
-        weighted_average_days_overdue: aging.weighted_average_days_overdue,
-        metric_note: "weighted_average_days_overdue is the amount-weighted age of currently outstanding receivables with a due date; it is not revenue-based DSO."
-      });
+      const report = toArAgingReport(data);
+      return report ? toResult(report) : toErrorContent("Failed to get AR aging. Please try again.");
     }
   );
   server2.registerTool(
@@ -39340,7 +39460,7 @@ function registerReportTools(server2) {
       const warnings = [
         alvReconciliationWarning(raw.reconciliation),
         Number(raw.unclassified_legacy_reverse_charge_base) ? LEGACY_REVERSE_CHARGE_WARNING : void 0
-      ].filter((text) => Boolean(text));
+      ].filter((text2) => Boolean(text2));
       return toResult({
         ...safeResult,
         ...warnings.length > 0 && { warning: warnings.join(" ") },
@@ -40427,12 +40547,12 @@ async function validateAccountOverrides(overrides) {
   return { ok: true };
 }
 function saleCashTemplate(revenueAccount, vatRate) {
-  return (amount, opts) => {
-    const { net, vat: vat2 } = splitVat(amount, vatRate);
+  return (amount2, opts) => {
+    const { net, vat: vat2 } = splitVat(amount2, vatRate);
     const entries = [
       {
         accountNumber: ACCOUNTS.KASSA,
-        debitAmount: roundCents(amount),
+        debitAmount: roundCents(amount2),
         creditAmount: 0
       },
       { accountNumber: revenueAccount, debitAmount: 0, creditAmount: net }
@@ -40448,12 +40568,12 @@ function saleCashTemplate(revenueAccount, vatRate) {
   };
 }
 function saleBankTemplate(revenueAccount, vatRate) {
-  return (amount, opts) => {
-    const { net, vat: vat2 } = splitVat(amount, vatRate);
+  return (amount2, opts) => {
+    const { net, vat: vat2 } = splitVat(amount2, vatRate);
     const entries = [
       {
         accountNumber: ACCOUNTS.PANKKITILI,
-        debitAmount: roundCents(amount),
+        debitAmount: roundCents(amount2),
         creditAmount: 0
       },
       { accountNumber: revenueAccount, debitAmount: 0, creditAmount: net }
@@ -40526,13 +40646,13 @@ var TEMPLATES = [
     kind: "sale",
     description: "Laskumyynti ALV 25,5% (myyntisaamiset)",
     vatRate: 25.5,
-    expand: (amount, opts) => {
-      const { net, vat: vat2 } = splitVat(amount, 25.5);
+    expand: (amount2, opts) => {
+      const { net, vat: vat2 } = splitVat(amount2, 25.5);
       return applyOverrides(
         [
           {
             accountNumber: ACCOUNTS.MYYNTISAAMISET,
-            debitAmount: roundCents(amount),
+            debitAmount: roundCents(amount2),
             creditAmount: 0
           },
           { accountNumber: ACCOUNTS.MYYNTI_25_5, debitAmount: 0, creditAmount: net },
@@ -40548,8 +40668,8 @@ var TEMPLATES = [
     kind: "purchase",
     description: "Osto ALV 25,5% (pankkitililt\xE4)",
     vatRate: 25.5,
-    expand: (amount, opts) => {
-      const { net, vat: vat2 } = splitVat(amount, 25.5);
+    expand: (amount2, opts) => {
+      const { net, vat: vat2 } = splitVat(amount2, 25.5);
       return applyOverrides(
         [
           { accountNumber: ACCOUNTS.OSTOT, debitAmount: net, creditAmount: 0 },
@@ -40557,7 +40677,7 @@ var TEMPLATES = [
           {
             accountNumber: ACCOUNTS.PANKKITILI,
             debitAmount: 0,
-            creditAmount: roundCents(amount)
+            creditAmount: roundCents(amount2)
           }
         ],
         opts?.accountOverrides
@@ -40569,8 +40689,8 @@ var TEMPLATES = [
     kind: "purchase",
     description: "Ulkopuolinen palvelu ALV 25,5%",
     vatRate: 25.5,
-    expand: (amount, opts) => {
-      const { net, vat: vat2 } = splitVat(amount, 25.5);
+    expand: (amount2, opts) => {
+      const { net, vat: vat2 } = splitVat(amount2, 25.5);
       return applyOverrides(
         [
           { accountNumber: ACCOUNTS.OSTOT_PALVELUT, debitAmount: net, creditAmount: 0 },
@@ -40578,7 +40698,7 @@ var TEMPLATES = [
           {
             accountNumber: ACCOUNTS.PANKKITILI,
             debitAmount: 0,
-            creditAmount: roundCents(amount)
+            creditAmount: roundCents(amount2)
           }
         ],
         opts?.accountOverrides
@@ -40591,17 +40711,17 @@ var TEMPLATES = [
     kind: "other",
     description: "Vuokranmaksu (pankkitililt\xE4)",
     vatRate: null,
-    expand: (amount, opts) => applyOverrides(
+    expand: (amount2, opts) => applyOverrides(
       [
         {
           accountNumber: ACCOUNTS.TOIMITILAVUOKRAT,
-          debitAmount: roundCents(amount),
+          debitAmount: roundCents(amount2),
           creditAmount: 0
         },
         {
           accountNumber: ACCOUNTS.PANKKITILI,
           debitAmount: 0,
-          creditAmount: roundCents(amount)
+          creditAmount: roundCents(amount2)
         }
       ],
       opts?.accountOverrides
@@ -40613,17 +40733,17 @@ var TEMPLATES = [
     kind: "other",
     description: "Tilisiirto kassasta pankkitilille",
     vatRate: null,
-    expand: (amount, opts) => applyOverrides(
+    expand: (amount2, opts) => applyOverrides(
       [
         {
           accountNumber: ACCOUNTS.PANKKITILI,
-          debitAmount: roundCents(amount),
+          debitAmount: roundCents(amount2),
           creditAmount: 0
         },
         {
           accountNumber: ACCOUNTS.KASSA,
           debitAmount: 0,
-          creditAmount: roundCents(amount)
+          creditAmount: roundCents(amount2)
         }
       ],
       opts?.accountOverrides
@@ -40646,17 +40766,17 @@ function isVatPurchaseTemplate(templateId) {
 function availableTemplates(alvRegistered) {
   return alvRegistered ? TEMPLATES.filter((t) => t.kind !== "sale") : TEMPLATES.filter((t) => !isVatPurchaseTemplate(t.id));
 }
-function expandTemplate(templateId, amount, opts) {
+function expandTemplate(templateId, amount2, opts) {
   const template = TEMPLATE_MAP.get(templateId);
   if (!template) {
     return {
       error: `Unknown template "${templateId}". Use kirjapro_list_templates to see available templates.`
     };
   }
-  if (amount <= 0) {
+  if (amount2 <= 0) {
     return { error: "Amount must be positive." };
   }
-  const entries = template.expand(amount, opts);
+  const entries = template.expand(amount2, opts);
   return { entries };
 }
 async function validateFiscalYearForDate(fiscalYearId, transactionDate) {
@@ -41305,8 +41425,8 @@ function registerBookingTools(server2) {
     async (params) => {
       const execute = async () => {
         const rate = Number(params.vatRate);
-        const amount = roundCents(params.amount);
-        if (amount <= 0) return toErrorContent("Oston summan on oltava v\xE4hint\xE4\xE4n yksi sentti.");
+        const amount2 = roundCents(params.amount);
+        if (amount2 <= 0) return toErrorContent("Oston summan on oltava v\xE4hint\xE4\xE4n yksi sentti.");
         const companyVat = await readCompanyVat(getSupabase(), getCompanyId());
         if ("isError" in companyVat) return companyVat;
         if (params.reverseCharge && !params.reverseChargeCategory) return toErrorContent(REVERSE_CHARGE_CATEGORY_REQUIRED);
@@ -41326,7 +41446,7 @@ function registerBookingTools(server2) {
           if (basisError) return toErrorContent(basisError);
         }
         const basis = params.vatRateBasis;
-        const { net, vat: vat2 } = params.reverseCharge ? { net: amount, vat: roundCents(amount * rate / 100) } : splitVat(amount, rate);
+        const { net, vat: vat2 } = params.reverseCharge ? { net: amount2, vat: roundCents(amount2 * rate / 100) } : splitVat(amount2, rate);
         const allocation = allocatePurchaseVat(net, vat2, percent);
         const keepFacts = rate > 0 && (params.reverseCharge || companyVat.alvRegistered && !params.edustus);
         const vatAllocation = percent > 0 && percent < 100 ? {
@@ -41352,13 +41472,13 @@ function registerBookingTools(server2) {
           { accountNumber: params.expenseAccount, debitAmount: expense, creditAmount: 0 },
           { accountNumber: ACCOUNTS.ALV_SAAMISET, debitAmount: allocation.deductibleVat, creditAmount: 0 },
           ...params.reverseCharge ? [{ accountNumber: ACCOUNTS.ALV_VELKA, debitAmount: 0, creditAmount: vat2 }] : [],
-          ...!assessmentOnly ? [{ accountNumber: params.paymentAccount, debitAmount: 0, creditAmount: params.reverseCharge ? net : amount }] : []
+          ...!assessmentOnly ? [{ accountNumber: params.paymentAccount, debitAmount: 0, creditAmount: params.reverseCharge ? net : amount2 }] : []
         ].filter((entry) => entry.debitAmount !== 0 || entry.creditAmount !== 0);
         if (entries.length < 2) return toErrorContent("Tositteen veron on oltava v\xE4hint\xE4\xE4n yksi sentti.");
         const purchaseAccountWarning = expenseAccountWarning(params.expenseAccount);
         const calculation = {
           amount_basis: assessmentOnly ? "customs_tax_base" : params.reverseCharge ? "supplier_net" : "supplier_gross",
-          ...assessmentOnly ? {} : { supplier_amount: params.reverseCharge ? net : amount },
+          ...assessmentOnly ? {} : { supplier_amount: params.reverseCharge ? net : amount2 },
           tax_base: net,
           output_vat: params.reverseCharge ? vat2 : 0,
           source_vat: vat2,
@@ -41369,7 +41489,7 @@ function registerBookingTools(server2) {
         };
         if (params.dryRun) return toDryRunResponse("kirjapro_book_purchase", {
           action: "book_purchase",
-          gross: amount,
+          gross: amount2,
           vat_rate: params.vatRate,
           description: params.description,
           date: params.date,
@@ -43806,7 +43926,7 @@ function registerPrompts(mcpServer) {
       } else {
         fyBlock = "Ei avointa tilikautta \u2014 luo tilikausi ennen kirjausten tekemist\xE4.";
       }
-      const text = [
+      const text2 = [
         `T\xE4m\xE4 on Kirjapro MCP -palvelin (v${VERSION}). Yhdistetty yritys:`,
         "",
         companyBlock,
@@ -43824,7 +43944,7 @@ function registerPrompts(mcpServer) {
         messages: [
           {
             role: "user",
-            content: { type: "text", text }
+            content: { type: "text", text: text2 }
           }
         ]
       };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirjapro/mcp-server",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "MCP server for Finnish accounting — exposes Kirjapro bookkeeping, invoicing, and reporting tools to Claude, ChatGPT, Mistral, and other MCP clients.",
   "type": "module",
   "bin": {

package/server.json

@@ -2,7 +2,7 @@
   "name": "@kirjapro/mcp-server",
   "displayName": "Kirjapro - Finnish Accounting",
   "description": "Finnish double-entry bookkeeping, invoicing, and financial reporting for growing businesses. Create transactions, generate invoices with VAT calculation, produce income statements and balance sheets, and validate Finnish business identifiers.",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "homepage": "https://kirjapro.fi",
   "repository": "https://github.com/Jaollo/kirja-pro",
   "license": "MIT",

package/tool-fingerprints.json

@@ -30,7 +30,7 @@
     },
     {
       "name": "kirjapro_create_invoice",
-      "hash": "f5b9d183f3649ebc"
+      "hash": "67c934bc676e9937"
     },
     {
       "name": "kirjapro_create_offer",