@kevludwig/eve-lexware-office 0.1.3 → 0.1.5

package/dist/extension/lib/with-card.d.ts

@@ -0,0 +1,9 @@
+import type { ApprovalPolicy } from "eve/tools/approval";
+/**
+ * Wraps a writing tool's request policy: when it asks for approval, the
+ * finished card goes to the mount's onApprovalCard right away — before eve
+ * announces the request (`input.requested`). Channels render that event
+ * before hooks run, so a card handed over from a hook would come too late
+ * for them (eve: channel delivery, then hooks).
+ */
+export declare function withCard<T>(request: ApprovalPolicy<T>): ApprovalPolicy<T>;

package/dist/extension/lib/with-card.mjs

@@ -0,0 +1,25 @@
+import { fileURLToPath as __eveFileURLToPath } from "node:url";
+import { dirname as __eveDirname } from "node:path";
+import { createRequire as __eveCreateRequire } from "node:module";
+const __filename = __eveFileURLToPath(import.meta.url);
+__eveDirname(__filename);
+__eveCreateRequire(import.meta.url);
+import { config } from "./runtime.mjs";
+import { approvalCard } from "./cards.mjs";
+function withCard(request) {
+	return async (ctx) => {
+		const status = await request(ctx);
+		const asksPerson = status === "user-approval" || typeof status === "object" && status !== null && status.type === "user-approval";
+		const onApprovalCard = config().onApprovalCard;
+		if (asksPerson && onApprovalCard) {
+			const card = approvalCard(ctx.toolName, ctx.callId, ctx.toolInput);
+			if (card) try {
+				await onApprovalCard(ctx.callId, card);
+			} catch (error) {
+				console.warn(`[lexware] onApprovalCard failed for ${ctx.callId}: ${String(error)}`);
+			}
+		}
+		return status;
+	};
+}
+export { withCard };

package/dist/extension/tools/create_customer.mjs

@@ -8,8 +8,9 @@ import { approverPolicy, client } from "../lib/runtime.mjs";
 import { saveWarnings } from "../lib/findings.mjs";
 import { readJournal, writeJournal } from "../lib/journal.mjs";
 import { rememberShownContacts, shownContactsOf } from "../lib/state.mjs";
+import { withCard } from "../lib/with-card.mjs";
 import { z } from "zod";
-import { createCustomer, describeError, findContactsByName } from "@kevludwig/lexware-office";
+import { MIN_NAME_SEARCH_LENGTH, createCustomer, describeError, findContactsByName } from "@kevludwig/lexware-office";
 import { defineTool } from "eve/tools";
 const inputSchema = z.object({
 	company_name: z.string().trim().min(1).max(255).optional().describe("Firmenname inkl. Rechtsform — entweder dieser oder last_name"),
@@ -25,13 +26,22 @@ const inputSchema = z.object({
 const nameOf = (input) => input.company_name?.trim() || input.last_name?.trim() || "";
 const label = (contact) => `${contact.name}${contact.number ? ` (Nr. ${contact.number})` : ""}`;
 var create_customer_default = defineTool({
-	description: "Legt einen neuen Kunden in Lexware Office an. Pflicht sind Name (Firma oder Person) UND die Rechnungsadresse (Straße, PLZ, Ort) — fehlt die Adresse, frage sie zuerst beim Nutzer ab. E-Mail und Telefon sind optional. Prüfe vorher mit dem Lese-Tool (/contacts?name=…), ob der Kunde schon existiert. Legt erst nach Freigabe an.",
+	description: "Legt einen neuen Kunden in Lexware Office an. Pflicht sind Name (Firma oder Person) UND die Rechnungsadresse (Straße, PLZ, Ort) — fehlt die Adresse, frage sie zuerst beim Nutzer ab. E-Mail und Telefon sind optional. Prüfe vorher mit dem Lese-Tool (/contacts?name=…), ob der Kunde schon existiert — Lexware sucht erst ab 3 Zeichen; kürzere Namen (z. B. „KL“) sind als Kundenname erlaubt, dann ohne Vorabsuche direkt dieses Tool aufrufen. Legt erst nach Freigabe an.",
 	inputSchema,
 	approval: {
-		request: async (ctx) => {
+		request: withCard(async (ctx) => {
 			const name = nameOf(ctx.toolInput ?? {});
 			if (!name) return "user-approval";
 			const findings = [];
+			if (name.trim().length < MIN_NAME_SEARCH_LENGTH) {
+				findings.push({
+					kind: "note",
+					title: "⚠ Name zu kurz für die Suche",
+					value: `Ähnliche Kontakte ungeprüft (Lexware sucht ab ${MIN_NAME_SEARCH_LENGTH} Zeichen).`
+				});
+				saveWarnings(ctx.callId, findings);
+				return "user-approval";
+			}
 			try {
 				const similar = await findContactsByName(client(), name, {
 					size: 5,
@@ -52,7 +62,7 @@ var create_customer_default = defineTool({
 			}
 			saveWarnings(ctx.callId, findings);
 			return "user-approval";
-		},
+		}),
 		response: approverPolicy
 	},
 	async execute(input, ctx) {

package/dist/extension/tools/create_invoice.mjs

@@ -6,6 +6,7 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { approverPolicy } from "../lib/runtime.mjs";
 import { customerFields, executeSalesDocument, lineItemSchema, salesApproval } from "../lib/sales.mjs";
+import { withCard } from "../lib/with-card.mjs";
 import { z } from "zod";
 import { defineTool } from "eve/tools";
 const inputSchema = z.object({
@@ -18,7 +19,7 @@ var create_invoice_default = defineTool({
 	description: "Erstellt eine Ausgangsrechnung als Entwurf in Lexware Office — festgeschrieben und versendet wird dort, nie hier. Kunde per Kundennummer oder contact_id, dazu die Positionen; source_document_id, wenn die Rechnung aus einem Angebot oder einer AB hervorgeht. Legt erst nach Freigabe an und prüft vorher auf Dubletten.",
 	inputSchema,
 	approval: {
-		request: salesApproval("invoice"),
+		request: withCard(salesApproval("invoice")),
 		response: approverPolicy
 	},
 	async execute(input, ctx) {

package/dist/extension/tools/create_order_confirmation.mjs

@@ -6,6 +6,7 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { approverPolicy } from "../lib/runtime.mjs";
 import { customerFields, executeSalesDocument, lineItemSchema, salesApproval, titleSchema } from "../lib/sales.mjs";
+import { withCard } from "../lib/with-card.mjs";
 import { z } from "zod";
 import { defineTool } from "eve/tools";
 const inputSchema = z.object({
@@ -23,7 +24,7 @@ var create_order_confirmation_default = defineTool({
 	description: "Erstellt eine Auftragsbestätigung (AB) in Lexware Office und schreibt sie direkt fest (sie erhält eine AB-Nummer; kein Entwurf). Geht die AB aus einem Angebot hervor, dessen quotation_id mitgeben — das Angebot vorher über /voucherlist (voucherType 'quotation') suchen und lesen; bei mehreren passenden den Nutzer wählen lassen. Legt erst nach Freigabe an.",
 	inputSchema,
 	approval: {
-		request: salesApproval("order-confirmation", withSource),
+		request: withCard(salesApproval("order-confirmation", withSource)),
 		response: approverPolicy
 	},
 	async execute(input, ctx) {

package/dist/extension/tools/create_purchase_invoice.mjs

@@ -9,6 +9,7 @@ import { approverPolicy, client, config } from "../lib/runtime.mjs";
 import { MISSING_EUR_AMOUNT_INSTRUCTION, approvedPurchaseTarget, bookedGroupsOf, invoiceCurrencyOf, isAllowedAttachmentPath, isForeignCurrency, lacksEurAmount, purchaseSignatureOf, rememberPurchaseTarget, runPurchasePreflight, totalsOf } from "../lib/purchase.mjs";
 import { describeWarning, isCorrectable, notesOf, rememberRejection, saveWarnings, wasRejected, wasShownOnCard } from "../lib/findings.mjs";
 import { readJournal, writeJournal } from "../lib/journal.mjs";
+import { withCard } from "../lib/with-card.mjs";
 import { z } from "zod";
 import { REVERSE_CHARGE_TAX_RATE, createVoucher, describeError, findPurchaseInvoiceByNumber, isReverseChargeCategory, round2, taxFromGross, uploadVoucherFile, voucherFileIds } from "@kevludwig/lexware-office";
 import { defineTool } from "eve/tools";
@@ -59,7 +60,7 @@ var create_purchase_invoice_default = defineTool({
 	description: "Erfasst eine Eingangsrechnung (Lieferantenrechnung) als Beleg in Lexware Office und hängt das Original an. Beträge nach Steuersatz gruppiert, nicht als Einzelpositionen — die Artikel stehen im Anhang. Entsteht erst nach Freigabe, unter „Belege zur Prüfung“. Vorher wird geprüft, ob die Gruppen den Endbetrag ergeben und ob die Rechnungsnummer schon erfasst ist.",
 	inputSchema,
 	approval: {
-		request: async (ctx) => {
+		request: withCard(async (ctx) => {
 			const input = ctx.toolInput;
 			if (!input?.voucher_number) return "user-approval";
 			if (lacksEurAmount(input)) return {
@@ -114,7 +115,7 @@ var create_purchase_invoice_default = defineTool({
 				}
 			}
 			return "user-approval";
-		},
+		}),
 		response: approverPolicy
 	},
 	async execute(input, ctx) {

package/dist/extension/tools/create_quotation.mjs

@@ -6,6 +6,7 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { approverPolicy } from "../lib/runtime.mjs";
 import { customerFields, executeSalesDocument, isCalendarDate, lineItemSchema, salesApproval, titleSchema } from "../lib/sales.mjs";
+import { withCard } from "../lib/with-card.mjs";
 import { z } from "zod";
 import { defineTool } from "eve/tools";
 const inputSchema = z.object({
@@ -18,7 +19,7 @@ var create_quotation_default = defineTool({
 	description: "Erstellt ein Angebot in Lexware Office und schreibt es direkt fest (es erhält eine Angebotsnummer; kein Entwurf). Kunde per Kundennummer oder contact_id — existiert er noch nicht, zuerst create_customer. Legt erst nach Freigabe an und prüft vorher, ob es für diesen Kunden schon ein Angebot mit gleicher Positionssumme gibt. Versendet wird aus Lexware Office.",
 	inputSchema,
 	approval: {
-		request: salesApproval("quotation"),
+		request: withCard(salesApproval("quotation")),
 		response: approverPolicy
 	},
 	async execute(input, ctx) {

package/dist/extension/tools/send_payment_reminder.mjs

@@ -9,6 +9,7 @@ import { approverPolicy, client, config, ledger, renderReminder } from "../lib/r
 import { saveWarnings } from "../lib/findings.mjs";
 import { readJournal, writeJournal } from "../lib/journal.mjs";
 import { bindReminderTarget, boundReminderTarget } from "../lib/state.mjs";
+import { withCard } from "../lib/with-card.mjs";
 import { z } from "zod";
 import { DEFAULT_REMINDER_POLICY, contactEmail, daysPastReminderDue, daysSince, describeError, earliestReminderDate, findOverdueInvoice, isDueImmediately, sendReminder } from "@kevludwig/lexware-office";
 import { defineTool } from "eve/tools";
@@ -24,7 +25,7 @@ var send_payment_reminder_default = defineTool({
 	description: "Schickt eine freundliche Zahlungserinnerung zu einer überfälligen Rechnung per E-Mail, mit der Rechnung als PDF im Anhang. Die Werte (Nummer, Kunde, offener Betrag, Fälligkeit) übernimmst du unverändert aus Lexware Office bzw. aus dem Tool due_payment_reminders — dieses Tool prüft sie. Der Text ist fest vorgegeben. Verschickt wird erst nach Freigabe.",
 	inputSchema,
 	approval: {
-		request: async (ctx) => {
+		request: withCard(async (ctx) => {
 			const input = ctx.toolInput;
 			if (!input?.invoice_id) return "user-approval";
 			const reminders = config().reminders;
@@ -124,7 +125,7 @@ var send_payment_reminder_default = defineTool({
 			});
 			if (earlier?.status !== "sent") await ledger().markPending(invoice, ctx.session.id).catch(() => {});
 			return "user-approval";
-		},
+		}),
 		response: approverPolicy
 	},
 	async execute(_input, ctx) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevludwig/eve-lexware-office",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "eve": {
     "extension": {
@@ -24,7 +24,7 @@
   "dependencies": {
     "@vercel/blob": "^2.8.0",
     "zod": "4.5.4",
-    "@kevludwig/lexware-office": "0.1.1"
+    "@kevludwig/lexware-office": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "24.x",