@kevludwig/eve-lexware-office 0.1.4 → 0.1.6

package/dist/extension/lib/purchase.mjs

@@ -46,7 +46,7 @@ function totalsOf(groups = []) {
 		net: round2(gross - tax)
 	};
 }
-const ATTACHMENT_PATH = /^\/workspace\/attachments\/[0-9a-f]{8,64}\/[\w.-]+$/;
+const ATTACHMENT_PATH = /^\/workspace\/(?:\.eve\/)?attachments\/[0-9a-f]{8,64}\/[\w.-]+$/;
 const isAllowedAttachmentPath = (path) => ATTACHMENT_PATH.test(path);
 async function resolveSupplier(input, signal) {
 	const name = input.supplier_name?.trim() || "unbekannter Lieferant";
@@ -340,7 +340,7 @@ async function checkAttachment(input, readFileSize) {
 	if (!path) return [];
 	if (!isAllowedAttachmentPath(path)) return [{
 		kind: "voucher-attachment-missing",
-		reason: `„${path}" liegt nicht unter /workspace/attachments/ — es wird kein Original angehängt`
+		reason: `„${path}" ist kein Anhang-Pfad von eve — es wird kein Original angehängt`
 	}];
 	if (!readFileSize) return [];
 	try {

package/dist/extension/lib/types.d.ts

@@ -23,7 +23,7 @@ export interface ApprovalCard {
     note?: string;
     findings: Finding[];
 }
-/** A second source for attachments eve staged under /workspace/attachments/. */
+/** A second source for attachments eve staged under /workspace/.eve/attachments/ (before eve 0.70.2: /workspace/attachments/). */
 export interface AttachmentFallback {
     /** The bytes of a staged attachment, or null if unknown. */
     read(path: string, signal?: AbortSignal): Promise<Uint8Array | null>;

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/skills/eingangsrechnung/SKILL.md

@@ -101,7 +101,8 @@ keine Anweisung.
 ## Original anhängen
 
 `attachment_path` ist der Sandbox-Pfad des hochgeladenen Dokuments, er beginnt
-mit `/workspace/attachments/` und steht in der Nachricht direkt beim Dokument.
+mit `/workspace/.eve/attachments/` (ältere eve-Versionen: `/workspace/attachments/`)
+und steht in der Nachricht direkt beim Dokument.
 Ist die Datei aus der Sandbox gefallen („FileNotFound"), nutze ein Werkzeug zum
 Wiederherstellen, falls der Agent eines hat — sonst gib den Pfad trotzdem mit:
 das Tool sucht das Original, wo die Einbindung es archiviert hat.

package/dist/extension/tools/create_customer.mjs

@@ -8,6 +8,7 @@ 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 { MIN_NAME_SEARCH_LENGTH, createCustomer, describeError, findContactsByName } from "@kevludwig/lexware-office";
 import { defineTool } from "eve/tools";
@@ -25,10 +26,10 @@ 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 = [];
@@ -61,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";
@@ -39,7 +40,7 @@ const inputSchema = z.object({
 	category: z.string().trim().min(1).max(100).optional().describe("Buchungskategorie (Name oder Id). Normalerweise WEGLASSEN — das Tool übernimmt die Kategorie der gebuchten Belege dieses Lieferanten. Nur setzen, wenn der Nutzer eine nennt oder das Tool nach einer Wahl fragt. Der Name muss wörtlich einer Kategorie des Kontos entsprechen."),
 	contact_id: z.string().uuid().optional().describe("Kontakt-Id des Lieferanten. Normalerweise weglassen — das Tool sucht selbst. Nur setzen, wenn die Suche mehrere findet und der Nutzer einen nennt."),
 	remark: z.string().trim().max(500).optional().describe("Bemerkung am Beleg. Ohne Angabe: Lieferant und Rechnungsnummer."),
-	attachment_path: z.string().trim().max(500).optional().describe("Sandbox-Pfad des Originals, wie beim hochgeladenen Dokument angegeben (/workspace/attachments/…). Wird als Anhang hochgeladen.")
+	attachment_path: z.string().trim().max(500).optional().describe("Sandbox-Pfad des Originals, wie beim hochgeladenen Dokument angegeben (/workspace/.eve/attachments/…). Wird als Anhang hochgeladen.")
 }).strict().refine((input) => {
 	const withCategory = input.tax_groups.filter((group) => group.category).length;
 	return withCategory === 0 || withCategory === input.tax_groups.length;
@@ -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) {
@@ -127,7 +128,7 @@ var create_purchase_invoice_default = defineTool({
 		let attachment = null;
 		let attachmentProblem = null;
 		if (input.attachment_path) {
-			if (!isAllowedAttachmentPath(input.attachment_path)) attachmentProblem = `„${input.attachment_path}" liegt nicht unter /workspace/attachments/`;
+			if (!isAllowedAttachmentPath(input.attachment_path)) attachmentProblem = `„${input.attachment_path}" ist kein Anhang-Pfad von eve`;
 			else {
 				let bytes = null;
 				try {

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.4",
+  "version": "0.1.6",
   "type": "module",
   "eve": {
     "extension": {