beliq-mcp 0.2.0 → 0.3.1

package/dist/schema.js

@@ -140,6 +140,19 @@ export const generateOutputShape = {
     outputPath: z.string().optional(),
     bytesWritten: z.number().optional(),
     xml: z.string().optional(),
+    // The verify-it-yourself seal: sha256 of the returned document, the combined
+    // ruleset fingerprint it was checked against, and the validation verdict.
+    sha256: z.string().optional(),
+    rulesetSha256: z.string().optional(),
+    livemode: z.boolean().optional(),
+    validationResult: z
+        .object({
+        valid: z.boolean(),
+        schematronVersion: z.string().optional(),
+        errors: z.array(issueShape),
+        warnings: z.array(issueShape),
+    })
+        .optional(),
 };
 // ── Convert ────────────────────────────────────────────────────────────────
 export const convertInputShape = {

package/dist/summary.js

@@ -52,11 +52,15 @@ export function summarizeParse(result) {
 /**
  * A human-readable summary of a generate. For an XML result the document is
  * appended in full so a client without structured output still receives it; a
- * PDF is reported by the path it was written to.
+ * PDF is reported by the path it was written to. When the seal is present the
+ * document sha256 and validation verdict are stated so the model can cite them.
  */
 export function summarizeGenerate(g) {
     const checked = g.schematronVersion ? `, checked against Schematron ${g.schematronVersion}` : '';
-    const header = `Generated a ${g.standard} ${g.output} document${checked}.`;
+    const seal = g.sha256
+        ? ` Document sha256 ${g.sha256}${g.valid === undefined ? '' : `; validation ${g.valid ? 'passed' : 'failed'}`}.`
+        : '';
+    const header = `Generated a ${g.standard} ${g.output} document${checked}.${seal}`;
     if (g.output === 'pdf') {
         const where = g.outputPath ? ` Written to ${g.outputPath} (${plural(g.bytesWritten ?? 0, 'byte')}).` : '';
         return `${header}${where}`;

package/dist/tools/shared.js

@@ -161,6 +161,9 @@ export async function runGenerate(input, deps) {
             output,
             facturxProfile: input.facturxProfile,
             verify: input.verify ?? true,
+            // Always seal so the tool can hand back the document sha256 and the
+            // validation verdict for the model to cite.
+            seal: true,
         });
     }
     catch (err) {
@@ -183,6 +186,7 @@ export async function runGenerate(input, deps) {
             return errorResult(`Could not write the document: ${err.message}`);
         }
     }
+    const vr = result.validationResult;
     const text = summarizeGenerate({
         standard: input.standard,
         output,
@@ -190,6 +194,8 @@ export async function runGenerate(input, deps) {
         outputPath,
         bytesWritten,
         xml: output === 'xml' ? result.xml : undefined,
+        sha256: result.sha256,
+        valid: vr?.valid,
     });
     return {
         content: [{ type: 'text', text }],
@@ -201,6 +207,17 @@ export async function runGenerate(input, deps) {
             outputPath,
             bytesWritten,
             xml: output === 'xml' ? result.xml : undefined,
+            sha256: result.sha256,
+            rulesetSha256: result.meta.rulesetSha256,
+            livemode: result.meta.livemode,
+            validationResult: vr
+                ? {
+                    valid: vr.valid,
+                    schematronVersion: vr.schematronVersion,
+                    errors: vr.errors ?? [],
+                    warnings: vr.warnings ?? [],
+                }
+                : undefined,
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beliq-mcp",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "beliq MCP server: validate, parse, generate, and convert EU e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS) against authority-pinned, drift-checked rules, for MCP clients.",
   "license": "MIT",
   "type": "module",
@@ -56,7 +56,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@beliq/sdk": "^0.1.0",
+    "@beliq/sdk": "^0.3.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3"
   },
@@ -66,6 +66,6 @@
     "@typescript-eslint/parser": "^7.18.0",
     "eslint": "^8.57.0",
     "typescript": "^5.5.4",
-    "vitest": "^2.1.8"
+    "vitest": "^3.2.6"
   }
 }