@kirjapro/mcp-server 0.12.0 → 0.14.0

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.12.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;
@@ -36392,18 +36392,6 @@ function tagCustomer(row) {
   if ("notes" in row) wrapped.notes = tagUntrusted(row.notes);
   return wrapped;
 }
-function addDaysToIsoDate(date5, days) {
-  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(date5);
-  if (!match) {
-    throw new Error(`Invalid ISO date: ${date5}`);
-  }
-  const year = Number.parseInt(match[1], 10);
-  const month = Number.parseInt(match[2], 10);
-  const day = Number.parseInt(match[3], 10);
-  const utcDate = new Date(Date.UTC(year, month - 1, day));
-  utcDate.setUTCDate(utcDate.getUTCDate() + days);
-  return utcDate.toISOString().slice(0, 10);
-}
 function formatFinnishDate(iso) {
   const [y, m, d] = iso.split("-");
   return `${Number.parseInt(d, 10)}.${Number.parseInt(m, 10)}.${y}`;
@@ -36830,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(
@@ -36870,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));
@@ -37307,45 +37301,133 @@ var VALID_TRANSITIONS = {
   cancelled: []
 };
 
-// src/finnish-business-id.ts
-function validateFinnishBusinessIdCore(input2) {
-  const cleaned = input2.replace(/\s/g, "").toUpperCase();
-  const match = cleaned.match(/^(\d{7})-(\d)$/);
-  if (!match) return { valid: false, reason: "format" };
-  const digits = match[1];
-  const actualCheckDigit = Number(match[2]);
-  if (!digits || !Number.isInteger(actualCheckDigit)) {
-    return { valid: false, reason: "format" };
-  }
-  const weights = [7, 9, 10, 5, 8, 4, 2];
-  let sum = 0;
-  for (let index = 0; index < weights.length; index += 1) {
-    const digit = digits[index];
-    const weight = weights[index];
-    if (digit === void 0 || weight === void 0) {
-      return { valid: false, reason: "format" };
-    }
-    sum += Number(digit) * weight;
-  }
-  const remainder = sum % 11;
-  if (remainder === 1) return { valid: false, reason: "remainder_one" };
-  const expectedCheckDigit = remainder === 0 ? 0 : 11 - remainder;
-  if (actualCheckDigit !== expectedCheckDigit) {
-    return {
-      valid: false,
-      reason: "checksum",
-      expectedCheckDigit,
-      actualCheckDigit
-    };
-  }
-  return { valid: true };
-}
-function isValidFinnishBusinessId(input2) {
-  return validateFinnishBusinessIdCore(input2).valid;
+// src/shared/invoice-draft.ts
+var INVOICE_VAT_TREATMENT_CODES = [
+  "standard_25_5",
+  "standard_13_5",
+  "standard_10",
+  "not_vat_registered",
+  "reverse_construction",
+  "reverse_scrap",
+  "reverse_eu_service",
+  "export_outside_eu",
+  "service_outside_eu",
+  "intra_eu_goods",
+  "exempt_healthcare",
+  "exempt_social_welfare",
+  "exempt_education",
+  "exempt_financial",
+  "exempt_insurance",
+  "exempt_other",
+  "legacy_standard_24",
+  "legacy_standard_14"
+];
+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) => `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.",
+  FISCAL_YEAR_CLOSED: () => "Tilikausi on suljettu. Laskua ei voi luoda.",
+  VAT_TREATMENT_REQUIRED: () => "0 % ALV vaatii t\xE4sm\xE4llisen ALV-k\xE4sittelyn syyn.",
+  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.",
+  VAT_REQUIRES_NON_EU_COUNTRY: () => "EU:n ulkopuolinen myynti vaatii ostajalle EU:n ulkopuolisen maan.",
+  INVOICE_NUMBER_CONFLICT: () => "Laskunumero on jo k\xE4yt\xF6ss\xE4 (samanaikainen luonti). Yrit\xE4 uudelleen.",
+  INVALID_LINE: () => "Laskurivi ei kelpaa. Tarkista m\xE4\xE4r\xE4, hinta ja ALV-k\xE4sittely.",
+  PERMISSION_DENIED: () => "Ei oikeutta luoda laskua t\xE4lle yritykselle.",
+  MFA_REQUIRED: () => "Vahvista kaksivaiheinen tunnistautuminen Kirjaprossa ja yrit\xE4 sitten uudelleen.",
+  WRITE_REJECTED: () => "Laskun luonti hyl\xE4ttiin. Mit\xE4\xE4n ei tallennettu.",
+  OUTCOME_UNKNOWN: () => "Laskun luonnin lopputulosta ei voitu varmistaa. Tarkista laskulista ennen uutta yrityst\xE4."
+};
+function retryFor(code) {
+  if (code === "OUTCOME_UNKNOWN") return "reconcile";
+  return code === "LOOKUP_FAILED" || code === "INVOICE_NUMBER_CONFLICT" ? "safe" : "never";
+}
+function invoiceDraftError(code, detail = "") {
+  return { code, message: ERROR_MESSAGES[code](detail), retry: retryFor(code) };
+}
+function roundNumericMoney(value) {
+  if (!Number.isFinite(value)) return value;
+  if (Math.abs(value) >= 9e13) return Math.round(value * 100) / 100;
+  const digits = Math.abs(value).toPrecision(15);
+  if (digits.includes("e")) return 0;
+  const [whole = "0", fraction = ""] = digits.split(".");
+  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;
+  if (priceEntryMode === "vat_inclusive" && vatRate > 0) {
+    const total3 = roundNumericMoney(quantity * unitPrice * discountFactor);
+    const vatAmount2 = roundNumericMoney(total3 * vatRate / (100 + vatRate));
+    const subtotal2 = roundNumericMoney(total3 - vatAmount2);
+    return { subtotal: subtotal2, vatAmount: vatAmount2, total: total3 };
+  }
+  const subtotal = roundNumericMoney(quantity * unitPrice * discountFactor);
+  const vatAmount = roundNumericMoney(subtotal * (vatRate / 100));
+  const total2 = roundNumericMoney(subtotal + vatAmount);
+  return { subtotal, vatAmount, total: total2 };
+}
+function calculateInvoiceTotals(lines) {
+  const subtotalCents = lines.reduce((sum, line) => sum + Math.round(line.subtotal * 100), 0);
+  const vatTotalCents = lines.reduce((sum, line) => sum + Math.round(line.vat_amount * 100), 0);
+  const totalCents = lines.reduce((sum, line) => sum + Math.round(line.total * 100), 0);
+  return {
+    subtotal: subtotalCents / 100,
+    vatTotal: vatTotalCents / 100,
+    total: totalCents / 100
+  };
 }
-
-// src/vat.ts
-var EU_COUNTRY_CODES = /* @__PURE__ */ new Set([
+var ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+function dateParts(date5) {
+  const match = ISO_DATE.exec(date5);
+  if (!match) return null;
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = Number(match[3]);
+  const utc = new Date(Date.UTC(year, month - 1, day));
+  return utc.getUTCFullYear() === year && utc.getUTCMonth() === month - 1 && utc.getUTCDate() === day ? [year, month, day] : null;
+}
+function addDaysIso(date5, days) {
+  const parts = dateParts(date5);
+  if (!parts) throw new RangeError(`Invalid date: ${date5}`);
+  const [year, month, day] = parts;
+  return new Date(Date.UTC(year, month - 1, day + days)).toISOString().slice(0, 10);
+}
+var TREATMENT_RATES = {
+  standard_25_5: 25.5,
+  standard_13_5: 13.5,
+  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",
+  "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");
+  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",
   "BE",
   "BG",
@@ -37373,51 +37455,174 @@ var EU_COUNTRY_CODES = /* @__PURE__ */ new Set([
   "SE",
   "SI",
   "SK"
-]);
-function normalizedVatNumber(value) {
-  return (value ?? "").toUpperCase().replace(/[^A-Z0-9]/g, "");
-}
-function validateVatTreatmentEligibility({
-  code,
-  sellerAlvRegistered,
-  customer,
-  documentDate
-}) {
-  if (!sellerAlvRegistered && code !== "not_vat_registered") {
-    return "A seller outside the VAT register can only use not_vat_registered.";
-  }
-  if (sellerAlvRegistered && code === "not_vat_registered") {
-    return "A VAT-registered seller cannot use not_vat_registered.";
-  }
-  if (code === "standard_25_5" && documentDate < "2024-09-01") {
-    return "standard_25_5 is not valid before 2024-09-01.";
-  }
-  if (code === "standard_13_5" && documentDate < "2026-01-01") {
-    return "standard_13_5 is not valid before 2026-01-01.";
-  }
-  const requiresBusiness = code.startsWith("reverse_") || code === "intra_eu_goods" || code === "service_outside_eu";
-  if (requiresBusiness && customer?.customer_kind !== "business") {
-    return "The selected VAT treatment requires a business customer.";
-  }
-  if ((code === "reverse_construction" || code === "reverse_scrap") && !isValidFinnishBusinessId(customer?.business_id ?? "")) {
-    return "Domestic reverse charge requires a Finnish buyer business ID in the form 1234567-8.";
-  }
+];
+function isFinnishBusinessId(value) {
+  const match = /^(\d{7})-(\d)$/.exec(value.replace(/\s/g, ""));
+  if (!match) return false;
+  const digits = match[1] ?? "";
+  const weights = [7, 9, 10, 5, 8, 4, 2];
+  let sum = 0;
+  for (let index = 0; index < weights.length; index += 1)
+    sum += Number(digits.charAt(index)) * (weights[index] ?? 0);
+  const remainder = sum % 11;
+  if (remainder === 1) return false;
+  return Number(match[2]) === (remainder === 0 ? 0 : 11 - remainder);
+}
+function invoiceVatTreatmentError(code, sellerAlvRegistered, customer, documentDate) {
+  if (!sellerAlvRegistered && code !== "not_vat_registered")
+    return invoiceDraftError("VAT_SELLER_NOT_REGISTERED");
+  if (sellerAlvRegistered && code === "not_vat_registered")
+    return invoiceDraftError("VAT_SELLER_REGISTERED");
+  if (code === "standard_25_5" && documentDate < "2024-09-01")
+    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 ?? ""))
+    return invoiceDraftError("VAT_REQUIRES_FINNISH_BUSINESS_ID");
+  const country = (customer.country ?? "").trim().toUpperCase();
   if (code === "reverse_eu_service" || code === "intra_eu_goods") {
-    const country = (customer?.country ?? "").trim().toUpperCase();
-    const vatNumber = normalizedVatNumber(customer?.vat_number);
+    const vatNumber = (customer.vat_number ?? "").toUpperCase().replace(/[^A-Z0-9]/g, "");
     const expectedPrefix = country === "GR" ? "EL" : country;
-    if (!EU_COUNTRY_CODES.has(country) || country === "FI" || !/^[A-Z]{2}[A-Z0-9]{2,12}$/.test(vatNumber) || !vatNumber.startsWith(expectedPrefix)) {
-      return "EU sale requires a non-Finnish EU country and a matching buyer VAT number.";
-    }
+    if (!EU_COUNTRY_CODES.includes(country) || country === "FI" || !/^[A-Z]{2}[A-Z0-9]{2,12}$/.test(vatNumber) || !vatNumber.startsWith(expectedPrefix))
+      return invoiceDraftError("VAT_REQUIRES_EU_VAT_NUMBER");
   }
-  if (code === "export_outside_eu" || code === "service_outside_eu") {
-    const country = (customer?.country ?? "").trim().toUpperCase();
-    if (!country || EU_COUNTRY_CODES.has(country)) {
-      return "Export outside the EU requires a buyer country outside the EU.";
-    }
+  if ((code === "export_outside_eu" || code === "service_outside_eu") && (!country || EU_COUNTRY_CODES.includes(country)))
+    return invoiceDraftError("VAT_REQUIRES_NON_EU_COUNTRY");
+  return null;
+}
+function inputError(input2) {
+  if (!dateParts(input2.invoiceDate)) return "laskun p\xE4iv\xE4m\xE4\xE4r\xE4 ei ole kelvollinen";
+  if (input2.lines.length < 1 || input2.lines.length > INVOICE_DRAFT_MAX_LINES)
+    return `laskulla pit\xE4\xE4 olla 1\u2013${INVOICE_DRAFT_MAX_LINES} rivi\xE4`;
+  const term = input2.paymentTermDays;
+  if (term !== void 0 && (!Number.isInteger(term) || term < 0 || term > 365))
+    return "maksuehdon pit\xE4\xE4 olla 0\u2013365 kokonaista p\xE4iv\xE4\xE4";
+  if ((input2.notes ?? "").length > 2e3) return "lis\xE4tiedot ovat yli 2000 merkki\xE4";
+  for (let index = 0; index < input2.lines.length; index += 1) {
+    const line = input2.lines[index];
+    const row = `rivi ${index + 1}`;
+    if (!line) return `${row} puuttuu`;
+    if (!line.description.trim() || line.description.length > 500)
+      return `${row}: kuvauksen pit\xE4\xE4 olla 1\u2013500 merkki\xE4`;
+    if (line.unit.length > 20) return `${row}: yksikk\xF6 on yli 20 merkki\xE4`;
+    if (!Number.isFinite(line.quantity) || line.quantity <= 0 || line.quantity > 1e6)
+      return `${row}: m\xE4\xE4r\xE4n pit\xE4\xE4 olla yli 0 ja enint\xE4\xE4n 1 000 000`;
+    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;
 }
+function prepareInvoiceDraft(input2, facts) {
+  const invalid = inputError(input2);
+  if (invalid) return { ok: false, error: invoiceDraftError("INVALID_INPUT", invalid) };
+  const { customer } = facts;
+  const lines = [];
+  for (const [index, line] of input2.lines.entries()) {
+    const treatment = resolveInvoiceVatTreatment(line.vatRate, line.vatTreatmentCode);
+    if ("message" in treatment) return { ok: false, error: treatment };
+    const ineligible = invoiceVatTreatmentError(
+      treatment.code,
+      facts.sellerAlvRegistered,
+      customer,
+      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,
+      discountPercent
+    );
+    lines.push({
+      line_number: index + 1,
+      description: line.description,
+      quantity: line.quantity,
+      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,
+      price_entry_mode: input2.priceEntryMode,
+      default_vat_treatment_code: treatment.code,
+      reverse_charge_confirmed: input2.reverseChargeConfirmed ?? false,
+      eu_goods_transport_confirmed: input2.euGoodsTransportConfirmed ?? false,
+      subtotal: amounts.subtotal,
+      vat_amount: amounts.vatAmount,
+      total: amounts.total
+    });
+  }
+  const totals = calculateInvoiceTotals(lines);
+  return {
+    ok: true,
+    draft: {
+      customerId: customer.id,
+      customerName: customer.name,
+      invoiceDate: input2.invoiceDate,
+      dueDate: addDaysIso(
+        input2.invoiceDate,
+        input2.paymentTermDays ?? customer.payment_term_days ?? 14
+      ),
+      notes: input2.notes ?? "",
+      lines,
+      subtotal: totals.subtotal,
+      vatTotal: totals.vatTotal,
+      total: totals.total
+    }
+  };
+}
+function invoiceDraftRpcArgs(companyId2, draft, audit) {
+  return {
+    p_company_id: companyId2,
+    p_customer_id: draft.customerId,
+    p_invoice_number: null,
+    p_reference_number: null,
+    p_invoice_date: draft.invoiceDate,
+    p_due_date: draft.dueDate,
+    p_status: "draft",
+    p_subtotal: draft.subtotal,
+    p_vat_total: draft.vatTotal,
+    p_total: draft.total,
+    p_notes: draft.notes,
+    p_lines: draft.lines,
+    ...audit ? { p_audit_action: audit.action, p_audit_details: audit.details } : {}
+  };
+}
+var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var CONFIRMED_ERROR_CODE = /^(?:[0-9A-Z]{5}|PGRST\d{3})$/;
+function invoiceDraftWriteOutcome(response) {
+  const { data, error: error61 } = response;
+  if (error61) {
+    const code = error61.code ?? "";
+    if (!CONFIRMED_ERROR_CODE.test(code))
+      return { ok: false, error: invoiceDraftError("OUTCOME_UNKNOWN") };
+    if ((error61.message ?? "").startsWith("AAL2_REQUIRED"))
+      return { ok: false, error: invoiceDraftError("MFA_REQUIRED") };
+    const mapped = {
+      "23505": "INVOICE_NUMBER_CONFLICT",
+      "55000": "FISCAL_YEAR_CLOSED",
+      "42501": "PERMISSION_DENIED",
+      "23514": "INVALID_LINE"
+    };
+    return { ok: false, error: invoiceDraftError(mapped[code] ?? "WRITE_REJECTED") };
+  }
+  if (typeof data !== "string" || !UUID.test(data))
+    return { ok: false, error: invoiceDraftError("OUTCOME_UNKNOWN") };
+  return { ok: true, invoiceId: data };
+}
 
 // src/lib/invoice-balances.ts
 var CREDIT_PAGE_SIZE = 500;
@@ -37454,20 +37659,48 @@ function calculateInvoiceBalance(total2, payments, creditedTotal) {
   return { paidTotal, remainingBalance: roundCents(total2 - paidTotal - creditedTotal) };
 }
 
-// src/tools/invoices.ts
-function generateReferenceNumber(baseNumber) {
-  const digits = baseNumber.replace(/\D/g, "").replace(/^0+/, "");
-  if (digits.length < 3 || digits.length > 19) {
-    throw new Error("Base number must be 3-19 digits without leading zeros");
-  }
-  const weights = [7, 3, 1];
-  let sum = 0;
-  for (let i = digits.length - 1, w = 0; i >= 0; i--, w++) {
-    sum += parseInt(digits[i]) * weights[w % 3];
+// 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;
   }
-  const checkDigit = (10 - sum % 10) % 10;
-  return digits + checkDigit;
+  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(),
   document_type: external_exports.enum(["invoice", "credit_note"]),
@@ -37519,6 +37752,145 @@ var GET_INVOICE_OUTPUT_SHAPE = {
   credited_total: external_exports.number(),
   remaining_balance: external_exports.number()
 };
+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).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"),
+  euGoodsTransportConfirmed: external_exports.boolean().default(false).describe("Explicit confirmation that intra-EU goods are transported from Finland to another EU country"),
+  lines: external_exports.array(
+    external_exports.object({
+      description: external_exports.string().min(1).max(500).describe("Line item description"),
+      // DB enforces CHECK (quantity > 0); reject 0/negative/Infinity at
+      // the boundary so the agent gets a clear error instead of an
+      // opaque 23514 deep in create_invoice_with_lines.
+      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).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})`),
+  idempotencyKey: IDEMPOTENCY_KEY_SCHEMA
+};
+async function createInvoiceDraftCommand(ctx, params) {
+  const fail = (error62) => toErrorContent(`${error62.code}: ${error62.message}`);
+  const { data: customer, error: customerError } = await ctx.supabase.from("customers").select(INVOICE_DRAFT_CUSTOMER_COLUMNS).eq("id", params.customerId).eq("company_id", ctx.companyId).maybeSingle();
+  if (customerError) return fail(invoiceDraftError("LOOKUP_FAILED"));
+  if (!customer) {
+    return fail(
+      invoiceDraftError("CUSTOMER_NOT_FOUND", "hae tunniste kirjapro_list_customers-ty\xF6kalulla")
+    );
+  }
+  const { data: company, error: companyError } = await ctx.supabase.from("companies").select("alv_registered").eq("id", ctx.companyId).single();
+  if (companyError || !company) return fail(invoiceDraftError("LOOKUP_FAILED"));
+  const prepared = prepareInvoiceDraft(
+    {
+      invoiceDate: params.invoiceDate,
+      paymentTermDays: params.paymentTermDays,
+      priceEntryMode: params.priceEntryMode,
+      notes: params.notes,
+      reverseChargeConfirmed: params.reverseChargeConfirmed,
+      euGoodsTransportConfirmed: params.euGoodsTransportConfirmed,
+      // 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 }
+  );
+  if (!prepared.ok) return fail(prepared.error);
+  const { draft } = prepared;
+  const { data, error: error61, status } = await ctx.supabase.rpc(
+    "create_invoice_with_lines",
+    // NULL number/reference = DB allocation; generated types do not mark them nullable.
+    invoiceDraftRpcArgs(ctx.companyId, draft)
+  );
+  const outcome = invoiceDraftWriteOutcome({ data, error: error61 });
+  if (isWriteOutcomeUnknown(error61, status) || !outcome.ok && outcome.error.code === "OUTCOME_UNKNOWN") {
+    return toWriteOutcomeUnknown("kirjapro_create_invoice", "kirjapro_list_invoices");
+  }
+  if (!outcome.ok) {
+    console.error("[kirjapro-mcp] create_invoice rejected:", { code: error61?.code });
+    return fail(outcome.error);
+  }
+  const { data: invoice, error: fetchError } = await ctx.supabase.from("invoices").select(
+    "id, invoice_number, reference_number, invoice_date, due_date, status, subtotal, vat_total, total, notes, created_at"
+  ).eq("id", outcome.invoiceId).eq("company_id", ctx.companyId).single();
+  if (fetchError || !invoice) {
+    return toResult({
+      message: "Lasku luotiin, mutta sen tietojen haku ep\xE4onnistui.",
+      invoice: {
+        id: outcome.invoiceId,
+        status: "draft",
+        invoice_date: draft.invoiceDate,
+        due_date: draft.dueDate,
+        subtotal: draft.subtotal,
+        vat_total: draft.vatTotal,
+        total: draft.total,
+        customer_name: customer.name,
+        lines: draft.lines
+      },
+      warning: "Tarkista lasku kirjapro_get_invoice-ty\xF6kalulla."
+    });
+  }
+  return toResult({
+    message: `Invoice ${invoice.invoice_number} created for ${customer.name}`,
+    invoice: {
+      ...invoice,
+      customer_name: customer.name,
+      lines: draft.lines
+    }
+  });
+}
+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",
@@ -37570,196 +37942,18 @@ function registerInvoiceTools(server2) {
     "kirjapro_create_invoice",
     {
       description: "Create a new sales invoice with line items. Automatically generates invoice number, reference number (viitenumero), and calculates VAT. Returns the complete invoice.",
-      inputSchema: {
-        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)"),
-        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"),
-        euGoodsTransportConfirmed: external_exports.boolean().default(false).describe("Explicit confirmation that intra-EU goods are transported from Finland to another EU country"),
-        lines: external_exports.array(
-          external_exports.object({
-            description: external_exports.string().min(1).max(500).describe("Line item description"),
-            // DB enforces CHECK (quantity > 0); reject 0/negative/Infinity at
-            // the boundary so the agent gets a clear error instead of an
-            // opaque 23514 deep in create_invoice_with_lines.
-            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(["25.5", "13.5", "10", "0"]).default("25.5").describe("VAT rate"),
-            vatTreatmentCode: external_exports.enum([
-              "standard_25_5",
-              "standard_13_5",
-              "standard_10",
-              "not_vat_registered",
-              "reverse_construction",
-              "reverse_scrap",
-              "reverse_eu_service",
-              "export_outside_eu",
-              "service_outside_eu",
-              "intra_eu_goods",
-              "exempt_healthcare",
-              "exempt_social_welfare",
-              "exempt_education",
-              "exempt_financial",
-              "exempt_insurance",
-              "exempt_other"
-            ]).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})`),
-        idempotencyKey: IDEMPOTENCY_KEY_SCHEMA
-      },
+      inputSchema: CREATE_INVOICE_INPUT_SHAPE,
       annotations: WRITE_ANNOTATIONS
     },
     async (params) => {
-      const supabase2 = getSupabase();
-      const companyId2 = getCompanyId();
+      const ctx = { supabase: getSupabase(), companyId: getCompanyId() };
       return withIdempotency(
-        supabase2,
-        companyId2,
+        ctx.supabase,
+        ctx.companyId,
         "kirjapro_create_invoice",
         params.idempotencyKey,
         params,
-        async () => {
-          const { data: customer, error: custError } = await supabase2.from("customers").select("id, name, customer_kind, business_id, vat_number, country").eq("id", params.customerId).eq("company_id", companyId2).single();
-          if (custError || !customer) {
-            return toErrorContent(
-              `Customer ${params.customerId} not found. Use kirjapro_list_customers to find customer IDs.`
-            );
-          }
-          const { data: company, error: companyError } = await supabase2.from("companies").select("alv_registered").eq("id", companyId2).single();
-          if (companyError || !company) {
-            return toErrorContent("Failed to verify the seller VAT registration status.");
-          }
-          const { data: invoiceNumber, error: numError } = await supabase2.rpc(
-            "get_next_invoice_number",
-            {
-              p_company_id: companyId2
-            }
-          );
-          if (numError || !invoiceNumber) {
-            return toErrorContent(
-              numError ? sanitizeDbError("Failed to generate invoice number", numError) : "Failed to generate invoice number."
-            );
-          }
-          const referenceNumber = generateReferenceNumber(
-            invoiceNumber.replace(/\D/g, "")
-          );
-          const dueDateStr = addDaysToIsoDate(
-            params.invoiceDate,
-            params.paymentTermDays
-          );
-          const treatmentRates = {
-            standard_25_5: 25.5,
-            standard_13_5: 13.5,
-            standard_10: 10,
-            not_vat_registered: 0,
-            reverse_construction: 0,
-            reverse_scrap: 0,
-            reverse_eu_service: 0,
-            export_outside_eu: 0,
-            service_outside_eu: 0,
-            intra_eu_goods: 0,
-            exempt_healthcare: 0,
-            exempt_social_welfare: 0,
-            exempt_education: 0,
-            exempt_financial: 0,
-            exempt_insurance: 0,
-            exempt_other: 0
-          };
-          const resolvedTreatments = params.lines.map((line) => {
-            const inputRate = parseFloat(line.vatRate);
-            const code = line.vatTreatmentCode ?? (inputRate === 25.5 ? "standard_25_5" : inputRate === 13.5 ? "standard_13_5" : inputRate === 10 ? "standard_10" : null);
-            if (!code) return { error: "0 % VAT requires a structured vatTreatmentCode." };
-            const eligibilityError = validateVatTreatmentEligibility({
-              code,
-              sellerAlvRegistered: company.alv_registered,
-              customer,
-              documentDate: params.invoiceDate
-            });
-            if (eligibilityError) return { error: eligibilityError };
-            return { code, rate: treatmentRates[code] ?? inputRate };
-          });
-          const treatmentError = resolvedTreatments.find((item) => "error" in item);
-          if (treatmentError && "error" in treatmentError) {
-            return toErrorContent(treatmentError.error);
-          }
-          const calculatedLines = params.lines.map((line, i) => {
-            const resolved = resolvedTreatments[i];
-            if (!resolved || !("code" in resolved)) throw new Error("VAT treatment validation failed");
-            const vatRate = resolved.rate;
-            const vatTreatmentCode = resolved.code;
-            const gross = roundCents(line.quantity * line.unitPrice);
-            const vatAmount = params.priceEntryMode === "vat_inclusive" && vatRate > 0 ? roundCents(gross * vatRate / (100 + vatRate)) : roundCents(gross * (vatRate / 100));
-            const subtotal2 = params.priceEntryMode === "vat_inclusive" && vatRate > 0 ? roundCents(gross - vatAmount) : gross;
-            const total3 = params.priceEntryMode === "vat_inclusive" && vatRate > 0 ? gross : roundCents(subtotal2 + vatAmount);
-            return {
-              line_number: i + 1,
-              description: line.description,
-              quantity: line.quantity,
-              unit: line.unit,
-              unit_price: line.unitPrice,
-              entered_unit_price: line.unitPrice,
-              vat_rate: vatRate,
-              vat_treatment_code: vatTreatmentCode,
-              vat_treatment_overridden: true,
-              price_entry_mode: params.priceEntryMode,
-              default_vat_treatment_code: vatTreatmentCode,
-              reverse_charge_confirmed: params.reverseChargeConfirmed,
-              reverse_charge_confirmation_text: params.reverseChargeConfirmed ? "Buyer qualification explicitly confirmed through MCP invoice creation." : null,
-              eu_goods_transport_confirmed: params.euGoodsTransportConfirmed,
-              subtotal: subtotal2,
-              vat_amount: vatAmount,
-              total: total3
-            };
-          });
-          const subtotal = roundCents(
-            calculatedLines.reduce((s, l) => s + l.subtotal, 0)
-          );
-          const vatTotal = roundCents(
-            calculatedLines.reduce((s, l) => s + l.vat_amount, 0)
-          );
-          const total2 = roundCents(subtotal + vatTotal);
-          const { data: invoiceId, error: invError } = await supabase2.rpc(
-            "create_invoice_with_lines",
-            {
-              p_company_id: companyId2,
-              p_customer_id: params.customerId,
-              p_invoice_number: invoiceNumber,
-              p_reference_number: referenceNumber,
-              p_invoice_date: params.invoiceDate,
-              p_due_date: dueDateStr,
-              p_status: "draft",
-              p_subtotal: subtotal,
-              p_vat_total: vatTotal,
-              p_total: total2,
-              p_notes: params.notes || "",
-              p_lines: calculatedLines
-            }
-          );
-          if (invError || !invoiceId) {
-            return toErrorContent(
-              invError ? sanitizeDbError("Failed to create invoice", invError) : "Failed to create invoice."
-            );
-          }
-          const { data: invoice, error: fetchError } = await supabase2.from("invoices").select(
-            "id, invoice_number, reference_number, invoice_date, due_date, status, subtotal, vat_total, total, notes, created_at"
-          ).eq("id", invoiceId).eq("company_id", companyId2).single();
-          if (fetchError || !invoice) {
-            return toErrorContent(
-              fetchError ? sanitizeDbError("Invoice created but fetch failed", fetchError) : "Invoice created but could not be retrieved."
-            );
-          }
-          return toResult({
-            message: `Invoice ${invoiceNumber} created for ${customer.name}`,
-            invoice: {
-              ...invoice,
-              customer_name: customer.name,
-              lines: calculatedLines
-            }
-          });
-        }
+        () => createInvoiceDraftCommand(ctx, params)
       );
     }
   );
@@ -37772,45 +37966,18 @@ function registerInvoiceTools(server2) {
         channel: external_exports.enum(["email", "einvoice"]).describe("Delivery channel: email or einvoice"),
         idempotencyKey: IDEMPOTENCY_KEY_SCHEMA
       },
-      annotations: WRITE_ANNOTATIONS
+      // Delivers through email or Maventa: an external effect (openWorldHint).
+      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)
       );
     }
   );
@@ -38132,6 +38299,43 @@ function registerInvoiceTools(server2) {
   );
 }
 
+// src/finnish-business-id.ts
+function validateFinnishBusinessIdCore(input2) {
+  const cleaned = input2.replace(/\s/g, "").toUpperCase();
+  const match = cleaned.match(/^(\d{7})-(\d)$/);
+  if (!match) return { valid: false, reason: "format" };
+  const digits = match[1];
+  const actualCheckDigit = Number(match[2]);
+  if (!digits || !Number.isInteger(actualCheckDigit)) {
+    return { valid: false, reason: "format" };
+  }
+  const weights = [7, 9, 10, 5, 8, 4, 2];
+  let sum = 0;
+  for (let index = 0; index < weights.length; index += 1) {
+    const digit = digits[index];
+    const weight = weights[index];
+    if (digit === void 0 || weight === void 0) {
+      return { valid: false, reason: "format" };
+    }
+    sum += Number(digit) * weight;
+  }
+  const remainder = sum % 11;
+  if (remainder === 1) return { valid: false, reason: "remainder_one" };
+  const expectedCheckDigit = remainder === 0 ? 0 : 11 - remainder;
+  if (actualCheckDigit !== expectedCheckDigit) {
+    return {
+      valid: false,
+      reason: "checksum",
+      expectedCheckDigit,
+      actualCheckDigit
+    };
+  }
+  return { valid: true };
+}
+function isValidFinnishBusinessId(input2) {
+  return validateFinnishBusinessIdCore(input2).valid;
+}
+
 // src/tools/customers.ts
 var CUSTOMER_STATS_RPC_SCHEMA = external_exports.object({
   invoice_count: external_exports.number().int().nonnegative(),
@@ -38169,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(
@@ -38441,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",
@@ -38481,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) {
@@ -38506,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") {
@@ -38698,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(),
@@ -39051,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();
@@ -39067,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(
@@ -39224,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(" ") },
@@ -39695,7 +39931,7 @@ function validateFinnishIBAN(input2) {
   }
   return { valid: true };
 }
-function generateReferenceNumber2(baseNumber) {
+function generateReferenceNumber(baseNumber) {
   const digits = baseNumber.replace(/\D/g, "").replace(/^0+/, "");
   if (digits.length < 3 || digits.length > 19) {
     return { reference: "", error: "Base number must be 3-19 digits without leading zeros." };
@@ -39756,7 +39992,7 @@ function registerValidationTools(server2) {
       annotations: READ_ONLY_ANNOTATIONS
     },
     async (params) => {
-      const result = generateReferenceNumber2(params.baseNumber);
+      const result = generateReferenceNumber(params.baseNumber);
       return toResult({
         input: params.baseNumber,
         ...result
@@ -40311,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 }
@@ -40332,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 }
@@ -40410,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 },
@@ -40432,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 },
@@ -40441,7 +40677,7 @@ var TEMPLATES = [
           {
             accountNumber: ACCOUNTS.PANKKITILI,
             debitAmount: 0,
-            creditAmount: roundCents(amount)
+            creditAmount: roundCents(amount2)
           }
         ],
         opts?.accountOverrides
@@ -40453,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 },
@@ -40462,7 +40698,7 @@ var TEMPLATES = [
           {
             accountNumber: ACCOUNTS.PANKKITILI,
             debitAmount: 0,
-            creditAmount: roundCents(amount)
+            creditAmount: roundCents(amount2)
           }
         ],
         opts?.accountOverrides
@@ -40475,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
@@ -40497,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
@@ -40530,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) {
@@ -41189,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);
@@ -41210,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 ? {
@@ -41236,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,
@@ -41253,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,
@@ -41501,6 +41737,81 @@ function registerBookingTools(server2) {
   );
 }
 
+// src/vat.ts
+var EU_COUNTRY_CODES2 = /* @__PURE__ */ new Set([
+  "AT",
+  "BE",
+  "BG",
+  "HR",
+  "CY",
+  "CZ",
+  "DE",
+  "DK",
+  "EE",
+  "ES",
+  "FI",
+  "FR",
+  "GR",
+  "HU",
+  "IE",
+  "IT",
+  "LT",
+  "LU",
+  "LV",
+  "MT",
+  "NL",
+  "PL",
+  "PT",
+  "RO",
+  "SE",
+  "SI",
+  "SK"
+]);
+function normalizedVatNumber(value) {
+  return (value ?? "").toUpperCase().replace(/[^A-Z0-9]/g, "");
+}
+function validateVatTreatmentEligibility({
+  code,
+  sellerAlvRegistered,
+  customer,
+  documentDate
+}) {
+  if (!sellerAlvRegistered && code !== "not_vat_registered") {
+    return "A seller outside the VAT register can only use not_vat_registered.";
+  }
+  if (sellerAlvRegistered && code === "not_vat_registered") {
+    return "A VAT-registered seller cannot use not_vat_registered.";
+  }
+  if (code === "standard_25_5" && documentDate < "2024-09-01") {
+    return "standard_25_5 is not valid before 2024-09-01.";
+  }
+  if (code === "standard_13_5" && documentDate < "2026-01-01") {
+    return "standard_13_5 is not valid before 2026-01-01.";
+  }
+  const requiresBusiness = code.startsWith("reverse_") || code === "intra_eu_goods" || code === "service_outside_eu";
+  if (requiresBusiness && customer?.customer_kind !== "business") {
+    return "The selected VAT treatment requires a business customer.";
+  }
+  if ((code === "reverse_construction" || code === "reverse_scrap") && !isValidFinnishBusinessId(customer?.business_id ?? "")) {
+    return "Domestic reverse charge requires a Finnish buyer business ID in the form 1234567-8.";
+  }
+  if (code === "reverse_eu_service" || code === "intra_eu_goods") {
+    const country = (customer?.country ?? "").trim().toUpperCase();
+    const vatNumber = normalizedVatNumber(customer?.vat_number);
+    const expectedPrefix = country === "GR" ? "EL" : country;
+    if (!EU_COUNTRY_CODES2.has(country) || country === "FI" || !/^[A-Z]{2}[A-Z0-9]{2,12}$/.test(vatNumber) || !vatNumber.startsWith(expectedPrefix)) {
+      return "EU sale requires a non-Finnish EU country and a matching buyer VAT number.";
+    }
+  }
+  if (code === "export_outside_eu" || code === "service_outside_eu") {
+    const country = (customer?.country ?? "").trim().toUpperCase();
+    if (!country || EU_COUNTRY_CODES2.has(country)) {
+      return "Export outside the EU requires a buyer country outside the EU.";
+    }
+  }
+  return null;
+}
+
 // src/tools/offers.ts
 var OFFER_DETAIL_OUTPUT_SHAPE = {
   id: external_exports.string(),
@@ -42962,7 +43273,7 @@ var VAT_COMPLIANCE = {
     ],
     booking: "D expense/asset for net amount plus non-deductible self-assessed VAT; D ALV-saamiset only for deductible VAT; C bank/payable for supplier amount; C ALV-velka for full self-assessed VAT. Use the canonical VAT purchase command, not unlinked VAT account rows.",
     note: "Net VAT effect is zero only with a full deduction. Report the full assessed VAT and only the deductible share. The seller does not charge VAT on a reverse-charge invoice; this does not remove the buyer\u2019s VAT liability.",
-    implementation_limits: "The MCP purchase shortcut currently has no deduction-share parameter and does not support partial-deduction reverse charge. Do not use its default full deduction for that case: this example describes the accounting rule, not an added tool capability.",
+    implementation_limits: "kirjapro_book_purchase (full surface) takes deductionPercent 0\u2013100 with a documented deductionReason, including for reverse charge: the full assessed VAT is payable (ALV-velka) and only the deductible share reaches ALV-saamiset and field 307. The rest is expense. Entertainment and non-registered buyers use 0.",
     example: { net_purchase: 100, rate: FINNISH_RATES_2026.vat.standard, deductible_share: "60%", output_vat: exampleOutputVat, deductible_vat: exampleDeductibleVat, non_deductible_vat: exampleNonDeductibleVat, expense: roundCents(100 + exampleNonDeductibleVat), payable_vat: exampleNonDeductibleVat },
     omavero_fields: "EU goods: 305 (VAT) / 313 (base); EU services: 306 / 314; services from outside the EU: VAT in 301-303 by rate (no base field); imports: 304 / 310; domestic construction/scrap purchases: 318 / 320, sales 319. The deductible part of each is in 307."
   },
@@ -43615,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,
@@ -43633,7 +43944,7 @@ function registerPrompts(mcpServer) {
         messages: [
           {
             role: "user",
-            content: { type: "text", text }
+            content: { type: "text", text: text2 }
           }
         ]
       };