@casys/mcp-einvoice 0.1.0 → 0.1.2

package/mcp-einvoice.mjs

@@ -8205,6 +8205,7 @@ var require_stringify = __commonJS({
         nullStr: "null",
         simpleKeys: false,
         singleQuote: null,
+        trailingComma: false,
         trueStr: "true",
         verifyAliasOrder: true
       }, doc.schema.toStringOptions, options);
@@ -8722,12 +8723,19 @@ ${indent}${line}` : "\n";
         if (comment)
           reqNewline = true;
         let str = stringify.stringify(item, itemCtx, () => comment = null);
-        if (i < items.length - 1)
+        reqNewline || (reqNewline = lines.length > linesAtValue || str.includes("\n"));
+        if (i < items.length - 1) {
           str += ",";
+        } else if (ctx.options.trailingComma) {
+          if (ctx.options.lineWidth > 0) {
+            reqNewline || (reqNewline = lines.reduce((sum, line) => sum + line.length + 2, 2) + (str.length + 2) > ctx.options.lineWidth);
+          }
+          if (reqNewline) {
+            str += ",";
+          }
+        }
         if (comment)
           str += stringifyComment.lineComment(str, itemIndent, commentString(comment));
-        if (!reqNewline && (lines.length > linesAtValue || str.includes("\n")))
-          reqNewline = true;
         lines.push(str);
         linesAtValue = lines.length;
       }
@@ -11741,17 +11749,22 @@ var require_compose_node = __commonJS({
         case "block-map":
         case "block-seq":
         case "flow-collection":
-          node = composeCollection.composeCollection(CN, ctx, token, props, onError);
-          if (anchor)
-            node.anchor = anchor.source.substring(1);
+          try {
+            node = composeCollection.composeCollection(CN, ctx, token, props, onError);
+            if (anchor)
+              node.anchor = anchor.source.substring(1);
+          } catch (error2) {
+            const message2 = error2 instanceof Error ? error2.message : String(error2);
+            onError(token, "RESOURCE_EXHAUSTION", message2);
+          }
           break;
         default: {
           const message2 = token.type === "error" ? token.message : `Unsupported token (type: ${token.type})`;
           onError(token, "UNEXPECTED_TOKEN", message2);
-          node = composeEmptyNode(ctx, token.offset, void 0, null, props, onError);
           isSrcToken = false;
         }
       }
+      node ?? (node = composeEmptyNode(ctx, token.offset, void 0, null, props, onError));
       if (anchor && node.anchor === "")
         onError(anchor, "BAD_ALIAS", "Anchor cannot be an empty string");
       if (atKey && ctx.options.stringKeys && (!identity.isScalar(node) || typeof node.value !== "string" || node.tag && node.tag !== "tag:yaml.org,2002:str")) {
@@ -35496,7 +35509,7 @@ function isCloudflareWorkers() {
 var USER_AGENT;
 if (typeof navigator === "undefined" || !navigator.userAgent?.startsWith?.("Mozilla/5.0 ")) {
   const NAME = "jose";
-  const VERSION2 = "v6.2.1";
+  const VERSION2 = "v6.2.2";
   USER_AGENT = `${NAME}/${VERSION2}`;
 }
 var customFetch = Symbol();
@@ -35907,6 +35920,37 @@ async function loadYamlAuth(path) {
 var MCP_APP_MIME_TYPE = "text/html;profile=mcp-app";
 var MCP_APP_URI_SCHEME = "ui:";
 
+// node_modules/@casys/mcp-server/src/ui/viewer-utils.ts
+var SKIP_DIRS = /* @__PURE__ */ new Set(["shared", "dist", "node_modules", ".cache", ".vite"]);
+function fileUrlToPath(url2) {
+  const decoded = decodeURIComponent(url2.pathname);
+  if (/^\/[A-Za-z]:\//.test(decoded)) return decoded.slice(1);
+  if (url2.host.length > 0) return `//${url2.host}${decoded}`;
+  return decoded;
+}
+function resolveViewerDistPath(moduleUrl, viewerName, exists) {
+  const candidates = [
+    fileUrlToPath(new URL(`./src/ui/dist/${viewerName}/index.html`, moduleUrl)),
+    fileUrlToPath(new URL(`./ui-dist/${viewerName}/index.html`, moduleUrl))
+  ];
+  for (const candidate of candidates) {
+    if (exists(candidate)) return candidate;
+  }
+  return null;
+}
+function discoverViewers(uiDir, fs) {
+  const entries = fs.readDir(uiDir);
+  const viewers = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory) continue;
+    if (entry.name.startsWith(".")) continue;
+    if (SKIP_DIRS.has(entry.name)) continue;
+    if (!fs.hasIndexHtml(uiDir, entry.name)) continue;
+    viewers.push(entry.name);
+  }
+  return viewers.sort();
+}
+
 // node_modules/@casys/mcp-server/src/security/csp.ts
 function buildCspHeader(options = {}) {
   const allowInline = options.allowInline !== false;
@@ -36748,6 +36792,63 @@ var ConcurrentMCPServer = class _ConcurrentMCPServer {
     }
     this.log(`Registered ${resources.length} resources`);
   }
+  /**
+   * Register MCP Apps viewers with automatic dist path resolution.
+   *
+   * Replaces the manual pattern of: enumerate viewers → resolve paths → register resources.
+   * Each viewer gets a `ui://{prefix}/{viewerName}` resource URI.
+   *
+   * Viewers whose dist is not found are skipped with a warning (not an error),
+   * so that the server can start in dev without building UIs first.
+   *
+   * @returns Summary of registered and skipped viewers
+   */
+  registerViewers(config2) {
+    if (!config2.prefix) {
+      throw new Error("[ConcurrentMCPServer] registerViewers: prefix is required");
+    }
+    let viewerNames;
+    if (config2.viewers) {
+      viewerNames = config2.viewers;
+    } else if (config2.discover) {
+      viewerNames = discoverViewers(config2.discover.uiDir, config2.discover);
+    } else {
+      viewerNames = [];
+    }
+    const humanNameFn = config2.humanName ?? defaultHumanName;
+    const registered = [];
+    const skipped = [];
+    for (const viewerName of viewerNames) {
+      const distPath = resolveViewerDistPath(config2.moduleUrl, viewerName, config2.exists);
+      if (!distPath) {
+        this.log(
+          `Warning: UI not built for ui://${config2.prefix}/${viewerName}. Run the UI build step first.`
+        );
+        skipped.push(viewerName);
+        continue;
+      }
+      const resourceUri = `ui://${config2.prefix}/${viewerName}`;
+      const readFile3 = config2.readFile;
+      const currentDistPath = distPath;
+      this.registerResource(
+        {
+          uri: resourceUri,
+          name: humanNameFn(viewerName),
+          description: `MCP App: ${viewerName}`,
+          mimeType: MCP_APP_MIME_TYPE
+        },
+        async () => {
+          const html = await Promise.resolve(readFile3(currentDistPath));
+          return { uri: resourceUri, mimeType: MCP_APP_MIME_TYPE, text: html };
+        }
+      );
+      registered.push(viewerName);
+    }
+    if (registered.length > 0) {
+      this.log(`Registered ${registered.length} viewer(s): ${registered.join(", ")}`);
+    }
+    return { registered, skipped };
+  }
   /**
    * Start the MCP server with stdio transport
    */
@@ -37609,6 +37710,100 @@ data: ${JSON.stringify(message2)}
     }
   }
 };
+function defaultHumanName(name) {
+  return name.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+
+// node_modules/@casys/mcp-server/src/inspector/launcher.ts
+async function launchInspector(serverCommand, serverArgs, options) {
+  const port = options?.port ?? 6274;
+  const shouldOpen = options?.open ?? true;
+  const filteredArgs = serverArgs.filter((a) => a !== "--inspect");
+  const inspectorEnv = {
+    ...options?.env,
+    CLIENT_PORT: String(port)
+  };
+  console.error(`[mcp-inspector] Starting inspector on http://localhost:${port}`);
+  console.error(`[mcp-inspector] Server: ${serverCommand} ${filteredArgs.join(" ")}`);
+  const command = new Deno.Command("npx", {
+    args: [
+      "-y",
+      "@modelcontextprotocol/inspector",
+      serverCommand,
+      ...filteredArgs
+    ],
+    env: {
+      ...Deno.env.toObject(),
+      ...inspectorEnv
+    },
+    stdin: "inherit",
+    stdout: "inherit",
+    stderr: "inherit"
+  });
+  const process4 = command.spawn();
+  if (shouldOpen) {
+    setTimeout(() => {
+      openBrowser(`http://localhost:${port}`).catch(() => {
+      });
+    }, 2e3);
+  }
+  const status = await process4.status;
+  if (!status.success) {
+    console.error(`[mcp-inspector] Inspector exited with code ${status.code}`);
+    Deno.exit(status.code);
+  }
+}
+async function openBrowser(url2) {
+  const os = Deno.build.os;
+  let cmd;
+  if (os === "darwin") {
+    cmd = ["open", url2];
+  } else if (os === "windows") {
+    cmd = ["cmd", "/c", "start", url2];
+  } else {
+    cmd = ["xdg-open", url2];
+  }
+  const process4 = new Deno.Command(cmd[0], {
+    args: cmd.slice(1),
+    stdin: "null",
+    stdout: "null",
+    stderr: "null"
+  });
+  await process4.spawn().status;
+}
+
+// src/adapters/shared/errors.ts
+var NotSupportedError = class extends Error {
+  constructor(adapter, method, alternative) {
+    super(`[${adapter}] ${method} is not supported. ${alternative}`);
+    this.name = "NotSupportedError";
+  }
+};
+var AdapterAPIError = class extends Error {
+  constructor(adapter, message2, status, body) {
+    super(message2);
+    this.status = status;
+    this.body = body;
+    this.name = `${adapter}APIError`;
+  }
+};
+
+// src/tools/error-mapper.ts
+function einvoiceErrorMapper(error2, toolName) {
+  if (error2 instanceof NotSupportedError) {
+    return error2.message;
+  }
+  if (error2 instanceof AdapterAPIError) {
+    return `[${toolName}] API error ${error2.status}: ${error2.message.slice(0, 300)}`;
+  }
+  if (error2 instanceof Error) {
+    if (error2.message.includes("is required") || error2.message.includes("must ")) {
+      return error2.message;
+    }
+    return `[${toolName}] ${error2.message.slice(0, 300)}`;
+  }
+  return null;
+}
 
 // src/generated-store.ts
 var EXPIRY_MS = 10 * 60 * 1e3;
@@ -37633,72 +37828,60 @@ function getGenerated(id) {
   return { file: entry.file, filename: entry.filename };
 }
 
-// src/tools/invoice.ts
-function normalizeInvoiceForGenerate(inv) {
-  const normalized = { ...inv };
-  for (const party of ["seller", "buyer"]) {
-    if (normalized[party] && !normalized[party].postalAddress) {
-      normalized[party] = {
-        ...normalized[party],
-        postalAddress: { country: normalized[party].country ?? "FR" }
-      };
-    }
-  }
-  for (const party of ["seller", "buyer"]) {
-    const p = normalized[party];
-    if (p && !p.electronicAddress && p.siren && p.siret) {
-      normalized[party] = {
-        ...p,
-        electronicAddress: `0225:${p.siren}_${p.siret}`,
-        identifiers: p.identifiers ?? [
-          { type: "ELECTRONIC_ADDRESS", value: `${p.siren}_${p.siret}`, scheme: "0225" },
-          { type: "PARTY_LEGAL_IDENTIFIER", value: p.siren, scheme: "0002" }
-        ]
-      };
-    }
-  }
-  if (Array.isArray(normalized.paymentTerms)) {
-    normalized.paymentTerms = normalized.paymentTerms.map((t) => t.description ?? t).join("; ");
+// src/adapters/shared/encoding.ts
+function uint8ToBase64(data) {
+  let binary = "";
+  for (let i = 0; i < data.length; i += 8192) {
+    binary += String.fromCharCode(...data.subarray(i, i + 8192));
   }
-  return normalized;
+  return btoa(binary);
 }
+function encodePathSegment(s) {
+  return encodeURIComponent(s);
+}
+
+// src/tools/invoice.ts
 function mapToViewerPreview(inv) {
   const lines = (inv.lines ?? []).map((l) => {
     const line = l;
     return {
-      description: line.item?.name ?? line.description,
+      description: line.item?.name ?? line.description ?? line.name,
       quantity: line.billedQuantity?.quantity ?? line.quantity,
-      unit_price: line.price?.netAmount?.amount ?? line.unit_price,
-      tax_rate: line.taxDetail?.percent ?? line.tax_rate,
+      unit_price: line.price?.netAmount?.amount ?? line.unitPrice ?? line.unit_price,
+      tax_rate: line.taxDetail?.percent ?? line.taxRate ?? line.tax_rate,
       amount: line.totalAmount?.amount ?? line.amount
     };
   });
   return {
     id: "(aper\xE7u)",
-    invoice_number: inv.invoiceId,
-    issue_date: inv.invoiceDate,
-    due_date: inv.invoiceDueDate,
-    invoice_type: inv.detailedType?.value ?? inv.type,
-    sender_name: inv.seller?.name,
-    sender_id: inv.seller?.siret ?? inv.seller?.siren,
-    sender_vat: inv.seller?.vatNumber,
-    receiver_name: inv.buyer?.name,
-    receiver_id: inv.buyer?.siret ?? inv.buyer?.siren,
-    receiver_vat: inv.buyer?.vatNumber,
-    currency: inv.monetary?.invoiceCurrency ?? "EUR",
-    total_ht: inv.monetary?.taxBasisTotalAmount?.amount ?? inv.monetary?.lineTotalAmount?.amount,
-    total_tax: inv.monetary?.taxTotalAmount?.amount,
-    total_ttc: inv.monetary?.invoiceAmount?.amount ?? inv.monetary?.payableAmount?.amount,
+    invoice_number: inv.invoiceId ?? inv.invoice_id ?? inv.invoiceNumber,
+    issue_date: inv.invoiceDate ?? inv.issue_date ?? inv.issueDate,
+    due_date: inv.invoiceDueDate ?? inv.due_date ?? inv.dueDate,
+    invoice_type: inv.detailedType?.value ?? inv.type ?? inv.invoiceType,
+    sender_name: inv.seller?.name ?? inv.senderName,
+    sender_id: inv.seller?.siret ?? inv.seller?.siren ?? inv.senderId,
+    sender_vat: inv.seller?.vatNumber ?? inv.senderVat,
+    receiver_name: inv.buyer?.name ?? inv.receiverName,
+    receiver_id: inv.buyer?.siret ?? inv.buyer?.siren ?? inv.receiverId,
+    receiver_vat: inv.buyer?.vatNumber ?? inv.receiverVat,
+    currency: inv.monetary?.invoiceCurrency ?? inv.currency ?? "EUR",
+    total_ht: inv.monetary?.taxBasisTotalAmount?.amount ?? inv.monetary?.lineTotalAmount?.amount ?? inv.totalHt,
+    total_tax: inv.monetary?.taxTotalAmount?.amount ?? inv.totalTax,
+    total_ttc: inv.monetary?.invoiceAmount?.amount ?? inv.monetary?.payableAmount?.amount ?? inv.totalTtc ?? inv.total_amount,
     items: lines,
     status: "aper\xE7u",
     direction: "sent"
   };
 }
+var GENERATE_HINT = "Before generating, call einvoice_config_entities_list to verify the seller is registered. After generating, the user can submit directly via the viewer button. ";
+var INVOICE_SCHEMA_DESCRIPTION = 'Invoice data (the adapter normalizes format-specific fields internally). Required fields: invoiceId (string): invoice number; invoiceDate (string, YYYY-MM-DD): issue date; type (number): invoice type code (380 = commercial invoice); invoiceDueDate (string, YYYY-MM-DD): due date; seller (object): { name, siren, siret, country, vatNumber }; buyer (object): same structure as seller; monetary (object): { invoiceCurrency, invoiceAmount: { amount }, taxTotalAmount: { amount }, lineTotalAmount: { amount }, taxBasisTotalAmount: { amount } }; taxDetails (array): [{ percent, taxType: "VAT", categoryCode: "S", taxableAmount: { amount }, taxAmount: { amount } }]; lines (array): [{ id, item: { name }, billedQuantity: { quantity, unitCode }, price: { netAmount: { amount } }, totalAmount: { amount }, taxDetail: { percent } }]';
 var invoiceTools = [
   // ── Emit ────────────────────────────────────────────────
   {
-    name: "einvoice_invoice_emit",
-    description: "Emit (send) an invoice via the e-invoicing platform. Provide EITHER a generated_id (from a generate preview) OR file_base64 + filename. Asynchronous \u2014 returns a GUID to track the request.",
+    name: "einvoice_invoice_submit",
+    annotations: { destructiveHint: true },
+    requires: ["emitInvoice"],
+    description: "Submit an invoice to the e-invoicing platform. Usually triggered by the viewer's Submit button \u2014 do not call manually after a generate preview. Accepts generated_id OR file_base64 + filename.",
     category: "invoice",
     inputSchema: {
       type: "object",
@@ -37722,22 +37905,27 @@ var invoiceTools = [
         const stored = getGenerated(input.generated_id);
         if (!stored) {
           throw new Error(
-            "[einvoice_invoice_emit] Generated file expired or not found. Regenerate the invoice first."
+            "[einvoice_invoice_submit] Generated file expired or not found. Regenerate the invoice first."
           );
         }
         return await ctx.adapter.emitInvoice(stored);
       }
       if (!input.file_base64 || !input.filename) {
         throw new Error(
-          "[einvoice_invoice_emit] Provide either 'generated_id' or both 'file_base64' and 'filename'"
+          "[einvoice_invoice_submit] Provide either 'generated_id' or both 'file_base64' and 'filename'"
         );
       }
       const filename = input.filename;
       const lower = filename.toLowerCase();
       if (!lower.endsWith(".pdf") && !lower.endsWith(".xml")) {
-        throw new Error("[einvoice_invoice_emit] filename must end in .pdf or .xml");
+        throw new Error("[einvoice_invoice_submit] filename must end in .pdf or .xml");
+      }
+      let binaryString;
+      try {
+        binaryString = atob(input.file_base64);
+      } catch {
+        throw new Error("[einvoice_invoice_submit] 'file_base64' is not valid base64");
       }
-      const binaryString = atob(input.file_base64);
       const bytes = new Uint8Array(binaryString.length);
       for (let i = 0; i < binaryString.length; i++) {
         bytes[i] = binaryString.charCodeAt(i);
@@ -37748,69 +37936,103 @@ var invoiceTools = [
   // ── Search ──────────────────────────────────────────────
   {
     name: "einvoice_invoice_search",
+    annotations: { readOnlyHint: true },
     _meta: { ui: { resourceUri: "ui://mcp-einvoice/doclist-viewer" } },
-    description: "Search invoices using a query string. Returns paginated results. The query uses Lucene-like syntax (e.g. 'status:accepted AND direction:received'). Use expand to include additional data in results.",
+    requires: ["searchInvoices"],
+    description: "Search invoices. Use direction and status to filter. Query searches by sender name, receiver name, or invoice number. Use the direction and status parameters for filtering \u2014 not the query.",
     category: "invoice",
     inputSchema: {
       type: "object",
       properties: {
         q: {
           type: "string",
-          description: "Search query (Lucene-like syntax). Examples: 'status:accepted', 'direction:received', 'senderName:Acme'."
+          description: "Search query (e.g. company name, invoice number). Omit to list all."
         },
-        expand: {
+        direction: {
           type: "string",
-          description: "Comma-separated list of fields to expand in results (default: 'businessData' \u2014 needed for formatted output)"
+          description: "Filter by direction",
+          enum: ["received", "sent"]
+        },
+        status: {
+          type: "string",
+          description: "Filter by lifecycle status (after enrichment)",
+          enum: [
+            "SUBMITTED",
+            "ISSUED",
+            "MADE_AVAILABLE",
+            "DELIVERED",
+            "IN_HAND",
+            "APPROVED",
+            "PARTIALLY_APPROVED",
+            "REFUSED",
+            "DISPUTED",
+            "SUSPENDED",
+            "PAYMENT_SENT",
+            "PAYMENT_RECEIVED",
+            "COMPLETED",
+            "WRONG_ROUTING",
+            "INVALID",
+            "DUPLICATED"
+          ]
         },
         offset: { type: "number", description: "Result offset (default 0)" },
-        limit: { type: "number", description: "Max results to return (default 50, max 200)" }
+        limit: { type: "number", description: "Max results (default 50, max 200)" }
       }
     },
     handler: async (input, ctx) => {
       let q = input.q;
       if (q != null && /^\s*\*?\s*$/.test(q)) q = void 0;
-      const result = await ctx.adapter.searchInvoices({
+      const dirFilter = input.direction;
+      const statusFilter = input.status;
+      const { rows: rawRows, count } = await ctx.adapter.searchInvoices({
         q,
-        expand: input.expand ?? "businessData",
+        direction: dirFilter,
+        status: statusFilter,
         offset: input.offset,
         limit: input.limit
       });
-      const meta3 = result.meta;
-      if (meta3?.count != null && result.count == null) result.count = meta3.count;
-      const data = result.data;
-      if (Array.isArray(data)) {
-        result.data = data.map((row) => {
-          const m = row.metadata ?? {};
-          const bd = row.businessData ?? {};
-          const dateRaw = bd.invoiceDate ?? m.createDate?.split("T")[0];
-          const amount = bd.monetary?.invoiceAmount?.amount;
-          const currency = bd.monetary?.invoiceCurrency ?? "EUR";
-          return {
-            _id: m.invoiceId,
-            "N\xB0": bd.invoiceId ?? "\u2014",
-            "Statut": m.state,
-            "Direction": m.direction === "INBOUND" ? "Re\xE7ue" : m.direction === "OUTBOUND" ? "\xC9mise" : m.direction,
-            "\xC9metteur": bd.seller?.name ?? "\u2014",
-            "Destinataire": bd.buyer?.name ?? "\u2014",
-            "Date": dateRaw ? new Date(dateRaw).toLocaleDateString("fr-FR", { day: "numeric", month: "short", year: "numeric" }) : "\u2014",
-            "Montant": amount != null ? `${amount.toLocaleString("fr-FR")} ${currency}` : "\u2014"
-          };
-        });
-      }
-      return {
-        ...result,
+      let rows = rawRows;
+      if (dirFilter) rows = rows.filter((r) => r.direction === dirFilter);
+      if (statusFilter) rows = rows.filter((r) => r.status === statusFilter);
+      const data = rows.map((r) => {
+        const shortDate = r.date ? new Date(r.date).toLocaleDateString("fr-FR", { day: "numeric", month: "short" }) : "";
+        const tiers = r.direction === "sent" ? r.receiverName : r.senderName;
+        return {
+          _id: r.id,
+          _direction: r.direction,
+          "Direction": r.direction === "received" ? "Entrante" : r.direction === "sent" ? "Sortante" : "\u2014",
+          "N\xB0": r.invoiceNumber ?? "\u2014",
+          "Statut": r.status ?? "\u2014",
+          "Tiers": tiers ?? "\u2014",
+          "Date": shortDate || "\u2014",
+          "Montant": r.amount != null ? `${Number(r.amount).toLocaleString("fr-FR")} ${r.currency ?? "EUR"}` : "\u2014"
+        };
+      });
+      const dirLabel = dirFilter === "received" ? "re\xE7ues" : dirFilter === "sent" ? "envoy\xE9es" : "";
+      const statusLabel = statusFilter ?? "";
+      const titleParts = ["Factures", dirLabel, statusLabel ? `(${statusLabel})` : ""].filter(Boolean);
+      const viewerData = {
+        data,
+        count: rows.length !== rawRows.length ? rows.length : count ?? rows.length,
+        _title: titleParts.join(" "),
         _rowAction: {
           toolName: "einvoice_invoice_get",
           idField: "_id",
           argName: "id"
         }
       };
+      return {
+        content: `${rows.length} ${titleParts.join(" ")} trouv\xE9es`,
+        structuredContent: viewerData
+      };
     }
   },
   // ── Get by ID ───────────────────────────────────────────
   {
     name: "einvoice_invoice_get",
+    annotations: { readOnlyHint: true },
     _meta: { ui: { resourceUri: "ui://mcp-einvoice/invoice-viewer" } },
+    requires: ["getInvoice"],
     description: "Get a single invoice by its ID. Returns full invoice details including status history, sender/receiver info, and line items.",
     category: "invoice",
     inputSchema: {
@@ -37824,73 +38046,48 @@ var invoiceTools = [
       if (!input.id) {
         throw new Error("[einvoice_invoice_get] 'id' is required");
       }
-      const raw2 = await ctx.adapter.getInvoice(input.id);
-      const inv = Array.isArray(raw2) ? raw2[0] : raw2;
-      if (!inv?.businessData) {
-        return {
-          id: inv?.invoiceId,
-          status: inv?.state ?? inv?.status ?? "UNKNOWN",
-          direction: (() => {
-            const d = inv?.way ?? inv?.metadata?.direction;
-            if (!d) return void 0;
-            if (d === "RECEIVED" || d === "INBOUND") return "received";
-            if (d === "SENT" || d === "EMITTED" || d === "OUTBOUND") return "sent";
-            return d.toLowerCase();
-          })(),
-          format: inv?.originalFormat,
-          network: inv?.originalNetwork,
-          issue_date: inv?.date
-        };
-      }
-      const bd = inv.businessData;
-      const lines = (bd.lines ?? []).map((l) => {
-        const line = l;
-        return {
-          description: line.item?.name,
-          quantity: line.billedQuantity?.quantity,
-          unit_price: line.price?.netAmount?.amount,
-          tax_rate: line.taxDetail?.percent,
-          amount: line.totalAmount?.amount
-        };
-      });
-      return {
-        id: inv.invoiceId,
-        invoice_number: bd.invoiceId,
-        status: inv.state ?? inv.status,
-        direction: (() => {
-          const d = inv.way ?? inv.metadata?.direction;
-          if (!d) return void 0;
-          if (d === "RECEIVED" || d === "INBOUND") return "received";
-          if (d === "SENT" || d === "EMITTED" || d === "OUTBOUND") return "sent";
-          return d.toLowerCase();
-        })(),
-        format: inv.originalFormat,
-        network: inv.originalNetwork,
-        invoice_type: bd.detailedType?.value,
-        sender_name: bd.seller?.name,
-        sender_id: bd.seller?.siret ?? bd.seller?.siren,
-        sender_vat: bd.seller?.vatNumber,
-        receiver_name: bd.buyer?.name,
-        receiver_id: bd.buyer?.siret ?? bd.buyer?.siren,
-        receiver_vat: bd.buyer?.vatNumber,
-        issue_date: bd.invoiceDate,
-        due_date: bd.invoiceDueDate,
-        receipt_date: bd.invoiceReceiptDate,
-        currency: bd.monetary?.invoiceCurrency ?? "EUR",
-        total_ht: bd.monetary?.taxBasisTotalAmount?.amount,
-        total_tax: bd.monetary?.taxTotalAmount?.amount,
-        total_ttc: bd.monetary?.invoiceAmount?.amount,
-        items: lines,
-        notes: (bd.notes ?? []).map((n) => {
-          const note = n;
-          return note.content;
-        }).filter(Boolean)
+      const id = input.id;
+      const inv = await ctx.adapter.getInvoice(id);
+      const isTerminal2 = ["REFUSED", "COMPLETED", "CANCELLED", "PAYMENT_RECEIVED", "UNKNOWN"].includes(inv.status ?? "");
+      const viewerData = {
+        id: inv.id,
+        invoice_number: inv.invoiceNumber,
+        status: inv.status,
+        direction: inv.direction,
+        format: inv.format,
+        network: inv.network,
+        invoice_type: inv.invoiceType,
+        sender_name: inv.senderName,
+        sender_id: inv.senderId,
+        sender_vat: inv.senderVat,
+        receiver_name: inv.receiverName,
+        receiver_id: inv.receiverId,
+        receiver_vat: inv.receiverVat,
+        issue_date: inv.issueDate,
+        due_date: inv.dueDate,
+        receipt_date: inv.receiptDate,
+        currency: inv.currency,
+        total_ht: inv.totalHt,
+        total_tax: inv.totalTax,
+        total_ttc: inv.totalTtc,
+        items: inv.lines?.map((l) => ({
+          description: l.description,
+          quantity: l.quantity,
+          unit_price: l.unitPrice,
+          tax_rate: l.taxRate,
+          amount: l.amount
+        })),
+        notes: inv.notes,
+        ...!isTerminal2 && inv.direction !== "received" ? { refreshRequest: { toolName: "einvoice_invoice_get", arguments: { id } } } : {}
       };
+      const summary = `Invoice ${inv.invoiceNumber ?? inv.id} \u2014 ${inv.status ?? "unknown"}, ${inv.direction ?? ""}, ${inv.totalTtc != null ? inv.totalTtc + " " + (inv.currency ?? "EUR") : "no amount"}`;
+      return { content: summary, structuredContent: viewerData };
     }
   },
   // ── Download ────────────────────────────────────────────
   {
     name: "einvoice_invoice_download",
+    requires: ["downloadInvoice"],
     description: "Download the source file of an invoice (original CII/UBL/Factur-X XML). Returns base64-encoded content.",
     category: "invoice",
     inputSchema: {
@@ -37905,17 +38102,16 @@ var invoiceTools = [
         throw new Error("[einvoice_invoice_download] 'id' is required");
       }
       const { data, contentType } = await ctx.adapter.downloadInvoice(input.id);
-      let binary = "";
-      for (let i = 0; i < data.length; i += 8192) {
-        binary += String.fromCharCode(...data.subarray(i, i + 8192));
-      }
-      const base643 = btoa(binary);
-      return { content_type: contentType, data_base64: base643, size_bytes: data.length };
+      return {
+        content: `Downloaded invoice source (${contentType}, ${data.length} bytes)`,
+        structuredContent: { content_type: contentType, data_base64: uint8ToBase64(data), size_bytes: data.length }
+      };
     }
   },
   // ── Download readable ───────────────────────────────────
   {
     name: "einvoice_invoice_download_readable",
+    requires: ["downloadReadable"],
     description: "Download a human-readable PDF version of an invoice. Returns base64-encoded PDF.",
     category: "invoice",
     inputSchema: {
@@ -37930,17 +38126,16 @@ var invoiceTools = [
         throw new Error("[einvoice_invoice_download_readable] 'id' is required");
       }
       const { data, contentType } = await ctx.adapter.downloadReadable(input.id);
-      let binary = "";
-      for (let i = 0; i < data.length; i += 8192) {
-        binary += String.fromCharCode(...data.subarray(i, i + 8192));
-      }
-      const base643 = btoa(binary);
-      return { content_type: contentType, data_base64: base643, size_bytes: data.length };
+      return {
+        content: `Downloaded readable PDF (${data.length} bytes)`,
+        structuredContent: { content_type: contentType, data_base64: uint8ToBase64(data), size_bytes: data.length }
+      };
     }
   },
   // ── Invoice Files ─────────────────────────────────────────
   {
     name: "einvoice_invoice_files",
+    requires: ["getInvoiceFiles"],
     description: "Get metadata of ALL related files for an invoice (source XML, readable PDF, attachments). Use einvoice_invoice_attachments for only business attachments.",
     category: "invoice",
     inputSchema: {
@@ -37960,6 +38155,7 @@ var invoiceTools = [
   // ── Attachments ─────────────────────────────────────────
   {
     name: "einvoice_invoice_attachments",
+    requires: ["getAttachments"],
     description: "Get only business attachments (supporting documents, purchase orders, etc.) for an invoice. Use einvoice_invoice_files for ALL related files including source XML and PDF.",
     category: "invoice",
     inputSchema: {
@@ -37979,6 +38175,7 @@ var invoiceTools = [
   // ── Download File ───────────────────────────────────────
   {
     name: "einvoice_invoice_download_file",
+    requires: ["downloadFile"],
     description: "Download a specific file by its file ID. Returns base64-encoded content.",
     category: "invoice",
     inputSchema: {
@@ -37993,90 +38190,34 @@ var invoiceTools = [
         throw new Error("[einvoice_invoice_download_file] 'file_id' is required");
       }
       const { data, contentType } = await ctx.adapter.downloadFile(input.file_id);
-      let binary = "";
-      for (let i = 0; i < data.length; i += 8192) {
-        binary += String.fromCharCode(...data.subarray(i, i + 8192));
-      }
-      const base643 = btoa(binary);
-      return { content_type: contentType, data_base64: base643, size_bytes: data.length };
-    }
-  },
-  // ── Mark as seen ────────────────────────────────────────
-  {
-    name: "einvoice_invoice_mark_seen",
-    description: "Mark an invoice as seen/read. Useful for tracking which invoices have been processed.",
-    category: "invoice",
-    inputSchema: {
-      type: "object",
-      properties: {
-        id: { type: "string", description: "Invoice ID" }
-      },
-      required: ["id"]
-    },
-    handler: async (input, ctx) => {
-      if (!input.id) {
-        throw new Error("[einvoice_invoice_mark_seen] 'id' is required");
-      }
-      return await ctx.adapter.markInvoiceSeen(input.id);
-    }
-  },
-  // ── Not seen ────────────────────────────────────────────
-  {
-    name: "einvoice_invoice_not_seen",
-    _meta: { ui: { resourceUri: "ui://mcp-einvoice/doclist-viewer" } },
-    description: "Get invoices that have not been marked as seen (PULL mode). Useful for polling new incoming invoices.",
-    category: "invoice",
-    inputSchema: {
-      type: "object",
-      properties: {
-        offset: { type: "number", description: "Result offset (default 0)" },
-        limit: { type: "number", description: "Max results (default 50)" }
-      }
-    },
-    handler: async (input, ctx) => {
-      const result = await ctx.adapter.getUnseenInvoices({
-        offset: input.offset,
-        limit: input.limit
-      });
-      const data = result.data;
-      if (Array.isArray(data)) {
-        result.data = data.map((row) => {
-          const m = row.metadata ?? row;
-          const dateRaw = m.createDate?.split("T")[0];
-          return {
-            _id: m.invoiceId,
-            "Statut": m.state,
-            "Direction": m.direction === "INBOUND" ? "Re\xE7ue" : m.direction === "OUTBOUND" ? "\xC9mise" : m.direction,
-            "Date": dateRaw ? new Date(dateRaw).toLocaleDateString("fr-FR", { day: "numeric", month: "short", year: "numeric" }) : "\u2014"
-          };
-        });
-      }
       return {
-        ...result,
-        _rowAction: {
-          toolName: "einvoice_invoice_get",
-          idField: "_id",
-          argName: "id"
-        }
+        content: `Downloaded file (${contentType}, ${data.length} bytes)`,
+        structuredContent: { content_type: contentType, data_base64: uint8ToBase64(data), size_bytes: data.length }
       };
     }
   },
+  // ── seen/notSeen tools removed ──────────────────────────
+  // Iopole's seen/notSeen mechanism is opaque: `seen` is not exposed in
+  // search or getInvoice, and `notSeen` always returns empty in PUSH mode
+  // (active webhook). Removed in v0.2.0 — see docs/CHANGELOG.md.
   // ── Generate CII ────────────────────────────────────────
   {
     name: "einvoice_invoice_generate_cii",
     _meta: { ui: { resourceUri: "ui://mcp-einvoice/invoice-viewer" } },
-    description: "Generate a CII invoice preview. Validates and converts to CII XML. Returns a preview for review. Use einvoice_invoice_emit with the generated_id to send. Requires a flavor (e.g. EN16931).",
+    requires: ["generateCII"],
+    description: GENERATE_HINT + "Generate a CII invoice preview. Validates and converts to CII XML. Returns a preview for review. Use einvoice_invoice_submit with the generated_id to send. Requires a flavor (e.g. EN16931).",
     category: "invoice",
     inputSchema: {
       type: "object",
       properties: {
         invoice: {
           type: "object",
-          description: 'Invoice data in Iopole format. Required fields: invoiceId (string, max 20 chars): invoice number e.g. "CASYS-001"; invoiceDate (string, YYYY-MM-DD): issue date; type (number): invoice type code, usually 380 for commercial invoice; processType (string): e.g. "B1" for goods; invoiceDueDate (string, YYYY-MM-DD): due date; seller (object): { name, siren, siret, country, vatNumber, electronicAddress (format "0225:siren_siret"), identifiers: [{ type: "ELECTRONIC_ADDRESS", value: "siren_siret", scheme: "0225" }] }; buyer (object): same structure as seller; monetary (object): { invoiceCurrency: "EUR", invoiceAmount: { amount }, payableAmount: { amount }, taxTotalAmount: { amount, currency: "EUR" }, lineTotalAmount: { amount }, taxBasisTotalAmount: { amount } }; taxDetails (array): [{ percent, taxType: "VAT", categoryCode: "S", taxableAmount: { amount }, taxAmount: { amount } }]; lines (array): [{ id: "1", item: { name }, billedQuantity: { quantity, unitCode: "DAY"|"C62" }, price: { netAmount: { amount }, baseQuantity: { quantity: 1, unitCode } }, totalAmount: { amount }, taxDetail: { percent, taxType: "VAT", categoryCode: "S" } }]; paymentTerms (string, optional): payment conditions text; notes (array, optional): [{ type: { code: "PMT" }, content: "..." }]'
+          description: INVOICE_SCHEMA_DESCRIPTION
         },
         flavor: {
           type: "string",
-          description: "CII profile flavor (e.g. EN16931, MINIMUM, BASIC_WL, BASIC, EXTENDED)"
+          description: "CII profile flavor",
+          enum: ["EN16931", "EXTENDED"]
         }
       },
       required: ["invoice", "flavor"]
@@ -38085,19 +38226,21 @@ var invoiceTools = [
       if (!input.invoice || !input.flavor) {
         throw new Error("[einvoice_invoice_generate_cii] 'invoice' and 'flavor' are required");
       }
-      const inv = normalizeInvoiceForGenerate(input.invoice);
-      const result = await ctx.adapter.generateCII({
+      const inv = input.invoice;
+      const xml = await ctx.adapter.generateCII({
         invoice: inv,
         flavor: input.flavor
       });
-      const raw2 = typeof result === "string" ? result : JSON.stringify(result);
-      const bytes = new TextEncoder().encode(raw2);
+      const bytes = new TextEncoder().encode(xml);
       const filename = `${inv.invoiceId ?? "invoice"}.xml`;
       const generated_id = storeGenerated(bytes, filename);
       return {
-        generated_id,
-        filename,
-        preview: mapToViewerPreview(input.invoice)
+        content: `Invoice preview generated (${filename}). The user can review and submit via the viewer button.`,
+        structuredContent: {
+          generated_id,
+          filename,
+          preview: mapToViewerPreview(inv)
+        }
       };
     }
   },
@@ -38105,18 +38248,20 @@ var invoiceTools = [
   {
     name: "einvoice_invoice_generate_ubl",
     _meta: { ui: { resourceUri: "ui://mcp-einvoice/invoice-viewer" } },
-    description: "Generate a UBL invoice preview. Validates and converts to UBL XML. Returns a preview for review. Use einvoice_invoice_emit with the generated_id to send. Requires a flavor (e.g. EN16931).",
+    requires: ["generateUBL"],
+    description: GENERATE_HINT + "Generate a UBL invoice preview. Validates and converts to UBL XML. Returns a preview for review. Use einvoice_invoice_submit with the generated_id to send. Requires a flavor (e.g. EN16931).",
     category: "invoice",
     inputSchema: {
       type: "object",
       properties: {
         invoice: {
           type: "object",
-          description: 'Invoice data in Iopole format. Required fields: invoiceId (string, max 20 chars): invoice number e.g. "CASYS-001"; invoiceDate (string, YYYY-MM-DD): issue date; type (number): invoice type code, usually 380 for commercial invoice; processType (string): e.g. "B1" for goods; invoiceDueDate (string, YYYY-MM-DD): due date; seller (object): { name, siren, siret, country, vatNumber, electronicAddress (format "0225:siren_siret"), identifiers: [{ type: "ELECTRONIC_ADDRESS", value: "siren_siret", scheme: "0225" }] }; buyer (object): same structure as seller; monetary (object): { invoiceCurrency: "EUR", invoiceAmount: { amount }, payableAmount: { amount }, taxTotalAmount: { amount, currency: "EUR" }, lineTotalAmount: { amount }, taxBasisTotalAmount: { amount } }; taxDetails (array): [{ percent, taxType: "VAT", categoryCode: "S", taxableAmount: { amount }, taxAmount: { amount } }]; lines (array): [{ id: "1", item: { name }, billedQuantity: { quantity, unitCode: "DAY"|"C62" }, price: { netAmount: { amount }, baseQuantity: { quantity: 1, unitCode } }, totalAmount: { amount }, taxDetail: { percent, taxType: "VAT", categoryCode: "S" } }]; paymentTerms (string, optional): payment conditions text; notes (array, optional): [{ type: { code: "PMT" }, content: "..." }]'
+          description: INVOICE_SCHEMA_DESCRIPTION
         },
         flavor: {
           type: "string",
-          description: "UBL profile flavor (e.g. EN16931, MINIMUM, BASIC_WL, BASIC, EXTENDED)"
+          description: "UBL profile flavor",
+          enum: ["EN16931", "PEPPOL_BIS_3"]
         }
       },
       required: ["invoice", "flavor"]
@@ -38125,19 +38270,21 @@ var invoiceTools = [
       if (!input.invoice || !input.flavor) {
         throw new Error("[einvoice_invoice_generate_ubl] 'invoice' and 'flavor' are required");
       }
-      const inv = normalizeInvoiceForGenerate(input.invoice);
-      const result = await ctx.adapter.generateUBL({
+      const inv = input.invoice;
+      const xml = await ctx.adapter.generateUBL({
         invoice: inv,
         flavor: input.flavor
       });
-      const raw2 = typeof result === "string" ? result : JSON.stringify(result);
-      const bytes = new TextEncoder().encode(raw2);
+      const bytes = new TextEncoder().encode(xml);
       const filename = `${inv.invoiceId ?? "invoice"}.xml`;
       const generated_id = storeGenerated(bytes, filename);
       return {
-        generated_id,
-        filename,
-        preview: mapToViewerPreview(input.invoice)
+        content: `Invoice preview generated (${filename}). The user can review and submit via the viewer button.`,
+        structuredContent: {
+          generated_id,
+          filename,
+          preview: mapToViewerPreview(inv)
+        }
       };
     }
   },
@@ -38145,18 +38292,20 @@ var invoiceTools = [
   {
     name: "einvoice_invoice_generate_facturx",
     _meta: { ui: { resourceUri: "ui://mcp-einvoice/invoice-viewer" } },
-    description: "Generate a Factur-X invoice preview. Creates a hybrid PDF/XML. Returns a preview for review. Use einvoice_invoice_emit with the generated_id to send. Requires a flavor (e.g. EN16931). Optionally accepts a language (FRENCH, ENGLISH, GERMAN).",
+    requires: ["generateFacturX"],
+    description: GENERATE_HINT + "Generate a Factur-X invoice preview. Creates a hybrid PDF/XML. Returns a preview for review. Use einvoice_invoice_submit with the generated_id to send. Requires a flavor (e.g. EN16931). Optionally accepts a language (FRENCH, ENGLISH, GERMAN).",
     category: "invoice",
     inputSchema: {
       type: "object",
       properties: {
         invoice: {
           type: "object",
-          description: 'Invoice data in Iopole format. Required fields: invoiceId (string, max 20 chars): invoice number e.g. "CASYS-001"; invoiceDate (string, YYYY-MM-DD): issue date; type (number): invoice type code, usually 380 for commercial invoice; processType (string): e.g. "B1" for goods; invoiceDueDate (string, YYYY-MM-DD): due date; seller (object): { name, siren, siret, country, vatNumber, electronicAddress (format "0225:siren_siret"), identifiers: [{ type: "ELECTRONIC_ADDRESS", value: "siren_siret", scheme: "0225" }] }; buyer (object): same structure as seller; monetary (object): { invoiceCurrency: "EUR", invoiceAmount: { amount }, payableAmount: { amount }, taxTotalAmount: { amount, currency: "EUR" }, lineTotalAmount: { amount }, taxBasisTotalAmount: { amount } }; taxDetails (array): [{ percent, taxType: "VAT", categoryCode: "S", taxableAmount: { amount }, taxAmount: { amount } }]; lines (array): [{ id: "1", item: { name }, billedQuantity: { quantity, unitCode: "DAY"|"C62" }, price: { netAmount: { amount }, baseQuantity: { quantity: 1, unitCode } }, totalAmount: { amount }, taxDetail: { percent, taxType: "VAT", categoryCode: "S" } }]; paymentTerms (string, optional): payment conditions text; notes (array, optional): [{ type: { code: "PMT" }, content: "..." }]'
+          description: INVOICE_SCHEMA_DESCRIPTION
         },
         flavor: {
           type: "string",
-          description: "Factur-X profile flavor (e.g. EN16931, MINIMUM, BASIC_WL, BASIC, EXTENDED)"
+          description: "Factur-X profile flavor",
+          enum: ["BASICWL", "EN16931", "EXTENDED"]
         },
         language: {
           type: "string",
@@ -38170,20 +38319,21 @@ var invoiceTools = [
       if (!input.invoice || !input.flavor) {
         throw new Error("[einvoice_invoice_generate_facturx] 'invoice' and 'flavor' are required");
       }
-      const inv = normalizeInvoiceForGenerate(input.invoice);
-      const result = await ctx.adapter.generateFacturX({
+      const inv = input.invoice;
+      const { data: bytes } = await ctx.adapter.generateFacturX({
         invoice: inv,
         flavor: input.flavor,
         language: input.language
       });
-      const raw2 = typeof result === "string" ? result : JSON.stringify(result);
-      const bytes = new TextEncoder().encode(raw2);
       const filename = `${inv.invoiceId ?? "invoice"}.pdf`;
       const generated_id = storeGenerated(bytes, filename);
       return {
-        generated_id,
-        filename,
-        preview: mapToViewerPreview(input.invoice)
+        content: `Invoice preview generated (${filename}). The user can review and submit via the viewer button.`,
+        structuredContent: {
+          generated_id,
+          filename,
+          preview: mapToViewerPreview(inv)
+        }
       };
     }
   }
@@ -38194,44 +38344,20 @@ var ENTITY_TYPE_LABELS = {
   LEGAL_UNIT: "Entit\xE9 juridique",
   OFFICE: "\xC9tablissement"
 };
-function formatDirectoryFrRow(row) {
-  const ci = row.countryIdentifier ?? {};
-  const siren = ci.siren ?? row.siren;
-  const siret = ci.siret ?? row.siret;
-  const country = ci.country ?? row.country ?? "FR";
-  return {
-    _id: row.businessEntityId,
-    _identifiers: row.identifiers,
-    "Nom": row.name ?? "\u2014",
-    "Type": ENTITY_TYPE_LABELS[row.type] ?? row.type ?? "\u2014",
-    "SIREN": siren ?? "\u2014",
-    "SIRET": siret ?? "\u2014",
-    "Pays": country
-  };
-}
-function autoWrapDirectoryQuery(q) {
-  const trimmed = q.trim();
-  if (/^\d{14}$/.test(trimmed)) return `siret:"${trimmed}"`;
-  if (/^\d{9}$/.test(trimmed)) return `siren:"${trimmed}"`;
-  if (/^FR\d{11}$/i.test(trimmed)) return `vatNumber:"${trimmed.toUpperCase()}"`;
-  if (trimmed.length >= 3 && !/^\d+$/.test(trimmed) && !trimmed.includes(":")) {
-    return `name:"*${trimmed}*"`;
-  }
-  return trimmed;
-}
 var directoryTools = [
   // ── French Directory ────────────────────────────────────
   {
     name: "einvoice_directory_fr_search",
-    _meta: { ui: { resourceUri: "ui://mcp-einvoice/doclist-viewer" } },
-    description: `Search the French PPF directory (Portail Public de Facturation). Find companies registered for e-invoicing in France. Raw SIRET (14 digits), SIREN (9 digits), TVA (FR + 11 digits), or company names are auto-detected and converted to Lucene syntax. You can also pass explicit Lucene syntax (e.g. siret:"43446637100011") if needed. Returns the company's registered platform (PDP) and routing information.`,
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/directory-list" } },
+    requires: ["searchDirectoryFr"],
+    description: "Search the French PPF directory (Portail Public de Facturation). Find companies registered for e-invoicing in France. Search by SIRET (14 digits), SIREN (9 digits), TVA (FR + 11 digits), or company name. Format is auto-detected. Returns the company's registered platform (PDP) and routing information.",
     category: "directory",
     inputSchema: {
       type: "object",
       properties: {
         q: {
           type: "string",
-          description: 'Search query (required). Can be a raw SIRET, SIREN, VAT number, or company name \u2014 auto-converted to Lucene syntax. You can also pass explicit Lucene syntax (e.g. siret:"43446637100011").'
+          description: "Search query (required). SIRET, SIREN, VAT number, or company name."
         },
         offset: { type: "number", description: "Result offset (default 0)" },
         limit: { type: "number", description: "Max results (default 50, max 200)" }
@@ -38242,24 +38368,47 @@ var directoryTools = [
       if (!input.q) {
         throw new Error("[einvoice_directory_fr_search] 'q' query is required");
       }
-      const result = await ctx.adapter.searchDirectoryFr({
-        q: autoWrapDirectoryQuery(input.q),
+      const { rows, count } = await ctx.adapter.searchDirectoryFr({
+        q: input.q,
         offset: input.offset,
         limit: input.limit
       });
-      const meta3 = result.meta;
-      if (meta3?.count != null && result.count == null) result.count = meta3.count;
-      const data = result.data;
-      if (Array.isArray(data)) {
-        result.data = data.map(formatDirectoryFrRow);
-      }
-      return result;
+      const viewerData = {
+        data: rows.map((r) => {
+          const typeLabel = r.type ? ENTITY_TYPE_LABELS[r.type] ?? r.type : void 0;
+          return {
+            _id: r.entityId,
+            _detail: {
+              name: r.name,
+              type: typeLabel,
+              siren: r.siren,
+              siret: r.siret,
+              country: r.country,
+              directory: r.directory,
+              status: r.status,
+              createdAt: r.createdAt,
+              identifiers: r.identifiers
+            },
+            "Nom": r.name ?? "\u2014",
+            "Type": typeLabel ?? "\u2014",
+            "SIRET": r.siret ?? "\u2014",
+            "Pays": r.country ?? "\u2014"
+          };
+        }),
+        count,
+        _title: "Annuaire fran\xE7ais"
+      };
+      return {
+        content: `${rows.length} entities found for "${input.q}"`,
+        structuredContent: viewerData
+      };
     }
   },
   // ── International Directory ─────────────────────────────
   {
     name: "einvoice_directory_int_search",
-    _meta: { ui: { resourceUri: "ui://mcp-einvoice/doclist-viewer" } },
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/directory-list" } },
+    requires: ["searchDirectoryInt"],
     description: "Search the international Peppol directory. Find companies registered on the Peppol network across 40+ countries. Search by participant identifier value (e.g. VAT number, GLN, DUNS).",
     category: "directory",
     inputSchema: {
@@ -38288,6 +38437,7 @@ var directoryTools = [
   // ── Check Peppol Participant ────────────────────────────
   {
     name: "einvoice_directory_peppol_check",
+    requires: ["checkPeppolParticipant"],
     description: "Verify whether a specific Peppol participant exists in the international directory. Checks by scheme and identifier value.",
     category: "directory",
     inputSchema: {
@@ -38323,7 +38473,9 @@ var statusTools = [
   // ── Send Status ─────────────────────────────────────────
   {
     name: "einvoice_status_send",
-    description: "Send a lifecycle status update for an invoice. Uses Iopole status codes: IN_HAND, APPROVED, PARTIALLY_APPROVED, DISPUTED, SUSPENDED, COMPLETED, REFUSED, PAYMENT_SENT, PAYMENT_RECEIVED. Asynchronous \u2014 returns a GUID to track the request.",
+    annotations: { destructiveHint: true },
+    requires: ["sendStatus"],
+    description: "Send a lifecycle status update for an invoice. Uses CDAR lifecycle codes: IN_HAND (204), APPROVED (205), REFUSED (210), DISPUTED (207), SUSPENDED (208), PAYMENT_SENT (211), PAYMENT_RECEIVED (212). Asynchronous \u2014 returns a confirmation.",
     category: "status",
     inputSchema: {
       type: "object",
@@ -38375,7 +38527,9 @@ var statusTools = [
   // ── Get Status History ────────────────────────────────────
   {
     name: "einvoice_status_history",
+    annotations: { readOnlyHint: true },
     _meta: { ui: { resourceUri: "ui://mcp-einvoice/status-timeline" } },
+    requires: ["getStatusHistory"],
     description: "Get the status history for an invoice. Returns all status changes in chronological order.",
     category: "status",
     inputSchema: {
@@ -38389,64 +38543,14 @@ var statusTools = [
       if (!input.invoice_id) {
         throw new Error("[einvoice_status_history] 'invoice_id' is required");
       }
-      const raw2 = await ctx.adapter.getStatusHistory(input.invoice_id);
-      if (Array.isArray(raw2)) return { entries: raw2 };
-      if (raw2 && typeof raw2 === "object") {
-        const obj = raw2;
-        if (Array.isArray(obj.data)) return { entries: obj.data };
-        if (Array.isArray(obj.entries)) return raw2;
-        if (Array.isArray(obj.history)) return { entries: obj.history };
-      }
-      return { entries: [] };
-    }
-  },
-  // ── Not Seen ────────────────────────────────────────────
-  {
-    name: "einvoice_status_not_seen",
-    _meta: { ui: { resourceUri: "ui://mcp-einvoice/doclist-viewer" } },
-    description: "Get status updates that have not been marked as seen. Useful for polling new incoming status changes on invoices.",
-    category: "status",
-    inputSchema: {
-      type: "object",
-      properties: {
-        offset: { type: "number", description: "Result offset (default 0)" },
-        limit: { type: "number", description: "Max results (default 50)" }
-      }
-    },
-    handler: async (input, ctx) => {
-      const result = await ctx.adapter.getUnseenStatuses({
-        offset: input.offset,
-        limit: input.limit
-      });
+      const result = await ctx.adapter.getStatusHistory(input.invoice_id);
       return {
-        ...result,
-        _rowAction: {
-          toolName: "einvoice_status_history",
-          idField: "invoiceId",
-          argName: "invoice_id"
-        }
+        content: `${result.entries.length} status entries for invoice ${input.invoice_id}`,
+        structuredContent: result
       };
     }
-  },
-  // ── Mark as Seen ────────────────────────────────────────
-  {
-    name: "einvoice_status_mark_seen",
-    description: "Mark a status update as seen/processed.",
-    category: "status",
-    inputSchema: {
-      type: "object",
-      properties: {
-        status_id: { type: "string", description: "Status ID" }
-      },
-      required: ["status_id"]
-    },
-    handler: async (input, ctx) => {
-      if (!input.status_id) {
-        throw new Error("[einvoice_status_mark_seen] 'status_id' is required");
-      }
-      return await ctx.adapter.markStatusSeen(input.status_id);
-    }
   }
+  // ── seen/notSeen tools removed — see invoice.ts comment and docs/CHANGELOG.md
 ];
 
 // src/tools/reporting.ts
@@ -38454,6 +38558,7 @@ var reportingTools = [
   // ── Invoice Transaction Reporting ───────────────────────
   {
     name: "einvoice_reporting_invoice_transaction",
+    requires: ["reportInvoiceTransaction"],
     description: "Report an invoice transaction to the French tax authority (e-reporting). Required for B2C and international invoice transactions. Asynchronous \u2014 returns a GUID.",
     category: "reporting",
     inputSchema: {
@@ -38461,7 +38566,7 @@ var reportingTools = [
       properties: {
         transaction: {
           type: "object",
-          description: "Invoice transaction data for DGFiP e-reporting. Typical fields: invoiceReference (string): the invoice number; transactionDate (string, YYYY-MM-DD): date of the transaction; transactionType (string): e.g. 'B2C', 'INTERNATIONAL'; totalAmount (number): total TTC amount; taxDetails (array): [{ vatRate: number, taxableAmount: number, taxAmount: number }]; counterparty (object): { name, country, identifier }; currency (string, default 'EUR'). Exact schema depends on the PA provider \u2014 check Iopole docs for the full specification."
+          description: "Invoice transaction data for DGFiP e-reporting. Typical fields: invoiceReference (string): the invoice number; transactionDate (string, YYYY-MM-DD): date of the transaction; transactionType (string): e.g. 'B2C', 'INTERNATIONAL'; totalAmount (number): total TTC amount; taxDetails (array): [{ vatRate: number, taxableAmount: number, taxAmount: number }]; counterparty (object): { name, country, identifier }; currency (string, default 'EUR'). Exact schema depends on the PA provider."
         }
       },
       required: ["transaction"]
@@ -38480,6 +38585,7 @@ var reportingTools = [
   // ── Non-Invoice Transaction Reporting ───────────────────
   {
     name: "einvoice_reporting_transaction",
+    requires: ["reportTransaction"],
     description: "Report a non-invoice transaction to the French tax authority (e-reporting). Covers payment data, B2C cash transactions, etc. Requires the business entity ID. Asynchronous \u2014 returns a GUID.",
     category: "reporting",
     inputSchema: {
@@ -38491,7 +38597,7 @@ var reportingTools = [
         },
         transaction: {
           type: "object",
-          description: "Non-invoice transaction data for DGFiP e-reporting. Typical fields: transactionDate (string, YYYY-MM-DD); transactionType (string): e.g. 'CASH_PAYMENT', 'PAYMENT_DATA'; totalAmount (number): total TTC amount; taxDetails (array): [{ vatRate: number, taxableAmount: number, taxAmount: number }]; periodicity (string): 'MONTHLY' or 'QUARTERLY'; currency (string, default 'EUR'). Exact schema depends on the PA provider \u2014 check Iopole docs for the full specification."
+          description: "Non-invoice transaction data for DGFiP e-reporting. Typical fields: transactionDate (string, YYYY-MM-DD); transactionType (string): e.g. 'CASH_PAYMENT', 'PAYMENT_DATA'; totalAmount (number): total TTC amount; taxDetails (array): [{ vatRate: number, taxableAmount: number, taxAmount: number }]; periodicity (string): 'MONTHLY' or 'QUARTERLY'; currency (string, default 'EUR'). Exact schema depends on the PA provider."
         }
       },
       required: ["business_entity_id", "transaction"]
@@ -38518,6 +38624,7 @@ var webhookTools = [
     _meta: { ui: { resourceUri: "ui://mcp-einvoice/doclist-viewer" } },
     description: "List all configured webhooks for your account.",
     category: "webhook",
+    requires: ["listWebhooks"],
     inputSchema: {
       type: "object",
       properties: {}
@@ -38531,6 +38638,7 @@ var webhookTools = [
     name: "einvoice_webhook_get",
     description: "Get a single webhook configuration by its ID.",
     category: "webhook",
+    requires: ["getWebhook"],
     inputSchema: {
       type: "object",
       properties: {
@@ -38548,6 +38656,7 @@ var webhookTools = [
   // ── Create ──────────────────────────────────────────────
   {
     name: "einvoice_webhook_create",
+    requires: ["createWebhook"],
     description: "Create a new webhook to receive real-time notifications. Specify the target URL and which events to subscribe to (e.g. invoice.received, status.changed).",
     category: "webhook",
     inputSchema: {
@@ -38592,6 +38701,7 @@ var webhookTools = [
     name: "einvoice_webhook_update",
     description: "Update an existing webhook configuration.",
     category: "webhook",
+    requires: ["updateWebhook"],
     inputSchema: {
       type: "object",
       properties: {
@@ -38624,6 +38734,7 @@ var webhookTools = [
     name: "einvoice_webhook_delete",
     description: "Delete a webhook configuration.",
     category: "webhook",
+    requires: ["deleteWebhook"],
     inputSchema: {
       type: "object",
       properties: {
@@ -38640,27 +38751,490 @@ var webhookTools = [
   }
 ];
 
-// src/tools/mod.ts
-var toolsByCategory = {
-  invoice: invoiceTools,
-  directory: directoryTools,
-  status: statusTools,
-  reporting: reportingTools,
-  webhook: webhookTools
+// src/tools/config.ts
+var ENTITY_TYPE_LABELS2 = {
+  LEGAL_UNIT: "Entit\xE9 juridique",
+  OFFICE: "\xC9tablissement"
 };
-var allTools = [
-  ...invoiceTools,
-  ...directoryTools,
-  ...statusTools,
-  ...reportingTools,
-  ...webhookTools
-];
-function getToolsByCategory(category) {
-  return toolsByCategory[category] ?? [];
-}
-
-// src/client.ts
-var EInvoiceToolsClient = class {
+var configTools = [
+  // ── Customer ID ──────────────────────────────────────
+  {
+    name: "einvoice_config_customer_id",
+    requires: ["getCustomerId"],
+    description: "Get the current operator customer ID. This is your unique operator identifier on the e-invoicing platform.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    },
+    handler: async (_input, ctx) => {
+      return await ctx.adapter.getCustomerId();
+    }
+  },
+  // ── List Business Entities ───────────────────────────
+  {
+    name: "einvoice_config_entities_list",
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/doclist-viewer" } },
+    requires: ["listBusinessEntities"],
+    description: "List all business entities managed by your operator account. Shows which companies/offices are enrolled for e-invoicing under your management. If this list is empty, you need to enroll entities before sending invoices.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    },
+    handler: async (_input, ctx) => {
+      const { rows, count } = await ctx.adapter.listBusinessEntities();
+      return {
+        data: rows.map((r) => ({
+          _id: r.entityId,
+          "Nom": r.name ?? "\u2014",
+          "SIRET": r.siret ?? "\u2014",
+          "Type": ENTITY_TYPE_LABELS2[r.type ?? ""] ?? r.type ?? "\u2014"
+        })),
+        count,
+        _title: "Entit\xE9s op\xE9rateur",
+        _rowAction: {
+          toolName: "einvoice_config_entity_get",
+          idField: "_id",
+          argName: "id"
+        }
+      };
+    }
+  },
+  // ── Get Business Entity ──────────────────────────────
+  {
+    name: "einvoice_config_entity_get",
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/directory-card" } },
+    requires: ["getBusinessEntity"],
+    description: "Get details of a specific business entity managed by your operator. Shows registration info, identifiers, and enrollment status.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Business entity ID" }
+      },
+      required: ["id"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.id) {
+        throw new Error("[einvoice_config_entity_get] 'id' is required");
+      }
+      return await ctx.adapter.getBusinessEntity(input.id);
+    }
+  },
+  // ── Create Legal Unit ────────────────────────────────
+  {
+    name: "einvoice_config_entity_create_legal",
+    requires: ["createLegalUnit"],
+    description: "Create a new legal unit (company) under your operator account. A legal unit represents a legally registered entity with a unique SIREN. After creating the legal unit, create an office (establishment) with a SIRET, then enroll it for e-invoicing.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siren: {
+          type: "string",
+          description: "SIREN number (9 digits) of the company to register"
+        },
+        name: {
+          type: "string",
+          description: "Company name"
+        },
+        country: {
+          type: "string",
+          description: "Country code (default: FR)"
+        },
+        scope: {
+          type: "string",
+          description: "Entity scope",
+          enum: ["PRIVATE_TAX_PAYER", "PUBLIC", "PRIMARY", "SECONDARY"]
+        }
+      },
+      required: ["siren"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.siren) {
+        throw new Error("[einvoice_config_entity_create_legal] 'siren' is required");
+      }
+      return await ctx.adapter.createLegalUnit({
+        identifierScheme: "0002",
+        identifierValue: input.siren,
+        name: input.name,
+        country: input.country ?? "FR",
+        scope: input.scope ?? "PRIMARY"
+      });
+    }
+  },
+  // ── Create Office ────────────────────────────────────
+  {
+    name: "einvoice_config_entity_create_office",
+    requires: ["createOffice"],
+    description: "Create a new office (establishment) for an existing legal unit. An office represents a physical location with a unique SIRET. The legal unit must exist first (use einvoice_config_entity_create_legal). After creating, enroll the office with einvoice_config_enroll_fr.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siret: {
+          type: "string",
+          description: "SIRET number (14 digits) of the establishment"
+        },
+        legalUnitId: {
+          type: "string",
+          description: "Business entity ID of the parent legal unit"
+        },
+        name: {
+          type: "string",
+          description: "Office name"
+        },
+        scope: {
+          type: "string",
+          description: "Entity scope",
+          enum: ["PRIVATE_TAX_PAYER", "PUBLIC", "PRIMARY", "SECONDARY"]
+        }
+      },
+      required: ["siret", "legalUnitId"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.siret || !input.legalUnitId) {
+        throw new Error("[einvoice_config_entity_create_office] 'siret' and 'legalUnitId' are required");
+      }
+      return await ctx.adapter.createOffice({
+        identifierScheme: "0009",
+        identifierValue: input.siret,
+        legalBusinessEntityId: input.legalUnitId,
+        name: input.name,
+        scope: input.scope ?? "PRIMARY"
+      });
+    }
+  },
+  // ── Enroll French Entity ─────────────────────────────
+  {
+    name: "einvoice_config_enroll_fr",
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/action-result" } },
+    requires: ["enrollFrench"],
+    description: "Enroll a French business entity for e-invoicing on the PPF (Portail Public de Facturation). REQUIRED before an entity can send or receive invoices. If invoice emission returns WRONG_ROUTING, the sender entity needs enrollment. Provide the SIRET of the entity to enroll. The entity must first exist under your operator (use einvoice_config_entities_list to check).",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siret: {
+          type: "string",
+          description: "SIRET (14 digits) of the entity to enroll"
+        },
+        siren: {
+          type: "string",
+          description: "SIREN (9 digits, first 9 digits of SIRET). If omitted, extracted from SIRET automatically."
+        }
+      },
+      required: ["siret"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.siret) {
+        throw new Error("[einvoice_config_enroll_fr] 'siret' is required");
+      }
+      const siret = input.siret;
+      const siren = input.siren ?? siret.slice(0, 9);
+      return await ctx.adapter.enrollFrench({ siret, siren });
+    }
+  },
+  // ── Claim Business Entity ────────────────────────────
+  {
+    name: "einvoice_config_entity_claim",
+    requires: ["claimBusinessEntityByIdentifier"],
+    description: "Claim management of a business entity by its identifier (SIRET scheme 0009). Use this to take over management of an entity that exists in the directory but is not yet under your operator account.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        scheme: {
+          type: "string",
+          description: "Identifier scheme (e.g. '0009' for SIRET)"
+        },
+        value: {
+          type: "string",
+          description: "Identifier value (e.g. SIRET number)"
+        }
+      },
+      required: ["scheme", "value"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.scheme || !input.value) {
+        throw new Error("[einvoice_config_entity_claim] 'scheme' and 'value' are required");
+      }
+      return await ctx.adapter.claimBusinessEntityByIdentifier(
+        input.scheme,
+        input.value,
+        {}
+      );
+    }
+  },
+  // ── Delete Business Entity ───────────────────────────
+  {
+    name: "einvoice_config_entity_delete",
+    requires: ["deleteBusinessEntity"],
+    description: "Remove a business entity from your operator account. This does not delete the entity from the national directory, only removes it from your management.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: { type: "string", description: "Business entity ID to remove" }
+      },
+      required: ["id"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.id) {
+        throw new Error("[einvoice_config_entity_delete] 'id' is required");
+      }
+      return await ctx.adapter.deleteBusinessEntity(input.id);
+    }
+  },
+  // ── Register on Network ──────────────────────────────
+  {
+    name: "einvoice_config_network_register",
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/action-result" } },
+    requires: ["registerNetwork"],
+    description: "Register a business entity identifier on an e-invoicing network (DOMESTIC_FR or PEPPOL_INTERNATIONAL). REQUIRED for invoice routing. An entity can be enrolled but still get WRONG_ROUTING if its identifier is not registered on the target network. Use einvoice_config_entities_list to find the identifier ID, then register it here.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        identifier_id: {
+          type: "string",
+          description: "Business entity identifier ID (UUID, from the identifiers array in entity details)"
+        },
+        network: {
+          type: "string",
+          description: "Network to register on: DOMESTIC_FR (French PPF) or PEPPOL_INTERNATIONAL",
+          enum: ["DOMESTIC_FR", "PEPPOL_INTERNATIONAL"]
+        }
+      },
+      required: ["identifier_id", "network"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.identifier_id || !input.network) {
+        throw new Error("[einvoice_config_network_register] 'identifier_id' and 'network' are required");
+      }
+      return await ctx.adapter.registerNetwork(
+        input.identifier_id,
+        input.network
+      );
+    }
+  },
+  // ── Register on Network by Scheme/Value ──────────────
+  {
+    name: "einvoice_config_network_register_by_id",
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/action-result" } },
+    requires: ["registerNetworkByScheme"],
+    description: "Register an entity on an e-invoicing network using its identifier scheme and value directly. Shortcut when you know the SIRET but not the identifier UUID. Example: scheme='0009', value='43446637100011', network='DOMESTIC_FR'. Use scheme 0009 for SIRET, 0002 for SIREN.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        scheme: {
+          type: "string",
+          description: "Identifier scheme: '0009' for SIRET, '0002' for SIREN, '0225' for SIREN_SIRET"
+        },
+        value: {
+          type: "string",
+          description: "Identifier value (e.g. SIRET number)"
+        },
+        network: {
+          type: "string",
+          description: "Network: DOMESTIC_FR or PEPPOL_INTERNATIONAL",
+          enum: ["DOMESTIC_FR", "PEPPOL_INTERNATIONAL"]
+        }
+      },
+      required: ["scheme", "value", "network"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.scheme || !input.value || !input.network) {
+        throw new Error("[einvoice_config_network_register_by_id] 'scheme', 'value', and 'network' are required");
+      }
+      return await ctx.adapter.registerNetworkByScheme(
+        input.scheme,
+        input.value,
+        input.network
+      );
+    }
+  },
+  // ── Create Identifier ────────────────────────────────
+  {
+    name: "einvoice_config_identifier_create",
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/action-result" } },
+    requires: ["createIdentifier"],
+    description: "Add a new identifier to a business entity. Identifiers are how entities are found in the directory and how invoices are routed. Common schemes: '0009' (SIRET), '0002' (SIREN), '0225' (SIREN_SIRET). After creating, register the identifier on a network (DOMESTIC_FR) for invoice routing.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        entity_id: { type: "string", description: "Business entity ID to add the identifier to" },
+        scheme: {
+          type: "string",
+          description: "Identifier scheme: '0009' (SIRET), '0002' (SIREN), '0225' (SIREN_SIRET)"
+        },
+        value: { type: "string", description: "Identifier value (e.g. SIRET number)" },
+        type: {
+          type: "string",
+          description: "Identifier type",
+          enum: ["ROUTING_CODE", "SUFFIX"]
+        }
+      },
+      required: ["entity_id", "scheme", "value", "type"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.entity_id || !input.scheme || !input.value || !input.type) {
+        throw new Error("[einvoice_config_identifier_create] 'entity_id', 'scheme', 'value', and 'type' are required");
+      }
+      return await ctx.adapter.createIdentifier(input.entity_id, {
+        scheme: input.scheme,
+        value: input.value,
+        type: input.type
+      });
+    }
+  },
+  // ── Create Identifier by Scheme/Value ──────────────────
+  {
+    name: "einvoice_config_identifier_create_by_scheme",
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/action-result" } },
+    requires: ["createIdentifierByScheme"],
+    description: "Add a new identifier to a business entity, looking up the entity by an existing identifier. Shortcut when you know a SIRET/SIREN but not the entity UUID.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        lookup_scheme: { type: "string", description: "Scheme to find the entity (e.g. '0009' for SIRET)" },
+        lookup_value: { type: "string", description: "Value to find the entity (e.g. SIRET number)" },
+        new_scheme: { type: "string", description: "Scheme of the new identifier to add" },
+        new_value: { type: "string", description: "Value of the new identifier to add" }
+      },
+      required: ["lookup_scheme", "lookup_value", "new_scheme", "new_value"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.lookup_scheme || !input.lookup_value || !input.new_scheme || !input.new_value) {
+        throw new Error("[einvoice_config_identifier_create_by_scheme] all fields are required");
+      }
+      return await ctx.adapter.createIdentifierByScheme(
+        input.lookup_scheme,
+        input.lookup_value,
+        { scheme: input.new_scheme, value: input.new_value }
+      );
+    }
+  },
+  // ── Delete Identifier ──────────────────────────────────
+  {
+    name: "einvoice_config_identifier_delete",
+    requires: ["deleteIdentifier"],
+    description: "Remove an identifier from a business entity. WARNING: if the identifier is registered on a network, unregister it first. Use the identifier UUID from the entity's identifiers array (einvoice_config_entity_get).",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        identifier_id: { type: "string", description: "Identifier UUID to delete" }
+      },
+      required: ["identifier_id"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.identifier_id) {
+        throw new Error("[einvoice_config_identifier_delete] 'identifier_id' is required");
+      }
+      return await ctx.adapter.deleteIdentifier(input.identifier_id);
+    }
+  },
+  // ── Configure Business Entity ──────────────────────────
+  {
+    name: "einvoice_config_entity_configure",
+    _meta: { ui: { resourceUri: "ui://mcp-einvoice/action-result" } },
+    requires: ["configureBusinessEntity"],
+    description: "Configure a business entity's settings (e.g. VAT regime). Use einvoice_config_entity_get to see current configuration first.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        entity_id: { type: "string", description: "Business entity ID" },
+        vat_regime: {
+          type: "string",
+          description: "VAT regime: REAL_MONTHLY_TAX_REGIME, REAL_QUARTERLY_TAX_REGIME, SIMPLIFIED_TAX_REGIME, or VAT_EXEMPTION_REGIME",
+          enum: ["REAL_MONTHLY_TAX_REGIME", "REAL_QUARTERLY_TAX_REGIME", "SIMPLIFIED_TAX_REGIME", "VAT_EXEMPTION_REGIME"]
+        }
+      },
+      required: ["entity_id"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.entity_id) {
+        throw new Error("[einvoice_config_entity_configure] 'entity_id' is required");
+      }
+      const config2 = {};
+      if (input.vat_regime) config2.vatRegime = input.vat_regime;
+      return await ctx.adapter.configureBusinessEntity(input.entity_id, config2);
+    }
+  },
+  // ── Delete Claim ───────────────────────────────────────
+  {
+    name: "einvoice_config_claim_delete",
+    requires: ["deleteClaim"],
+    description: "Remove your operator's claim on a business entity. The entity remains in the national directory but is no longer managed by your operator. WARNING: after removing the claim, you lose management of this entity. Use einvoice_config_entity_claim to reclaim it later if needed.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        entity_id: { type: "string", description: "Business entity ID to unclaim" }
+      },
+      required: ["entity_id"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.entity_id) {
+        throw new Error("[einvoice_config_claim_delete] 'entity_id' is required");
+      }
+      return await ctx.adapter.deleteClaim(input.entity_id);
+    }
+  },
+  // ── Unregister from Network ──────────────────────────
+  {
+    name: "einvoice_config_network_unregister",
+    requires: ["unregisterNetwork"],
+    description: "Unregister an entity from a network. Removes the directory entry. After unregistration, the entity will no longer receive invoices on that network. Use the directoryId from the entity's networksRegistered array.",
+    category: "config",
+    inputSchema: {
+      type: "object",
+      properties: {
+        directory_id: {
+          type: "string",
+          description: "Directory entry ID (UUID from the networksRegistered array in entity identifiers)"
+        }
+      },
+      required: ["directory_id"]
+    },
+    handler: async (input, ctx) => {
+      if (!input.directory_id) {
+        throw new Error("[einvoice_config_network_unregister] 'directory_id' is required");
+      }
+      return await ctx.adapter.unregisterNetwork(input.directory_id);
+    }
+  }
+];
+
+// src/tools/mod.ts
+var toolsByCategory = {
+  invoice: invoiceTools,
+  directory: directoryTools,
+  status: statusTools,
+  reporting: reportingTools,
+  webhook: webhookTools,
+  config: configTools
+};
+var allTools = [
+  ...invoiceTools,
+  ...directoryTools,
+  ...statusTools,
+  ...reportingTools,
+  ...webhookTools,
+  ...configTools
+];
+function getToolsByCategory(category) {
+  return toolsByCategory[category] ?? [];
+}
+
+// src/client.ts
+var EInvoiceToolsClient = class {
   tools;
   constructor(options) {
     if (options?.categories) {
@@ -38673,25 +39247,33 @@ var EInvoiceToolsClient = class {
   listTools() {
     return this.tools;
   }
-  /** Convert tools to MCP wire format (for server registration) */
-  toMCPFormat() {
-    return this.tools.map((t) => {
+  /** Filter tools to only those supported by the given adapter's capabilities. */
+  supportedTools(adapter) {
+    return this.tools.filter(
+      (t) => !t.requires || t.requires.every((m) => adapter.capabilities.has(m))
+    );
+  }
+  /** Convert tools to MCP wire format, filtered by adapter capabilities. */
+  toMCPFormat(adapter) {
+    return this.supportedTools(adapter).map((t) => {
       const wire = {
         name: t.name,
         description: t.description,
         inputSchema: t.inputSchema
       };
       if (t._meta) wire._meta = t._meta;
+      if (t.annotations) wire.annotations = t.annotations;
       return wire;
     });
   }
   /**
    * Build a handlers Map for ConcurrentMCPServer.registerTools().
    * Each handler wraps the tool to inject the adapter context.
+   * Only includes tools supported by the adapter's capabilities.
    */
   buildHandlersMap(adapter) {
     const handlers = /* @__PURE__ */ new Map();
-    for (const tool of this.tools) {
+    for (const tool of this.supportedTools(adapter)) {
       handlers.set(tool.name, async (args) => {
         return await tool.handler(args, { adapter });
       });
@@ -38714,9 +39296,159 @@ var EInvoiceToolsClient = class {
   }
 };
 
-// src/api/iopole-client.ts
-function createOAuth2TokenProvider(config2) {
-  let cachedToken;
+// src/adapters/base-adapter.ts
+var BaseAdapter = class {
+  notSupported(method, reason = "Not implemented by this adapter.") {
+    return Promise.reject(new NotSupportedError(this.name, method, reason));
+  }
+  // ─── Invoice ───────────────────────────────────────────
+  emitInvoice(_req) {
+    return this.notSupported("emitInvoice");
+  }
+  searchInvoices(_filters) {
+    return this.notSupported("searchInvoices");
+  }
+  getInvoice(_id) {
+    return this.notSupported("getInvoice");
+  }
+  downloadInvoice(_id) {
+    return this.notSupported("downloadInvoice");
+  }
+  downloadReadable(_id) {
+    return this.notSupported("downloadReadable");
+  }
+  getInvoiceFiles(_id) {
+    return this.notSupported("getInvoiceFiles");
+  }
+  getAttachments(_id) {
+    return this.notSupported("getAttachments");
+  }
+  downloadFile(_fileId) {
+    return this.notSupported("downloadFile");
+  }
+  markInvoiceSeen(_id) {
+    return this.notSupported("markInvoiceSeen");
+  }
+  getUnseenInvoices(_pagination) {
+    return this.notSupported("getUnseenInvoices");
+  }
+  generateCII(_req) {
+    return this.notSupported("generateCII");
+  }
+  generateUBL(_req) {
+    return this.notSupported("generateUBL");
+  }
+  generateFacturX(_req) {
+    return this.notSupported("generateFacturX");
+  }
+  // ─── Directory ────────────────────────────────────────
+  searchDirectoryFr(_filters) {
+    return this.notSupported("searchDirectoryFr");
+  }
+  searchDirectoryInt(_filters) {
+    return this.notSupported("searchDirectoryInt");
+  }
+  checkPeppolParticipant(_scheme, _value) {
+    return this.notSupported("checkPeppolParticipant");
+  }
+  // ─── Status ────────────────────────────────────────────
+  sendStatus(_req) {
+    return this.notSupported("sendStatus");
+  }
+  getStatusHistory(_invoiceId) {
+    return this.notSupported("getStatusHistory");
+  }
+  getUnseenStatuses(_pagination) {
+    return this.notSupported("getUnseenStatuses");
+  }
+  markStatusSeen(_statusId) {
+    return this.notSupported("markStatusSeen");
+  }
+  // ─── Reporting ─────────────────────────────────────────
+  reportInvoiceTransaction(_transaction) {
+    return this.notSupported("reportInvoiceTransaction");
+  }
+  reportTransaction(_businessEntityId, _transaction) {
+    return this.notSupported("reportTransaction");
+  }
+  // ─── Webhooks ──────────────────────────────────────────
+  listWebhooks() {
+    return this.notSupported("listWebhooks");
+  }
+  getWebhook(_id) {
+    return this.notSupported("getWebhook");
+  }
+  createWebhook(_req) {
+    return this.notSupported("createWebhook");
+  }
+  updateWebhook(_id, _req) {
+    return this.notSupported("updateWebhook");
+  }
+  deleteWebhook(_id) {
+    return this.notSupported("deleteWebhook");
+  }
+  // ─── Operator Config ───────────────────────────────────
+  getCustomerId() {
+    return this.notSupported("getCustomerId");
+  }
+  listBusinessEntities() {
+    return this.notSupported("listBusinessEntities");
+  }
+  getBusinessEntity(_id) {
+    return this.notSupported("getBusinessEntity");
+  }
+  createLegalUnit(_data) {
+    return this.notSupported("createLegalUnit");
+  }
+  createOffice(_data) {
+    return this.notSupported("createOffice");
+  }
+  deleteBusinessEntity(_id) {
+    return this.notSupported("deleteBusinessEntity");
+  }
+  configureBusinessEntity(_id, _data) {
+    return this.notSupported("configureBusinessEntity");
+  }
+  claimBusinessEntity(_id, _data) {
+    return this.notSupported("claimBusinessEntity");
+  }
+  claimBusinessEntityByIdentifier(_scheme, _value, _data) {
+    return this.notSupported("claimBusinessEntityByIdentifier");
+  }
+  enrollFrench(_data) {
+    return this.notSupported("enrollFrench");
+  }
+  enrollInternational(_data) {
+    return this.notSupported("enrollInternational");
+  }
+  registerNetwork(_identifierId, _network) {
+    return this.notSupported("registerNetwork");
+  }
+  registerNetworkByScheme(_scheme, _value, _network) {
+    return this.notSupported("registerNetworkByScheme");
+  }
+  unregisterNetwork(_directoryId) {
+    return this.notSupported("unregisterNetwork");
+  }
+  // ─── Identifier Management ─────────────────────────────
+  createIdentifier(_entityId, _data) {
+    return this.notSupported("createIdentifier");
+  }
+  createIdentifierByScheme(_scheme, _value, _data) {
+    return this.notSupported("createIdentifierByScheme");
+  }
+  deleteIdentifier(_identifierId) {
+    return this.notSupported("deleteIdentifier");
+  }
+  // ─── Claim Management ──────────────────────────────────
+  deleteClaim(_entityId) {
+    return this.notSupported("deleteClaim");
+  }
+};
+
+// src/adapters/shared/oauth2.ts
+function createOAuth2TokenProvider(config2) {
+  let cachedToken;
   let expiresAt = 0;
   let inflight;
   const REFRESH_MARGIN_MS = 6e4;
@@ -38729,19 +39461,18 @@ function createOAuth2TokenProvider(config2) {
     const response = await fetch(config2.authUrl, {
       method: "POST",
       headers: { "Content-Type": "application/x-www-form-urlencoded" },
-      body: body.toString()
+      body: body.toString(),
+      signal: AbortSignal.timeout(15e3)
     });
     if (!response.ok) {
       const text = await response.text();
       throw new Error(
-        `[IopoleOAuth2] Token request failed: ${response.status} \u2014 ${text.slice(0, 500)}`
+        `[OAuth2] Token request failed: ${response.status} \u2014 ${text.slice(0, 500)}`
       );
     }
     const data = await response.json();
     if (!data.access_token) {
-      throw new Error(
-        "[IopoleOAuth2] Token response missing access_token"
-      );
+      throw new Error("[OAuth2] Token response missing access_token");
     }
     cachedToken = data.access_token;
     expiresAt = Date.now() + (data.expires_in ?? 600) * 1e3 - REFRESH_MARGIN_MS;
@@ -38759,6 +39490,8 @@ function createOAuth2TokenProvider(config2) {
     return inflight;
   };
 }
+
+// src/adapters/iopole/client.ts
 var IopoleAPIError = class extends Error {
   constructor(message2, status, body) {
     super(message2);
@@ -38774,7 +39507,10 @@ var IopoleClient = class {
   }
   // ─── Generic Request ────────────────────────────────────
   async request(method, path, options) {
-    const url2 = new URL(`${this.config.baseUrl}${path}`);
+    return this.requestWithBase(this.config.baseUrl, method, path, options);
+  }
+  async requestWithBase(baseUrl, method, path, options) {
+    const url2 = new URL(`${baseUrl}${path}`);
     if (options?.query) {
       for (const [key, value] of Object.entries(options.query)) {
         if (value !== void 0) {
@@ -38821,41 +39557,1330 @@ var IopoleClient = class {
       clearTimeout(timeout);
     }
   }
-  // ─── Convenience Methods ────────────────────────────────
-  async get(path, query) {
-    return this.request("GET", path, { query });
+  // ─── Convenience Methods ────────────────────────────────
+  async get(path, query) {
+    return this.request("GET", path, { query });
+  }
+  /**
+   * GET request against the v1.1 API endpoint.
+   * Builds a v1.1 URL without mutating this.config.baseUrl,
+   * so concurrent calls (e.g. getV11 + get) cannot interfere.
+   */
+  async getV11(path, query) {
+    const baseV11 = this.config.baseUrl.replace(/\/v1\b/, "/v1.1");
+    return this.requestWithBase(baseV11, "GET", path, { query });
+  }
+  async post(path, body) {
+    return this.request("POST", path, { body });
+  }
+  async put(path, body) {
+    return this.request("PUT", path, { body });
+  }
+  async delete(path) {
+    return this.request("DELETE", path);
+  }
+  /**
+   * Upload a file via multipart/form-data.
+   * Used for POST /invoice (emitInvoice) — the Swagger spec requires
+   * Content-Type: multipart/form-data with a `file` field (binary, PDF or XML).
+   */
+  async upload(path, file2, filename) {
+    const url2 = `${this.config.baseUrl}${path}`;
+    const token = await this.config.getToken();
+    const controller = new AbortController();
+    const timeout = setTimeout(
+      () => controller.abort(),
+      this.config.timeoutMs ?? 3e4
+    );
+    try {
+      const form = new FormData();
+      form.append("file", new Blob([file2]), filename);
+      const response = await fetch(url2, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "customer-id": this.config.customerId,
+          Accept: "application/json"
+          // Do NOT set Content-Type — fetch sets it with the multipart boundary
+        },
+        body: form,
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const body = await response.text();
+        throw new IopoleAPIError(
+          `[IopoleClient] POST ${path} (upload) \u2192 ${response.status}: ${body.slice(0, 500)}`,
+          response.status,
+          body
+        );
+      }
+      const contentType = response.headers.get("content-type") ?? "";
+      if (contentType.includes("application/json")) {
+        return await response.json();
+      }
+      return await response.text();
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  /**
+   * POST with query parameters.
+   * Used for /tools/{cii,ubl}/generate which return text (XML).
+   */
+  async postWithQuery(path, body, query) {
+    return this.request("POST", path, { body, query });
+  }
+  /**
+   * POST with query parameters, returning raw binary.
+   * Used for /tools/facturx/generate which returns a PDF (binary).
+   * Using request() would corrupt binary data by treating it as text.
+   */
+  async postBinary(path, body, query) {
+    const url2 = new URL(`${this.config.baseUrl}${path}`);
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== void 0) url2.searchParams.set(key, String(value));
+    }
+    const token = await this.config.getToken();
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.config.timeoutMs ?? 6e4);
+    try {
+      const response = await fetch(url2.toString(), {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "customer-id": this.config.customerId,
+          "Content-Type": "application/json",
+          Accept: "*/*"
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const errBody = await response.text();
+        throw new IopoleAPIError(`[IopoleClient] POST ${path} \u2192 ${response.status}: ${errBody.slice(0, 500)}`, response.status, errBody);
+      }
+      const data = new Uint8Array(await response.arrayBuffer());
+      const contentType = response.headers.get("content-type") ?? "application/octet-stream";
+      return { data, contentType };
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  /**
+   * Download a binary resource (invoice PDF, attachment, etc.)
+   * Returns the raw Response for streaming.
+   */
+  async download(path) {
+    const url2 = `${this.config.baseUrl}${path}`;
+    const token = await this.config.getToken();
+    const controller = new AbortController();
+    const timeout = setTimeout(
+      () => controller.abort(),
+      this.config.timeoutMs ?? 3e4
+    );
+    try {
+      const response = await fetch(url2, {
+        method: "GET",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "customer-id": this.config.customerId
+        },
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const body = await response.text();
+        throw new IopoleAPIError(
+          `[IopoleClient] GET ${path} \u2192 ${response.status}`,
+          response.status,
+          body
+        );
+      }
+      const data = new Uint8Array(await response.arrayBuffer());
+      const contentType = response.headers.get("content-type") ?? "application/octet-stream";
+      return { data, contentType };
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+};
+
+// src/runtime.ts
+import { statSync as fsStatSync } from "node:fs";
+import { readFile as readFile2 } from "node:fs/promises";
+function env2(key) {
+  return process.env[key];
+}
+async function readTextFile2(path) {
+  return await readFile2(path, "utf-8");
+}
+function statSync(path) {
+  try {
+    fsStatSync(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getArgs() {
+  return process.argv.slice(2);
+}
+function exit(code) {
+  process.exit(code);
+}
+function onSignal(signal, handler) {
+  process.on(signal, handler);
+}
+
+// src/adapters/shared/env.ts
+function requireEnv(adapter, name, hint) {
+  const value = env2(name);
+  if (!value) {
+    throw new Error(`[${adapter}] ${name} is required. ${hint}`);
+  }
+  return value;
+}
+
+// src/adapters/shared/direction.ts
+var RECEIVED = /* @__PURE__ */ new Set(["received", "inbound", "in"]);
+var SENT = /* @__PURE__ */ new Set(["sent", "emitted", "outbound", "out"]);
+function normalizeDirection(raw2) {
+  if (!raw2) return void 0;
+  const l = raw2.toLowerCase();
+  if (RECEIVED.has(l)) return "received";
+  if (SENT.has(l)) return "sent";
+  return void 0;
+}
+
+// src/adapters/iopole/adapter.ts
+var IOPOLE_DEFAULT_AUTH_URL = "https://auth.ppd.iopole.fr/realms/iopole/protocol/openid-connect/token";
+var IopoleAdapter = class extends BaseAdapter {
+  name = "iopole";
+  capabilities = /* @__PURE__ */ new Set([
+    "emitInvoice",
+    "searchInvoices",
+    "getInvoice",
+    "downloadInvoice",
+    "downloadReadable",
+    "getInvoiceFiles",
+    "getAttachments",
+    "downloadFile",
+    "markInvoiceSeen",
+    "getUnseenInvoices",
+    "generateCII",
+    "generateUBL",
+    "generateFacturX",
+    "searchDirectoryFr",
+    "searchDirectoryInt",
+    "checkPeppolParticipant",
+    "sendStatus",
+    "getStatusHistory",
+    "getUnseenStatuses",
+    "markStatusSeen",
+    "reportInvoiceTransaction",
+    "reportTransaction",
+    "listWebhooks",
+    "getWebhook",
+    "createWebhook",
+    "updateWebhook",
+    "deleteWebhook",
+    "getCustomerId",
+    "listBusinessEntities",
+    "getBusinessEntity",
+    "createLegalUnit",
+    "createOffice",
+    "deleteBusinessEntity",
+    "configureBusinessEntity",
+    "claimBusinessEntity",
+    "claimBusinessEntityByIdentifier",
+    "enrollFrench",
+    "enrollInternational",
+    "registerNetwork",
+    "registerNetworkByScheme",
+    "unregisterNetwork",
+    "createIdentifier",
+    "createIdentifierByScheme",
+    "deleteIdentifier",
+    "deleteClaim"
+  ]);
+  client;
+  constructor(client) {
+    super();
+    this.client = client;
+  }
+  // ─── Invoice Operations ───────────────────────────────
+  async emitInvoice(req) {
+    return await this.client.upload("/invoice", req.file, req.filename);
+  }
+  async searchInvoices(filters) {
+    const raw2 = await this.client.getV11("/invoice/search", {
+      q: filters.q,
+      expand: filters.expand ?? "businessData",
+      offset: filters.offset ?? 0,
+      limit: filters.limit ?? 50
+    });
+    const data = raw2.data ?? [];
+    const count = raw2.meta?.count ?? raw2.count ?? data.length;
+    const rows = data.map((row) => {
+      const m = row.metadata ?? {};
+      const bd = row.businessData ?? {};
+      return {
+        id: m.invoiceId ?? "",
+        invoiceNumber: bd.invoiceId,
+        status: m.state,
+        // will be enriched below
+        direction: normalizeDirection(m.direction),
+        senderName: bd.seller?.name,
+        receiverName: bd.buyer?.name,
+        date: bd.invoiceDate ?? m.createDate?.split("T")[0],
+        amount: bd.monetary?.invoiceAmount?.amount,
+        currency: bd.monetary?.invoiceCurrency ?? "EUR"
+      };
+    });
+    const CONCURRENCY = 5;
+    for (let i = 0; i < rows.length; i += CONCURRENCY) {
+      const batch = rows.slice(i, i + CONCURRENCY);
+      await Promise.all(batch.map(async (row) => {
+        if (!row.id) return;
+        try {
+          const history = await this.getStatusHistory(row.id);
+          if (history.entries.length > 0) {
+            const sorted = [...history.entries].sort(
+              (a, b) => new Date(b.date).getTime() - new Date(a.date).getTime()
+            );
+            row.status = sorted[0].code;
+          }
+        } catch {
+        }
+      }));
+    }
+    return { rows, count };
+  }
+  async getInvoice(id) {
+    const [raw2, history] = await Promise.all([
+      this.client.get(`/invoice/${encodePathSegment(id)}`, { expand: "businessData" }),
+      this.getStatusHistory(id).catch(() => ({ entries: [] }))
+    ]);
+    const inv = Array.isArray(raw2) ? raw2[0] : raw2;
+    const latestStatus = history.entries.length > 0 ? [...history.entries].sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime())[0].code : void 0;
+    const bd = inv?.businessData;
+    return {
+      id: inv?.invoiceId ?? id,
+      invoiceNumber: bd?.invoiceId,
+      status: latestStatus ?? inv?.state ?? inv?.status ?? "UNKNOWN",
+      direction: normalizeDirection(inv?.way ?? inv?.metadata?.direction),
+      format: inv?.originalFormat,
+      network: inv?.originalNetwork,
+      invoiceType: bd?.detailedType?.value,
+      senderName: bd?.seller?.name,
+      senderId: bd?.seller?.siret ?? bd?.seller?.siren,
+      senderVat: bd?.seller?.vatNumber,
+      receiverName: bd?.buyer?.name,
+      receiverId: bd?.buyer?.siret ?? bd?.buyer?.siren,
+      receiverVat: bd?.buyer?.vatNumber,
+      issueDate: bd?.invoiceDate,
+      dueDate: bd?.invoiceDueDate,
+      receiptDate: bd?.invoiceReceiptDate,
+      currency: bd?.monetary?.invoiceCurrency ?? "EUR",
+      totalHt: bd?.monetary?.taxBasisTotalAmount?.amount,
+      totalTax: bd?.monetary?.taxTotalAmount?.amount,
+      totalTtc: bd?.monetary?.invoiceAmount?.amount,
+      lines: bd?.lines?.map((l) => {
+        const line = l;
+        return {
+          description: line.item?.name,
+          quantity: line.billedQuantity?.quantity,
+          unitPrice: line.price?.netAmount?.amount,
+          taxRate: line.taxDetail?.percent,
+          amount: line.totalAmount?.amount
+        };
+      }),
+      notes: bd?.notes?.map((n) => n.content).filter(Boolean)
+    };
+  }
+  async downloadInvoice(id) {
+    return await this.client.download(`/invoice/${encodePathSegment(id)}/download`);
+  }
+  async downloadReadable(id) {
+    return await this.client.download(`/invoice/${encodePathSegment(id)}/download/readable`);
+  }
+  async getInvoiceFiles(id) {
+    return await this.client.get(`/invoice/${encodePathSegment(id)}/files`);
+  }
+  async getAttachments(id) {
+    return await this.client.get(`/invoice/${encodePathSegment(id)}/files/attachments`);
+  }
+  async downloadFile(fileId) {
+    return await this.client.download(`/invoice/file/${encodePathSegment(fileId)}/download`);
+  }
+  async markInvoiceSeen(id) {
+    return await this.client.put(`/invoice/${encodePathSegment(id)}/markAsSeen`);
+  }
+  async getUnseenInvoices(pagination) {
+    return await this.client.get("/invoice/notSeen", {
+      offset: pagination.offset,
+      limit: pagination.limit
+    });
+  }
+  async generateCII(req) {
+    return await this.client.postWithQuery("/tools/cii/generate", normalizeForIopole(req.invoice), {
+      flavor: req.flavor
+    });
+  }
+  async generateUBL(req) {
+    return await this.client.postWithQuery("/tools/ubl/generate", normalizeForIopole(req.invoice), {
+      flavor: req.flavor
+    });
+  }
+  async generateFacturX(req) {
+    return await this.client.postBinary("/tools/facturx/generate", normalizeForIopole(req.invoice), {
+      flavor: req.flavor,
+      language: req.language
+    });
+  }
+  // ─── Directory ────────────────────────────────────────
+  async searchDirectoryFr(filters) {
+    const q = autoWrapDirectoryQuery(filters.q);
+    const raw2 = await this.client.get("/directory/french", {
+      q,
+      offset: filters.offset,
+      limit: filters.limit
+    });
+    const data = raw2.data ?? [];
+    const count = raw2.meta?.count ?? raw2.count ?? data.length;
+    const rows = data.map((row) => {
+      const ci = row.countryIdentifier ?? {};
+      return {
+        entityId: row.businessEntityId ?? "",
+        name: row.name,
+        type: row.type,
+        siren: ci.siren ?? row.siren,
+        siret: ci.siret ?? row.siret,
+        country: ci.country ?? row.country ?? "FR",
+        identifiers: row.identifiers
+      };
+    });
+    return { rows, count };
+  }
+  async searchDirectoryInt(filters) {
+    return await this.client.get("/directory/international", {
+      value: filters.value,
+      offset: filters.offset,
+      limit: filters.limit
+    });
+  }
+  async checkPeppolParticipant(scheme, value) {
+    return await this.client.get(
+      `/directory/international/check/scheme/${encodePathSegment(scheme)}/value/${encodePathSegment(value)}`
+    );
+  }
+  // ─── Status ───────────────────────────────────────────
+  async sendStatus(req) {
+    return await this.client.post(`/invoice/${encodePathSegment(req.invoiceId)}/status`, {
+      code: req.code,
+      message: req.message,
+      payment: req.payment
+    });
+  }
+  async getStatusHistory(invoiceId) {
+    const raw2 = await this.client.get(`/invoice/${encodePathSegment(invoiceId)}/status-history`);
+    return normalizeStatusHistory(raw2);
+  }
+  async getUnseenStatuses(pagination) {
+    return await this.client.get("/invoice/status/notSeen", {
+      offset: pagination.offset,
+      limit: pagination.limit
+    });
+  }
+  async markStatusSeen(statusId) {
+    return await this.client.put(`/invoice/status/${encodePathSegment(statusId)}/markAsSeen`);
+  }
+  // ─── Reporting ────────────────────────────────────────
+  async reportInvoiceTransaction(transaction) {
+    return await this.client.post("/reporting/fr/invoice/transaction", transaction);
+  }
+  async reportTransaction(businessEntityId, transaction) {
+    return await this.client.post(
+      `/reporting/fr/transaction/${encodePathSegment(businessEntityId)}`,
+      transaction
+    );
+  }
+  // ─── Webhooks ─────────────────────────────────────────
+  async listWebhooks() {
+    return await this.client.get("/config/webhook");
+  }
+  async getWebhook(id) {
+    return await this.client.get(`/config/webhook/${encodePathSegment(id)}`);
+  }
+  async createWebhook(req) {
+    return await this.client.post("/config/webhook", req);
+  }
+  async updateWebhook(id, req) {
+    return await this.client.put(`/config/webhook/${encodePathSegment(id)}`, req);
+  }
+  async deleteWebhook(id) {
+    return await this.client.delete(`/config/webhook/${encodePathSegment(id)}`);
+  }
+  // ─── Operator Config ───────────────────────────────────
+  async getCustomerId() {
+    return await this.client.get("/config/customer/id");
+  }
+  async listBusinessEntities() {
+    const raw2 = await this.client.get("/config/business/entity");
+    const data = raw2.data ?? [];
+    const rows = data.map((row) => {
+      const ci = row.countryIdentifier ?? {};
+      return {
+        entityId: row.businessEntityId ?? "",
+        name: row.name,
+        type: row.type,
+        siren: ci.siren ?? row.siren,
+        siret: ci.siret ?? row.siret,
+        scope: row.scope,
+        country: ci.country ?? row.country ?? "FR"
+      };
+    });
+    return { rows, count: rows.length };
+  }
+  async getBusinessEntity(id) {
+    return await this.client.get(`/config/business/entity/${encodePathSegment(id)}`);
+  }
+  async createLegalUnit(data) {
+    return await this.client.post("/config/business/entity/legalunit", data);
+  }
+  async createOffice(data) {
+    return await this.client.post("/config/business/entity/office", data);
+  }
+  async deleteBusinessEntity(id) {
+    return await this.client.delete(`/config/business/entity/${encodePathSegment(id)}`);
+  }
+  async configureBusinessEntity(id, data) {
+    return await this.client.post(`/config/business/entity/${encodePathSegment(id)}/configure`, data);
+  }
+  async claimBusinessEntity(id, data) {
+    return await this.client.post(`/config/business/entity/${encodePathSegment(id)}/claim`, data);
+  }
+  async claimBusinessEntityByIdentifier(scheme, value, data) {
+    return await this.client.post(
+      `/config/business/entity/scheme/${encodePathSegment(scheme)}/value/${encodePathSegment(value)}/claim`,
+      data
+    );
+  }
+  async enrollFrench(data) {
+    return await this.client.put("/config/french/enrollment", data);
+  }
+  async enrollInternational(data) {
+    return await this.client.put("/config/international/enrollment", data);
+  }
+  async registerNetwork(identifierId, network) {
+    return await this.client.post(
+      `/config/business/entity/identifier/${encodePathSegment(identifierId)}/network/${encodePathSegment(network)}`
+    );
+  }
+  async registerNetworkByScheme(scheme, value, network) {
+    return await this.client.post(
+      `/config/business/entity/identifier/scheme/${encodePathSegment(scheme)}/value/${encodePathSegment(value)}/network/${encodePathSegment(network)}`
+    );
+  }
+  async unregisterNetwork(directoryId) {
+    return await this.client.delete(
+      `/config/business/entity/identifier/directory/${encodePathSegment(directoryId)}`
+    );
+  }
+  // ─── Identifier Management ───────────────────────────────
+  async createIdentifier(entityId, data) {
+    return await this.client.post(`/config/business/entity/${encodePathSegment(entityId)}/identifier`, data);
+  }
+  async createIdentifierByScheme(scheme, value, data) {
+    return await this.client.post(
+      `/config/business/entity/scheme/${encodePathSegment(scheme)}/value/${encodePathSegment(value)}/identifier`,
+      data
+    );
+  }
+  async deleteIdentifier(identifierId) {
+    return await this.client.delete(`/config/business/entity/identifier/${encodePathSegment(identifierId)}`);
+  }
+  // ─── Claim Management ────────────────────────────────────
+  async deleteClaim(entityId) {
+    return await this.client.delete(`/config/business/entity/${encodePathSegment(entityId)}/claim`);
+  }
+};
+var normalizeForIopole = (inv) => {
+  const normalized = { ...inv };
+  for (const party of ["seller", "buyer"]) {
+    if (normalized[party] && !normalized[party].postalAddress) {
+      normalized[party] = {
+        ...normalized[party],
+        postalAddress: { country: normalized[party].country ?? "FR" }
+      };
+    }
+  }
+  for (const party of ["seller", "buyer"]) {
+    const p = normalized[party];
+    if (p && !p.electronicAddress && p.siren && p.siret) {
+      normalized[party] = {
+        ...p,
+        electronicAddress: `0225:${p.siren}_${p.siret}`,
+        identifiers: p.identifiers ?? [
+          { type: "ELECTRONIC_ADDRESS", value: `${p.siren}_${p.siret}`, scheme: "0225" },
+          { type: "PARTY_LEGAL_IDENTIFIER", value: p.siren, scheme: "0002" }
+        ]
+      };
+    }
+  }
+  if (Array.isArray(normalized.paymentTerms)) {
+    normalized.paymentTerms = normalized.paymentTerms.map((t) => t.description ?? t).join("; ");
+  }
+  if (normalized.monetary) {
+    const m = { ...normalized.monetary };
+    const currency = m.invoiceCurrency ?? "EUR";
+    if (!m.payableAmount) m.payableAmount = m.invoiceAmount;
+    if (m.taxTotalAmount && !m.taxTotalAmount.currency) {
+      m.taxTotalAmount = { ...m.taxTotalAmount, currency };
+    }
+    normalized.monetary = m;
+  }
+  if (Array.isArray(normalized.lines)) {
+    normalized.lines = normalized.lines.map((line) => {
+      if (line.taxDetail && !line.taxDetail.categoryCode) {
+        return { ...line, taxDetail: { ...line.taxDetail, categoryCode: "S" } };
+      }
+      return line;
+    });
+  }
+  return normalized;
+};
+function autoWrapDirectoryQuery(q) {
+  const trimmed = q.trim();
+  if (/^\d{14}$/.test(trimmed)) return `siret:"${trimmed}"`;
+  if (/^\d{9}$/.test(trimmed)) return `siren:"${trimmed}"`;
+  if (/^FR\d{11}$/i.test(trimmed)) return `vatNumber:"${trimmed.toUpperCase()}"`;
+  if (trimmed.length >= 3 && !/^\d+$/.test(trimmed) && !trimmed.includes(":")) {
+    return `name:"*${trimmed}*"`;
+  }
+  return trimmed;
+}
+function normalizeStatusHistory(raw2) {
+  let entries = [];
+  if (Array.isArray(raw2)) {
+    entries = raw2;
+  } else if (raw2 && typeof raw2 === "object") {
+    const obj = raw2;
+    if (Array.isArray(obj.data)) entries = obj.data;
+    else if (Array.isArray(obj.entries)) entries = obj.entries;
+    else if (Array.isArray(obj.history)) entries = obj.history;
+  }
+  return {
+    entries: entries.map((e) => ({
+      date: e.date ?? e.createdAt ?? "",
+      code: e.status?.code ?? e.code ?? e.statusCode ?? "",
+      message: e.status?.message ?? e.message,
+      destType: e.destType
+    }))
+  };
+}
+function createIopoleAdapter() {
+  const baseUrl = requireEnv(
+    "IopoleAdapter",
+    "IOPOLE_API_URL",
+    "Set it to https://api.ppd.iopole.fr/v1 (sandbox) or https://api.iopole.com/v1 (production)."
+  );
+  const clientId = requireEnv(
+    "IopoleAdapter",
+    "IOPOLE_CLIENT_ID",
+    "Get your client ID from the Iopole dashboard or admin console."
+  );
+  const clientSecret = requireEnv(
+    "IopoleAdapter",
+    "IOPOLE_CLIENT_SECRET",
+    "Get your client secret from the Iopole dashboard or admin console."
+  );
+  const customerId = requireEnv(
+    "IopoleAdapter",
+    "IOPOLE_CUSTOMER_ID",
+    "Find it in Settings \u2192 Unique Identifier (sandbox) or admin console."
+  );
+  const authUrl = env2("IOPOLE_AUTH_URL") || IOPOLE_DEFAULT_AUTH_URL;
+  const getToken = createOAuth2TokenProvider({ authUrl, clientId, clientSecret });
+  const client = new IopoleClient({ baseUrl, customerId, getToken });
+  return new IopoleAdapter(client);
+}
+
+// src/adapters/shared/http-client.ts
+var BaseHttpClient = class {
+  config;
+  adapterName;
+  constructor(adapterName, config2) {
+    this.adapterName = adapterName;
+    this.config = config2;
+  }
+  // ─── Generic Request ────────────────────────────────────
+  async request(method, path, options) {
+    const url2 = new URL(`${this.config.baseUrl}${path}`);
+    if (options?.query) {
+      for (const [key, value] of Object.entries(options.query)) {
+        if (value === void 0) continue;
+        if (Array.isArray(value)) {
+          for (const v of value) url2.searchParams.append(key, v);
+        } else {
+          url2.searchParams.set(key, String(value));
+        }
+      }
+    }
+    const authHeaders = await this.getAuthHeaders();
+    const headers = {
+      ...authHeaders,
+      Accept: "application/json",
+      ...options?.headers
+    };
+    let bodyPayload;
+    if (options?.body) {
+      if (options.contentType && options.body instanceof Uint8Array) {
+        headers["Content-Type"] = options.contentType;
+        bodyPayload = options.body;
+      } else {
+        headers["Content-Type"] = options.contentType ?? "application/json";
+        bodyPayload = JSON.stringify(options.body);
+      }
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(
+      () => controller.abort(),
+      this.config.timeoutMs ?? 3e4
+    );
+    try {
+      const response = await fetch(url2.toString(), {
+        method,
+        headers,
+        body: bodyPayload,
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const body = await response.text();
+        throw new AdapterAPIError(
+          this.adapterName,
+          `[${this.adapterName}] ${method} ${path} \u2192 ${response.status}: ${body.slice(0, 500)}`,
+          response.status,
+          body
+        );
+      }
+      const ct = response.headers.get("content-type") ?? "";
+      if (ct.includes("application/json")) {
+        return await response.json();
+      }
+      return await response.text();
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  // ─── Convenience Methods ────────────────────────────────
+  async get(path, query) {
+    return this.request("GET", path, { query });
+  }
+  async post(path, body) {
+    return this.request("POST", path, { body });
+  }
+  async put(path, body) {
+    return this.request("PUT", path, { body });
+  }
+  async patch(path, body) {
+    return this.request("PATCH", path, { body });
+  }
+  async delete(path) {
+    return this.request("DELETE", path);
+  }
+  /**
+   * Download a binary resource. Returns raw bytes + content type.
+   */
+  async download(path) {
+    const url2 = `${this.config.baseUrl}${path}`;
+    const authHeaders = await this.getAuthHeaders();
+    const controller = new AbortController();
+    const timeout = setTimeout(
+      () => controller.abort(),
+      this.config.timeoutMs ?? 3e4
+    );
+    try {
+      const response = await fetch(url2, {
+        method: "GET",
+        headers: authHeaders,
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const body = await response.text();
+        throw new AdapterAPIError(
+          this.adapterName,
+          `[${this.adapterName}] GET ${path} \u2192 ${response.status}`,
+          response.status,
+          body
+        );
+      }
+      const data = new Uint8Array(await response.arrayBuffer());
+      const contentType = response.headers.get("content-type") ?? "application/octet-stream";
+      return { data, contentType };
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+};
+
+// src/adapters/storecove/client.ts
+var StorecoveClient = class extends BaseHttpClient {
+  apiKey;
+  constructor(config2) {
+    super("Storecove", { baseUrl: config2.baseUrl, timeoutMs: config2.timeoutMs });
+    this.apiKey = config2.apiKey;
+  }
+  async getAuthHeaders() {
+    return { Authorization: `Bearer ${this.apiKey}` };
+  }
+};
+
+// src/adapters/storecove/adapter.ts
+var StorecoveAdapter = class extends BaseAdapter {
+  name = "storecove";
+  /** Only methods with real Storecove API mappings. */
+  capabilities = /* @__PURE__ */ new Set([
+    // Invoice
+    "emitInvoice",
+    "getInvoice",
+    "downloadInvoice",
+    // Directory
+    "searchDirectoryFr",
+    "searchDirectoryInt",
+    "checkPeppolParticipant",
+    // Status
+    "getStatusHistory",
+    // Webhooks
+    "listWebhooks",
+    "deleteWebhook",
+    // Config / Entities
+    "getBusinessEntity",
+    "createLegalUnit",
+    "deleteBusinessEntity",
+    "configureBusinessEntity",
+    // Identifiers / Network
+    "enrollInternational",
+    "registerNetwork",
+    "registerNetworkByScheme",
+    "unregisterNetwork",
+    "createIdentifier",
+    "createIdentifierByScheme",
+    "deleteIdentifier"
+  ]);
+  client;
+  /** Default legal entity ID for operations that need one. */
+  defaultLegalEntityId;
+  constructor(client, defaultLegalEntityId) {
+    super();
+    this.client = client;
+    this.defaultLegalEntityId = defaultLegalEntityId;
+  }
+  // ─── Invoice Operations ───────────────────────────────
+  async emitInvoice(req) {
+    const base643 = uint8ToBase64(req.file);
+    const isXml = req.filename.toLowerCase().endsWith(".xml");
+    return await this.client.post("/document_submissions", {
+      document: {
+        document_type: "invoice",
+        raw_document: base643,
+        raw_document_content_type: isXml ? "application/xml" : "application/pdf"
+      },
+      ...this.defaultLegalEntityId ? { legal_entity_id: Number(this.defaultLegalEntityId) } : {}
+    });
+  }
+  async searchInvoices(_filters) {
+    throw new NotSupportedError(
+      this.name,
+      "searchInvoices",
+      "Storecove delivers invoices via webhooks (push) or pull queue. There is no search endpoint. Use webhook pull mode to retrieve pending documents."
+    );
+  }
+  async getInvoice(id) {
+    const doc = await this.client.get(`/received_documents/${encodePathSegment(id)}/json`);
+    return {
+      id,
+      invoiceNumber: doc.invoiceNumber ?? doc.document?.invoiceNumber,
+      status: doc.status ?? "received",
+      direction: "received",
+      senderName: doc.accountingSupplierParty?.party?.partyName,
+      receiverName: doc.accountingCustomerParty?.party?.partyName,
+      issueDate: doc.issueDate,
+      dueDate: doc.dueDate,
+      currency: doc.documentCurrencyCode ?? "EUR",
+      totalTtc: doc.legalMonetaryTotal?.payableAmount
+    };
+  }
+  async downloadInvoice(id) {
+    return await this.client.download(`/received_documents/${encodePathSegment(id)}/original`);
+  }
+  async downloadReadable(_id) {
+    throw new NotSupportedError(
+      this.name,
+      "downloadReadable",
+      "Storecove does not generate readable PDFs. Use getInvoice for JSON or downloadInvoice for the original document."
+    );
+  }
+  async getInvoiceFiles(_id) {
+    throw new NotSupportedError(
+      this.name,
+      "getInvoiceFiles",
+      "Storecove documents are atomic \u2014 no separate files list. Use getInvoice or downloadInvoice."
+    );
+  }
+  async getAttachments(_id) {
+    throw new NotSupportedError(
+      this.name,
+      "getAttachments",
+      "Attachments are embedded in the Storecove document. Use getInvoice to access them."
+    );
+  }
+  async downloadFile(_fileId) {
+    throw new NotSupportedError(
+      this.name,
+      "downloadFile",
+      "Storecove has no separate file download. Use downloadInvoice for the full document."
+    );
+  }
+  async markInvoiceSeen(_id) {
+    throw new NotSupportedError(
+      this.name,
+      "markInvoiceSeen",
+      "Storecove does not track seen/unseen state via API."
+    );
+  }
+  async getUnseenInvoices(_pagination) {
+    throw new NotSupportedError(
+      this.name,
+      "getUnseenInvoices",
+      "Use Storecove webhook pull mode to poll for new documents."
+    );
+  }
+  async generateCII(_req) {
+    throw new NotSupportedError(
+      this.name,
+      "generateCII",
+      "Storecove auto-generates the compliant format on submission. Use emitInvoice with JSON Pure mode instead."
+    );
+  }
+  async generateUBL(_req) {
+    throw new NotSupportedError(
+      this.name,
+      "generateUBL",
+      "Storecove auto-generates the compliant format on submission. Use emitInvoice with JSON Pure mode instead."
+    );
+  }
+  async generateFacturX(_req) {
+    throw new NotSupportedError(
+      this.name,
+      "generateFacturX",
+      "Storecove auto-generates the compliant format on submission. Use emitInvoice with JSON Pure mode instead."
+    );
+  }
+  // ─── Directory ────────────────────────────────────────
+  async searchDirectoryFr(filters) {
+    const raw2 = await this.client.post("/discovery/exists", {
+      identifier: filters.q
+    });
+    const participant = raw2?.participant ?? raw2;
+    if (!participant || !participant.identifier) {
+      return { rows: [], count: 0 };
+    }
+    return {
+      rows: [{
+        entityId: participant.identifier ?? "",
+        name: participant.name ?? participant.partyName,
+        country: participant.country
+      }],
+      count: 1
+    };
+  }
+  async searchDirectoryInt(filters) {
+    return await this.client.post("/discovery/receives", {
+      identifier: filters.value
+    });
+  }
+  async checkPeppolParticipant(scheme, value) {
+    return await this.client.post("/discovery/exists", {
+      identifier: { scheme, identifier: value }
+    });
+  }
+  // ─── Status ───────────────────────────────────────────
+  async sendStatus(_req) {
+    throw new NotSupportedError(
+      this.name,
+      "sendStatus",
+      "Storecove status is managed by the receiving Access Point. The sender receives delivery evidence via the evidence endpoint."
+    );
+  }
+  async getStatusHistory(invoiceId) {
+    const raw2 = await this.client.get(
+      `/document_submissions/${encodePathSegment(invoiceId)}/evidence/delivery`
+    );
+    return {
+      entries: raw2 ? [{
+        date: raw2.timestamp ?? raw2.date ?? "",
+        code: raw2.status ?? "delivered",
+        message: raw2.description
+      }] : []
+    };
+  }
+  async getUnseenStatuses(_pagination) {
+    throw new NotSupportedError(
+      this.name,
+      "getUnseenStatuses",
+      "Storecove delivers status changes via webhooks."
+    );
+  }
+  async markStatusSeen(_statusId) {
+    throw new NotSupportedError(
+      this.name,
+      "markStatusSeen",
+      "Storecove does not track seen/unseen status via API."
+    );
+  }
+  // ─── Reporting ────────────────────────────────────────
+  async reportInvoiceTransaction(_transaction) {
+    throw new NotSupportedError(
+      this.name,
+      "reportInvoiceTransaction",
+      "Storecove handles tax reporting internally based on the destination country."
+    );
+  }
+  async reportTransaction(_businessEntityId, _transaction) {
+    throw new NotSupportedError(
+      this.name,
+      "reportTransaction",
+      "Storecove handles tax reporting internally based on the destination country."
+    );
+  }
+  // ─── Webhooks ─────────────────────────────────────────
+  async listWebhooks() {
+    throw new NotSupportedError(
+      this.name,
+      "listWebhooks",
+      "Storecove /webhook_instances is a pull queue, not webhook config CRUD."
+    );
+  }
+  async getWebhook(_id) {
+    throw new NotSupportedError(
+      this.name,
+      "getWebhook",
+      "Storecove has no get-by-id webhook endpoint. Use listWebhooks instead."
+    );
+  }
+  async createWebhook(_req) {
+    throw new NotSupportedError(
+      this.name,
+      "createWebhook",
+      "Storecove webhooks are configured via the Storecove dashboard UI, not the API."
+    );
+  }
+  async updateWebhook(_id, _req) {
+    throw new NotSupportedError(
+      this.name,
+      "updateWebhook",
+      "Storecove webhooks are configured via the Storecove dashboard UI, not the API."
+    );
+  }
+  async deleteWebhook(_id) {
+    throw new NotSupportedError(
+      this.name,
+      "deleteWebhook",
+      "Storecove /webhook_instances is a pull queue, not webhook config CRUD."
+    );
+  }
+  // ─── Operator Config ───────────────────────────────────
+  async getCustomerId() {
+    throw new NotSupportedError(
+      this.name,
+      "getCustomerId",
+      "Storecove uses API keys, not customer IDs. Your identity is implicit in the API key."
+    );
+  }
+  async listBusinessEntities() {
+    throw new NotSupportedError(
+      this.name,
+      "listBusinessEntities",
+      "Storecove has no list-all endpoint for legal entities. Track entity IDs locally after creation, or use getBusinessEntity with a known ID."
+    );
+  }
+  async getBusinessEntity(id) {
+    return await this.client.get(`/legal_entities/${encodePathSegment(id)}`);
+  }
+  async createLegalUnit(_data) {
+    throw new NotSupportedError(
+      this.name,
+      "createLegalUnit",
+      "Storecove requires address fields (line1, city, zip) not collected by the generic tool schema. Implement normalizeForStorecove when ready."
+    );
+  }
+  async createOffice(_data) {
+    throw new NotSupportedError(
+      this.name,
+      "createOffice",
+      "Storecove has no office/establishment concept. Use createLegalUnit for all entities."
+    );
+  }
+  async deleteBusinessEntity(id) {
+    return await this.client.delete(`/legal_entities/${encodePathSegment(id)}`);
+  }
+  async configureBusinessEntity(_id, _data) {
+    throw new NotSupportedError(
+      this.name,
+      "configureBusinessEntity",
+      "Storecove PATCH /legal_entities uses a different model than the generic tool schema."
+    );
+  }
+  async claimBusinessEntity(_id, _data) {
+    throw new NotSupportedError(
+      this.name,
+      "claimBusinessEntity",
+      "Storecove has no entity claim workflow. Entities are created and owned directly."
+    );
+  }
+  async claimBusinessEntityByIdentifier(_scheme, _value, _data) {
+    throw new NotSupportedError(
+      this.name,
+      "claimBusinessEntityByIdentifier",
+      "Storecove has no entity claim workflow. Entities are created and owned directly."
+    );
+  }
+  async enrollFrench(_data) {
+    throw new NotSupportedError(
+      this.name,
+      "enrollFrench",
+      "Use enrollInternational with Peppol identifiers for French entity registration on Storecove."
+    );
+  }
+  async enrollInternational(data) {
+    const legalEntityId = data.legalEntityId ?? this.defaultLegalEntityId;
+    if (!legalEntityId) {
+      throw new Error("[StorecoveAdapter] enrollInternational requires legalEntityId");
+    }
+    return await this.client.post(
+      `/legal_entities/${encodePathSegment(String(legalEntityId))}/peppol_identifiers`,
+      {
+        superscheme: data.superscheme ?? "iso6523-actorid-upis",
+        scheme: data.scheme,
+        identifier: data.identifier ?? data.value
+      }
+    );
+  }
+  async registerNetwork(identifierId, _network) {
+    return { message: `Peppol identifier ${identifierId} is registered on creation in Storecove.` };
+  }
+  async registerNetworkByScheme(scheme, value, _network) {
+    return {
+      message: `Peppol identifier ${scheme}:${value} is registered on creation in Storecove. Use enrollInternational to create the identifier.`
+    };
+  }
+  async unregisterNetwork(directoryId) {
+    const parts = directoryId.split("/");
+    if (parts.length < 4) {
+      throw new Error(
+        "[StorecoveAdapter] unregisterNetwork expects directoryId as 'legalEntityId/superscheme/scheme/identifier'"
+      );
+    }
+    const [legalEntityId, ...rest] = parts;
+    return await this.client.delete(
+      `/legal_entities/${encodePathSegment(legalEntityId)}/peppol_identifiers/${rest.map(encodePathSegment).join("/")}`
+    );
+  }
+  // ─── Identifier Management ───────────────────────────────
+  async createIdentifier(entityId, data) {
+    if (data.scheme && String(data.scheme).startsWith("0")) {
+      return await this.client.post(
+        `/legal_entities/${encodePathSegment(entityId)}/peppol_identifiers`,
+        {
+          superscheme: data.superscheme ?? "iso6523-actorid-upis",
+          scheme: data.scheme,
+          identifier: data.value
+        }
+      );
+    }
+    return await this.client.post(
+      `/legal_entities/${encodePathSegment(entityId)}/additional_tax_identifiers`,
+      data
+    );
+  }
+  async createIdentifierByScheme(_scheme, _value, _data) {
+    throw new NotSupportedError(
+      this.name,
+      "createIdentifierByScheme",
+      "Storecove cannot look up entities by scheme/value \u2014 requires legalEntityId. Implement when tool schema supports it."
+    );
+  }
+  async deleteIdentifier(identifierId) {
+    if (identifierId.includes("/")) {
+      const segments = identifierId.split("/").map(encodePathSegment).join("/");
+      return await this.client.delete(
+        `/legal_entities/${segments}`
+      );
+    }
+    throw new Error(
+      "[StorecoveAdapter] deleteIdentifier for tax identifiers requires the full path: 'legalEntityId/additional_tax_identifiers/identifierId'"
+    );
+  }
+  // ─── Claim Management ────────────────────────────────────
+  async deleteClaim(_entityId) {
+    throw new NotSupportedError(
+      this.name,
+      "deleteClaim",
+      "Storecove has no entity claim concept. Delete the entity directly with deleteBusinessEntity."
+    );
+  }
+};
+function createStorecoveAdapter() {
+  const baseUrl = requireEnv(
+    "StorecoveAdapter",
+    "STORECOVE_API_URL",
+    "Set it to https://api.storecove.com/api/v2 (production/sandbox)."
+  );
+  const apiKey = requireEnv(
+    "StorecoveAdapter",
+    "STORECOVE_API_KEY",
+    "Get your API key from the Storecove dashboard."
+  );
+  const defaultLegalEntityId = env2("STORECOVE_LEGAL_ENTITY_ID") || void 0;
+  const client = new StorecoveClient({ baseUrl, apiKey });
+  return new StorecoveAdapter(client, defaultLegalEntityId);
+}
+
+// src/adapters/afnor/base-adapter.ts
+var AfnorBaseAdapter = class extends BaseAdapter {
+  afnor;
+  constructor(afnor) {
+    super();
+    this.afnor = afnor;
+  }
+  // ─── Invoice Operations (AFNOR: submitFlow, searchFlows, downloadFlow) ───
+  async emitInvoice(req) {
+    const afnor = this.requireAfnor("emitInvoice");
+    const syntax = req.filename.toLowerCase().endsWith(".pdf") ? "Factur-X" : "CII";
+    return await afnor.submitFlow(
+      req.file,
+      { flowSyntax: syntax, name: req.filename, processingRule: "B2B" }
+    );
   }
-  /**
-   * GET request against the v1.1 API endpoint.
-   * Replaces /v1 with /v1.1 in the base URL for endpoints that require it
-   * (e.g. /v1.1/invoice/search). Safer than path traversal tricks.
-   */
-  async getV11(path, query) {
-    const originalBase = this.config.baseUrl;
-    try {
-      this.config.baseUrl = originalBase.replace(/\/v1\b/, "/v1.1");
-      return await this.request("GET", path, { query });
-    } finally {
-      this.config.baseUrl = originalBase;
+  async searchInvoices(filters) {
+    const afnor = this.requireAfnor("searchInvoices");
+    const result = await afnor.searchFlows(
+      {
+        flowType: ["CustomerInvoice", "SupplierInvoice"],
+        ...filters.q ? { trackingId: filters.q } : {}
+      },
+      filters.limit
+    );
+    const rows = (result.results ?? []).map((r) => ({
+      id: r.flowId ?? "",
+      status: r.ackStatus,
+      direction: normalizeDirection(r.flowDirection),
+      date: r.updatedAt ?? r.submittedAt
+    }));
+    return { rows, count: rows.length };
+  }
+  async getInvoice(id) {
+    const afnor = this.requireAfnor("getInvoice");
+    const { data, contentType } = await afnor.downloadFlow(id);
+    if (contentType.includes("json")) {
+      const doc = JSON.parse(new TextDecoder().decode(data));
+      return {
+        id,
+        invoiceNumber: doc.invoiceId ?? doc.invoiceNumber,
+        status: doc.ackStatus ?? doc.status,
+        direction: normalizeDirection(doc.flowDirection),
+        senderName: doc.seller?.name,
+        receiverName: doc.buyer?.name,
+        issueDate: doc.invoiceDate,
+        currency: doc.currency ?? "EUR"
+      };
     }
+    return { id, status: "UNKNOWN" };
   }
-  async post(path, body) {
-    return this.request("POST", path, { body });
+  async downloadInvoice(id) {
+    const afnor = this.requireAfnor("downloadInvoice");
+    return await afnor.downloadFlow(id, "Original");
   }
-  async put(path, body) {
-    return this.request("PUT", path, { body });
+  // ─── Status (AFNOR: lifecycle flows) ───────────────────
+  async sendStatus(req) {
+    const afnor = this.requireAfnor("sendStatus");
+    const cdarPayload = JSON.stringify({
+      invoiceId: req.invoiceId,
+      statusCode: req.code,
+      message: req.message,
+      payment: req.payment
+    });
+    return await afnor.submitFlow(
+      new TextEncoder().encode(cdarPayload),
+      { flowSyntax: "CDAR", name: `status-${req.invoiceId}.json`, processingRule: "B2B" }
+    );
   }
-  async delete(path) {
-    return this.request("DELETE", path);
+  async getStatusHistory(invoiceId) {
+    const afnor = this.requireAfnor("getStatusHistory");
+    const result = await afnor.searchFlows({
+      flowType: ["CustomerInvoiceLC", "SupplierInvoiceLC"],
+      trackingId: invoiceId
+    });
+    const entries = (result.results ?? []).map((r) => ({
+      date: r.updatedAt ?? r.submittedAt ?? "",
+      code: r.ackStatus ?? "",
+      message: r.flowType,
+      destType: r.flowDirection === "In" ? "PLATFORM" : "OPERATOR"
+    }));
+    return { entries };
+  }
+  // ─── Reporting (AFNOR: e-reporting flows) ──────────────
+  async reportInvoiceTransaction(transaction) {
+    const afnor = this.requireAfnor("reportInvoiceTransaction");
+    const payload = new TextEncoder().encode(JSON.stringify(transaction));
+    return await afnor.submitFlow(
+      payload,
+      { flowSyntax: "FRR", name: "report.json", processingRule: "B2C" }
+    );
+  }
+  async reportTransaction(businessEntityId, transaction) {
+    const afnor = this.requireAfnor("reportTransaction");
+    const payload = new TextEncoder().encode(JSON.stringify({ businessEntityId, ...transaction }));
+    return await afnor.submitFlow(
+      payload,
+      { flowSyntax: "FRR", name: "report.json", processingRule: "B2C" }
+    );
+  }
+  // All other methods inherit NotSupportedError stubs from BaseAdapter.
+  // Subclasses override with native API implementations.
+  // ─── Helpers ───────────────────────────────────────────
+  /** Get the AFNOR client or throw if not configured. */
+  requireAfnor(method) {
+    if (!this.afnor) {
+      throw new NotSupportedError(
+        this.name,
+        method,
+        "AFNOR API not configured. Override this method with native implementation."
+      );
+    }
+    return this.afnor;
+  }
+};
+
+// src/adapters/afnor/client.ts
+var AfnorClient = class extends BaseHttpClient {
+  getToken;
+  constructor(config2) {
+    super("AFNOR", { baseUrl: config2.baseUrl, timeoutMs: config2.timeoutMs });
+    this.getToken = config2.getToken;
+  }
+  async getAuthHeaders() {
+    const token = await this.getToken();
+    return { Authorization: `Bearer ${token}` };
   }
+  // ─── AFNOR-Specific Methods ──────────────────────────
   /**
-   * Upload a file via multipart/form-data.
-   * Used for POST /invoice (emitInvoice) — the Swagger spec requires
-   * Content-Type: multipart/form-data with a `file` field (binary, PDF or XML).
+   * Submit a new flow (invoice, lifecycle event, or e-reporting).
+   * POST /v1/flows — multipart: flowInfo (JSON) + file (binary).
    */
-  async upload(path, file2, filename) {
-    const url2 = `${this.config.baseUrl}${path}`;
-    const token = await this.config.getToken();
+  async submitFlow(file2, flowInfo) {
+    const url2 = new URL(`${this.config.baseUrl}/v1/flows`);
+    const authHeaders = await this.getAuthHeaders();
     const controller = new AbortController();
     const timeout = setTimeout(
       () => controller.abort(),
@@ -38863,67 +40888,68 @@ var IopoleClient = class {
     );
     try {
       const form = new FormData();
-      form.append("file", new Blob([file2]), filename);
-      const response = await fetch(url2, {
+      form.append("flowInfo", JSON.stringify(flowInfo));
+      form.append("file", new Blob([file2]), flowInfo.name ?? "invoice.xml");
+      const response = await fetch(url2.toString(), {
         method: "POST",
-        headers: {
-          Authorization: `Bearer ${token}`,
-          "customer-id": this.config.customerId,
-          Accept: "application/json"
-          // Do NOT set Content-Type — fetch sets it with the multipart boundary
-        },
+        headers: { ...authHeaders, Accept: "application/json" },
         body: form,
         signal: controller.signal
       });
       if (!response.ok) {
         const body = await response.text();
-        throw new IopoleAPIError(
-          `[IopoleClient] POST ${path} (upload) \u2192 ${response.status}: ${body.slice(0, 500)}`,
+        throw new AdapterAPIError(
+          "AFNOR",
+          `[AFNOR] POST /v1/flows \u2192 ${response.status}: ${body.slice(0, 500)}`,
           response.status,
           body
         );
       }
-      const contentType = response.headers.get("content-type") ?? "";
-      if (contentType.includes("application/json")) {
-        return await response.json();
-      }
-      return await response.text();
+      return await response.json();
     } finally {
       clearTimeout(timeout);
     }
   }
   /**
-   * POST with query parameters.
-   * Used for /tools/{cii,ubl,facturx}/generate which require `flavor` as query param.
+   * Search flows by criteria.
+   * POST /v1/flows/search
    */
-  async postWithQuery(path, body, query) {
-    return this.request("POST", path, { body, query });
+  async searchFlows(filters, limit) {
+    return await this.request("POST", "/v1/flows/search", {
+      body: {
+        where: filters,
+        ...limit ? { limit } : {}
+      }
+    });
   }
   /**
-   * Download a binary resource (invoice PDF, attachment, etc.)
-   * Returns the raw Response for streaming.
+   * Download a flow file.
+   * GET /v1/flows/{flowId}
    */
-  async download(path) {
-    const url2 = `${this.config.baseUrl}${path}`;
-    const token = await this.config.getToken();
+  async downloadFlow(flowId, docType) {
+    const query = docType ? { docType } : void 0;
+    const url2 = `${this.config.baseUrl}/v1/flows/${flowId}`;
+    const authHeaders = await this.getAuthHeaders();
     const controller = new AbortController();
     const timeout = setTimeout(
       () => controller.abort(),
       this.config.timeoutMs ?? 3e4
     );
     try {
-      const response = await fetch(url2, {
+      const fullUrl = new URL(url2);
+      if (query) {
+        for (const [k, v] of Object.entries(query)) fullUrl.searchParams.set(k, v);
+      }
+      const response = await fetch(fullUrl.toString(), {
         method: "GET",
-        headers: {
-          Authorization: `Bearer ${token}`,
-          "customer-id": this.config.customerId
-        },
+        headers: authHeaders,
         signal: controller.signal
       });
       if (!response.ok) {
         const body = await response.text();
-        throw new IopoleAPIError(
-          `[IopoleClient] GET ${path} \u2192 ${response.status}`,
+        throw new AdapterAPIError(
+          "AFNOR",
+          `[AFNOR] GET /v1/flows/${flowId} \u2192 ${response.status}`,
           response.status,
           body
         );
@@ -38935,191 +40961,473 @@ var IopoleClient = class {
       clearTimeout(timeout);
     }
   }
+  /**
+   * Health check — GET /v1/healthcheck
+   */
+  async healthcheck() {
+    try {
+      await this.request("GET", "/v1/healthcheck");
+      return true;
+    } catch {
+      return false;
+    }
+  }
 };
 
-// src/runtime.ts
-import { statSync as fsStatSync } from "node:fs";
-import { readFile as readFile2 } from "node:fs/promises";
-function env2(key) {
-  return process.env[key];
+// src/adapters/superpdp/client.ts
+var SuperPDPClient = class extends BaseHttpClient {
+  getToken;
+  constructor(config2) {
+    super("SuperPDP", { baseUrl: config2.baseUrl, timeoutMs: config2.timeoutMs });
+    this.getToken = config2.getToken;
+  }
+  async getAuthHeaders() {
+    const token = await this.getToken();
+    return { Authorization: `Bearer ${token}` };
+  }
+  /**
+   * Submit XML invoice content.
+   * Super PDP accepts raw XML body for invoice creation.
+   */
+  async postXml(path, xmlData, query) {
+    return this.request("POST", path, {
+      body: xmlData,
+      contentType: "application/xml",
+      query
+    });
+  }
+  /**
+   * Convert invoice format.
+   * POST /invoices/convert with body + from/to query params.
+   */
+  async convert(data, from, to) {
+    const contentType = from === "en16931" ? "application/json" : "application/xml";
+    return this.request("POST", "/invoices/convert", {
+      body: data,
+      contentType,
+      query: { from, to }
+    });
+  }
+};
+
+// src/adapters/superpdp/normalize.ts
+function toDecimal(v) {
+  if (v == null) return "0.00";
+  const n = typeof v === "string" ? parseFloat(v) : Number(v);
+  if (!Number.isFinite(n)) return "0.00";
+  return n.toFixed(2);
 }
-async function readTextFile2(path) {
-  return await readFile2(path, "utf-8");
+function setIfAbsent(obj, key, value) {
+  if (obj[key] == null && value != null) obj[key] = value;
 }
-function statSync(path) {
-  try {
-    fsStatSync(path);
-    return true;
-  } catch {
-    return false;
+function stripNulls(obj) {
+  const clean = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (v != null) clean[k] = v;
   }
+  return clean;
 }
-function getArgs() {
-  return process.argv.slice(2);
-}
-function exit(code) {
-  process.exit(code);
+var PARTY_SOURCE_FIELDS = ["country", "address", "siret", "siretNumber", "siren", "sirenNumber", "vatNumber", "vat_number", "vatId"];
+function normalizeParty(party, requireElectronicAddress) {
+  if (!party || typeof party !== "object") return party;
+  const p = { ...party };
+  if (!p.postal_address) {
+    if (p.address && typeof p.address === "object") {
+      p.postal_address = stripNulls({
+        country_code: p.address.country_code ?? p.address.country ?? p.country ?? "FR",
+        address_line1: p.address.street ?? p.address.address_line1 ?? p.address.line1,
+        city: p.address.city,
+        post_code: p.address.postal_code ?? p.address.post_code ?? p.address.zip
+      });
+    } else if (p.country) {
+      p.postal_address = { country_code: p.country };
+    }
+  }
+  if (!p.electronic_address && requireElectronicAddress) {
+    const siret = p.siret ?? p.siretNumber;
+    if (siret) {
+      p.electronic_address = { scheme: "0009", value: String(siret) };
+    }
+  }
+  if (!p.legal_registration_identifier) {
+    const siren = p.siren ?? p.sirenNumber;
+    const siret = p.siret ?? p.siretNumber;
+    const id = siren ?? siret;
+    if (id) {
+      p.legal_registration_identifier = { scheme: "0002", value: String(id) };
+    }
+  }
+  if (!p.vat_identifier) {
+    const vat = p.vatNumber ?? p.vat_number ?? p.vatId;
+    if (vat) p.vat_identifier = String(vat);
+  }
+  for (const f of PARTY_SOURCE_FIELDS) delete p[f];
+  return p;
 }
-function onSignal(signal, handler) {
-  process.on(signal, handler);
+var TOTALS_SOURCE_FIELDS = ["line_extension_amount", "lineTotalAmount", "tax_exclusive_amount", "taxBasisTotalAmount", "tax_inclusive_amount", "grandTotalAmount", "payableAmount"];
+function normalizeTotals(totals) {
+  if (!totals || typeof totals !== "object") return totals;
+  const t = { ...totals };
+  setIfAbsent(t, "sum_invoice_lines_amount", t.line_extension_amount ?? t.lineTotalAmount);
+  setIfAbsent(t, "total_without_vat", t.tax_exclusive_amount ?? t.taxBasisTotalAmount);
+  setIfAbsent(t, "total_with_vat", t.tax_inclusive_amount ?? t.grandTotalAmount);
+  setIfAbsent(t, "amount_due_for_payment", t.payableAmount);
+  for (const key of ["sum_invoice_lines_amount", "total_without_vat", "total_with_vat", "amount_due_for_payment"]) {
+    if (t[key] != null) t[key] = toDecimal(t[key]);
+  }
+  if (t.total_vat_amount != null && typeof t.total_vat_amount !== "object") {
+    t.total_vat_amount = { value: toDecimal(t.total_vat_amount) };
+  } else if (t.total_vat_amount?.value != null) {
+    t.total_vat_amount = { ...t.total_vat_amount, value: toDecimal(t.total_vat_amount.value) };
+  }
+  for (const f of TOTALS_SOURCE_FIELDS) delete t[f];
+  return t;
 }
-
-// src/adapters/iopole.ts
-var IOPOLE_DEFAULT_AUTH_URL = "https://auth.iopole.com/realms/iopole/protocol/openid-connect/token";
-var IopoleAdapter = class {
-  name = "iopole";
+var VAT_SOURCE_FIELDS = ["category_code", "categoryCode", "rate", "percent", "vat_rate", "taxable_amount", "taxableAmount", "tax_amount", "taxAmount"];
+function normalizeVatBreakdown(vat) {
+  if (!vat || typeof vat !== "object") return vat;
+  const v = { ...vat };
+  setIfAbsent(v, "vat_category_code", v.category_code ?? v.categoryCode);
+  setIfAbsent(v, "vat_category_rate", v.rate ?? v.percent ?? v.vat_rate);
+  setIfAbsent(v, "vat_category_taxable_amount", v.taxable_amount ?? v.taxableAmount);
+  setIfAbsent(v, "vat_category_tax_amount", v.tax_amount ?? v.taxAmount);
+  if (v.vat_category_rate != null) v.vat_category_rate = toDecimal(v.vat_category_rate);
+  if (v.vat_category_taxable_amount != null) v.vat_category_taxable_amount = toDecimal(v.vat_category_taxable_amount);
+  if (v.vat_category_tax_amount != null) v.vat_category_tax_amount = toDecimal(v.vat_category_tax_amount);
+  for (const f of VAT_SOURCE_FIELDS) delete v[f];
+  return v;
+}
+var LINE_SOURCE_FIELDS = ["id", "name", "item_name", "description", "quantity", "billed_quantity", "unit_code", "unitCode", "net_price", "price", "unit_price", "unitPrice", "line_amount", "line_total_amount", "line_net_amount", "amount", "totalAmount", "tax_category", "vat_category_code", "line_vat_category_code", "vatCategoryCode", "tax_percent", "vat_rate", "line_vat_rate", "vatRate"];
+function normalizeLine(line) {
+  if (!line || typeof line !== "object") return line;
+  const l = { ...line };
+  setIfAbsent(l, "identifier", l.id);
+  if (!l.item_information) {
+    const name = l.name ?? l.item_name ?? l.description;
+    if (name) l.item_information = { name: String(name) };
+  }
+  setIfAbsent(l, "invoiced_quantity", l.quantity ?? l.billed_quantity);
+  if (l.invoiced_quantity != null) l.invoiced_quantity = toDecimal(l.invoiced_quantity);
+  setIfAbsent(l, "invoiced_quantity_code", l.unit_code ?? l.unitCode ?? "C62");
+  if (!l.price_details) {
+    const price = l.net_price ?? l.price ?? l.unit_price ?? l.unitPrice;
+    if (price != null) l.price_details = { item_net_price: toDecimal(price) };
+  }
+  setIfAbsent(l, "net_amount", l.line_amount ?? l.line_total_amount ?? l.line_net_amount ?? l.amount ?? l.totalAmount);
+  if (l.net_amount != null) l.net_amount = toDecimal(l.net_amount);
+  if (!l.vat_information) {
+    const catCode = l.tax_category ?? l.vat_category_code ?? l.line_vat_category_code ?? l.vatCategoryCode;
+    const rate = l.tax_percent ?? l.vat_rate ?? l.line_vat_rate ?? l.vatRate;
+    if (catCode) {
+      l.vat_information = {
+        invoiced_item_vat_category_code: String(catCode),
+        ...rate != null ? { invoiced_item_vat_rate: toDecimal(rate) } : {}
+      };
+    }
+  }
+  for (const f of LINE_SOURCE_FIELDS) delete l[f];
+  return l;
+}
+var normalizeForSuperPDP = (inv) => {
+  const n = { ...inv };
+  if (!n.process_control) {
+    n.process_control = { specification_identifier: "urn:cen.eu:en16931:2017" };
+  }
+  if (!n.payment_due_date) {
+    const due = n.due_date ?? n.dueDate ?? n.invoiceDueDate;
+    if (due) n.payment_due_date = String(due);
+  }
+  for (const f of ["due_date", "dueDate", "invoiceDueDate"]) delete n[f];
+  const buyerSiret = n.buyer?.siret ?? n.buyer?.siretNumber;
+  if (n.seller) n.seller = normalizeParty(n.seller, true);
+  if (n.buyer) n.buyer = normalizeParty(n.buyer, false);
+  if (n.totals) n.totals = normalizeTotals(n.totals);
+  let vatSource;
+  if (Array.isArray(n.vat_break_down)) vatSource = n.vat_break_down;
+  else if (Array.isArray(n.taxDetails)) vatSource = n.taxDetails;
+  else if (Array.isArray(n.vatBreakdown)) vatSource = n.vatBreakdown;
+  if (vatSource) {
+    n.vat_break_down = vatSource.map(normalizeVatBreakdown);
+    delete n.taxDetails;
+    delete n.vatBreakdown;
+  }
+  if (Array.isArray(n.lines)) {
+    n.lines = n.lines.map(normalizeLine);
+  }
+  if (n.payment_instructions) {
+    const pi = { ...n.payment_instructions };
+    if (pi.credit_transfer && !pi.credit_transfers) {
+      pi.credit_transfers = Array.isArray(pi.credit_transfer) ? pi.credit_transfer : [pi.credit_transfer];
+      delete pi.credit_transfer;
+    }
+    if (Array.isArray(pi.credit_transfers)) {
+      pi.credit_transfers = pi.credit_transfers.map((ct) => {
+        if (ct?.payment_account_identifier?.scheme?.toUpperCase() === "IBAN") {
+          return { ...ct, payment_account_identifier: { ...ct.payment_account_identifier, scheme: "" } };
+        }
+        return ct;
+      });
+    }
+    n.payment_instructions = pi;
+  }
+  if (!n.delivery_information) {
+    n.delivery_information = { delivery_date: n.issue_date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10) };
+  }
+  if (!n.notes || !Array.isArray(n.notes)) n.notes = [];
+  const noteCodes = new Set(n.notes.map((note) => note?.subject_code));
+  if (!noteCodes.has("PMT")) {
+    n.notes.push({ note: "En cas de retard de paiement, indemnite forfaitaire de 40 euros pour frais de recouvrement (art. L441-10 C.com).", subject_code: "PMT" });
+  }
+  if (!noteCodes.has("PMD")) {
+    n.notes.push({ note: "Penalites de retard : 3 fois le taux d'interet legal (art. L441-10 C.com).", subject_code: "PMD" });
+  }
+  if (!noteCodes.has("AAB")) {
+    n.notes.push({ note: "Pas d'escompte pour paiement anticipe.", subject_code: "AAB" });
+  }
+  const buyerCountry = n.buyer?.postal_address?.country_code ?? n.buyer?.country;
+  if (n.buyer && !n.buyer.electronic_address && buyerCountry === "FR") {
+    const siret = buyerSiret ?? n.buyer.legal_registration_identifier?.value;
+    if (!siret) {
+      throw new Error("BR-FR-12: buyer.electronic_address is required for French buyers. Provide buyer.siret, buyer.electronic_address, or buyer.legal_registration_identifier.");
+    }
+    n.buyer.electronic_address = { scheme: "0009", value: siret };
+  }
+  return n;
+};
+
+// src/adapters/superpdp/adapter.ts
+var SuperPDPAdapter = class extends AfnorBaseAdapter {
+  name = "superpdp";
+  capabilities = /* @__PURE__ */ new Set([
+    // Native overrides
+    "emitInvoice",
+    "searchInvoices",
+    "getInvoice",
+    "downloadInvoice",
+    "generateCII",
+    "generateUBL",
+    "sendStatus",
+    "getStatusHistory",
+    "getCustomerId",
+    "getBusinessEntity",
+    "createOffice",
+    "enrollFrench",
+    "registerNetwork",
+    "registerNetworkByScheme",
+    "unregisterNetwork",
+    "createIdentifier",
+    "createIdentifierByScheme",
+    "deleteIdentifier",
+    "searchDirectoryFr",
+    // Inherited from AFNOR base
+    "reportInvoiceTransaction",
+    "reportTransaction"
+  ]);
   client;
-  constructor(client) {
+  constructor(client, afnor) {
+    super(afnor);
     this.client = client;
   }
-  // ─── Invoice Operations ───────────────────────────────
+  // ─── Invoice Operations (native) ──────────────────────
   async emitInvoice(req) {
-    return await this.client.upload("/invoice", req.file, req.filename);
+    return await this.client.postXml("/invoices", req.file, {
+      external_id: req.filename
+    });
   }
   async searchInvoices(filters) {
-    return await this.client.getV11("/invoice/search", {
-      q: filters.q,
-      expand: filters.expand,
-      offset: filters.offset ?? 0,
-      limit: filters.limit ?? 50
+    const direction = filters.direction === "received" ? "in" : filters.direction === "sent" ? "out" : filters.q === "in" || filters.q === "out" ? filters.q : void 0;
+    const raw2 = await this.client.get("/invoices", {
+      "expand[]": ["en_invoice", "events"],
+      ...direction ? { direction } : {},
+      ...filters.limit ? { limit: filters.limit } : {}
+      // Note: SuperPDP uses cursor-based pagination (starting_after_id),
+      // not offset-based. Offset is ignored — use last row ID for next page.
     });
+    const data = Array.isArray(raw2) ? raw2 : raw2?.data ?? [];
+    const rows = data.map((inv) => ({
+      id: String(inv.id ?? ""),
+      invoiceNumber: inv.en_invoice?.number ?? inv.external_id,
+      status: lastEventCode(inv.events),
+      direction: normalizeDirection(inv.direction),
+      senderName: inv.en_invoice?.seller?.name,
+      receiverName: inv.en_invoice?.buyer?.name,
+      date: inv.en_invoice?.issue_date,
+      amount: inv.en_invoice?.totals?.amount_due_for_payment,
+      currency: inv.en_invoice?.currency_code ?? "EUR"
+    }));
+    return { rows, count: raw2?.count ?? rows.length };
   }
   async getInvoice(id) {
-    return await this.client.get(`/invoice/${id}`, { expand: "businessData" });
+    const inv = await this.client.get(`/invoices/${encodePathSegment(id)}`);
+    const en = inv.en_invoice;
+    return {
+      id: String(inv.id ?? id),
+      invoiceNumber: en?.number ?? inv.external_id,
+      status: lastEventCode(inv.events),
+      direction: normalizeDirection(inv.direction),
+      senderName: en?.seller?.name,
+      receiverName: en?.buyer?.name,
+      issueDate: en?.issue_date,
+      dueDate: en?.due_date,
+      currency: en?.currency_code ?? "EUR",
+      totalHt: en?.totals?.tax_exclusive_amount,
+      totalTtc: en?.totals?.tax_inclusive_amount
+    };
   }
   async downloadInvoice(id) {
-    return await this.client.download(`/invoice/${id}/download`);
-  }
-  async downloadReadable(id) {
-    return await this.client.download(`/invoice/${id}/download/readable`);
-  }
-  async getInvoiceFiles(id) {
-    return await this.client.get(`/invoice/${id}/files`);
-  }
-  async getAttachments(id) {
-    return await this.client.get(`/invoice/${id}/files/attachments`);
-  }
-  async downloadFile(fileId) {
-    return await this.client.download(`/invoice/file/${fileId}/download`);
-  }
-  async markInvoiceSeen(id) {
-    return await this.client.put(`/invoice/${id}/markAsSeen`);
-  }
-  async getUnseenInvoices(pagination) {
-    return await this.client.get("/invoice/notSeen", {
-      offset: pagination.offset,
-      limit: pagination.limit
-    });
+    return await this.client.download(`/invoices/${encodePathSegment(id)}/download`);
   }
+  // ─── Format Conversion (native) ───────────────────────
   async generateCII(req) {
-    return await this.client.postWithQuery("/tools/cii/generate", req.invoice, {
-      flavor: req.flavor
-    });
+    const invoice = normalizeForSuperPDP(req.invoice);
+    const payload = new TextEncoder().encode(JSON.stringify(invoice));
+    return await this.client.convert(payload, "en16931", "cii");
   }
   async generateUBL(req) {
-    return await this.client.postWithQuery("/tools/ubl/generate", req.invoice, {
-      flavor: req.flavor
-    });
-  }
-  async generateFacturX(req) {
-    return await this.client.postWithQuery("/tools/facturx/generate", req.invoice, {
-      flavor: req.flavor,
-      language: req.language
-    });
-  }
-  // ─── Directory ────────────────────────────────────────
-  async searchDirectoryFr(filters) {
-    return await this.client.get("/directory/french", {
-      q: filters.q,
-      offset: filters.offset,
-      limit: filters.limit
-    });
-  }
-  async searchDirectoryInt(filters) {
-    return await this.client.get("/directory/international", {
-      value: filters.value,
-      offset: filters.offset,
-      limit: filters.limit
-    });
-  }
-  async checkPeppolParticipant(scheme, value) {
-    return await this.client.get(
-      `/directory/international/check/scheme/${scheme}/value/${value}`
-    );
+    const invoice = normalizeForSuperPDP(req.invoice);
+    const payload = new TextEncoder().encode(JSON.stringify(invoice));
+    return await this.client.convert(payload, "en16931", "ubl");
   }
-  // ─── Status ───────────────────────────────────────────
+  // ─── Status / Events (native) ─────────────────────────
   async sendStatus(req) {
-    return await this.client.post(`/invoice/${req.invoiceId}/status`, {
-      code: req.code,
-      message: req.message,
-      payment: req.payment
+    const details = [];
+    if (req.message) {
+      details.push({ reason: req.message });
+    }
+    if (req.payment) {
+      const amounts = Array.isArray(req.payment.amounts) ? req.payment.amounts : [req.payment];
+      details.push({ amounts });
+    }
+    return await this.client.post("/invoice_events", {
+      invoice_id: toInvoiceId(req.invoiceId),
+      status_code: req.code,
+      ...details.length > 0 ? { details } : {}
     });
   }
   async getStatusHistory(invoiceId) {
-    return await this.client.get(`/invoice/${invoiceId}/status-history`);
-  }
-  async getUnseenStatuses(pagination) {
-    return await this.client.get("/invoice/status/notSeen", {
-      offset: pagination.offset,
-      limit: pagination.limit
+    const raw2 = await this.client.get("/invoice_events", {
+      invoice_id: invoiceId
     });
+    const data = Array.isArray(raw2) ? raw2 : raw2?.data ?? [];
+    return {
+      // deno-lint-ignore no-explicit-any
+      entries: data.map((e) => ({
+        date: e.created_at ?? e.date ?? "",
+        code: e.status_code ?? e.code ?? "",
+        message: e.message
+      }))
+    };
+  }
+  // ─── Reporting (AFNOR — inherited) ────────────────────
+  // reportInvoiceTransaction → AfnorBaseAdapter.submitFlow (FRR)
+  // reportTransaction → AfnorBaseAdapter.submitFlow (FRR)
+  // ─── Directory (native) ───────────────────────────────
+  async searchDirectoryFr(_filters) {
+    const raw2 = await this.client.get("/directory_entries");
+    const data = Array.isArray(raw2) ? raw2 : raw2?.data ?? [];
+    const rows = data.map((entry) => ({
+      entityId: String(entry.id ?? ""),
+      name: entry.company?.formal_name ?? entry.company?.trade_name ?? entry.name,
+      siret: entry.identifier,
+      country: entry.company?.country ?? "FR",
+      directory: entry.directory,
+      status: entry.status,
+      createdAt: entry.created_at
+    }));
+    return { rows, count: rows.length };
   }
-  async markStatusSeen(statusId) {
-    return await this.client.put(`/invoice/status/${statusId}/markAsSeen`);
-  }
-  // ─── Reporting ────────────────────────────────────────
-  async reportInvoiceTransaction(transaction) {
-    return await this.client.post("/reporting/fr/invoice/transaction", transaction);
-  }
-  async reportTransaction(businessEntityId, transaction) {
-    return await this.client.post(`/reporting/fr/transaction/${businessEntityId}`, transaction);
+  // ─── Operator Config (native) ─────────────────────────
+  async getCustomerId() {
+    return await this.client.get("/companies/me");
   }
-  // ─── Webhooks ─────────────────────────────────────────
-  async listWebhooks() {
-    return await this.client.get("/config/webhook");
+  async getBusinessEntity(_id) {
+    return await this.client.get("/companies/me");
   }
-  async getWebhook(id) {
-    return await this.client.get(`/config/webhook/${id}`);
+  async createOffice(data) {
+    return await this.client.post("/directory_entries", data);
   }
-  async createWebhook(req) {
-    return await this.client.post("/config/webhook", req);
+  async enrollFrench(data) {
+    return await this.client.post("/directory_entries", data);
   }
-  async updateWebhook(id, req) {
-    return await this.client.put(`/config/webhook/${id}`, req);
+  async registerNetwork(identifierId, network) {
+    return await this.client.post("/directory_entries", {
+      directory: mapNetworkToDirectory(network),
+      identifier: identifierId
+    });
   }
-  async deleteWebhook(id) {
-    return await this.client.delete(`/config/webhook/${id}`);
+  async registerNetworkByScheme(scheme, value, network) {
+    return await this.client.post("/directory_entries", {
+      directory: mapNetworkToDirectory(network),
+      identifier: `${scheme}:${value}`
+    });
   }
-};
-function createIopoleAdapter() {
-  const baseUrl = env2("IOPOLE_API_URL");
-  const clientId = env2("IOPOLE_CLIENT_ID");
-  const clientSecret = env2("IOPOLE_CLIENT_SECRET");
-  const customerId = env2("IOPOLE_CUSTOMER_ID");
-  const authUrl = env2("IOPOLE_AUTH_URL") || IOPOLE_DEFAULT_AUTH_URL;
-  if (!baseUrl) {
-    throw new Error(
-      "[IopoleAdapter] IOPOLE_API_URL is required. Set it to https://api.ppd.iopole.fr/v1 (sandbox) or https://api.iopole.com/v1 (production)."
-    );
+  async unregisterNetwork(directoryId) {
+    return await this.client.delete(`/directory_entries/${encodePathSegment(directoryId)}`);
   }
-  if (!clientId) {
-    throw new Error(
-      "[IopoleAdapter] IOPOLE_CLIENT_ID is required. Get your client ID from the Iopole dashboard or admin console."
-    );
+  // ─── Identifier Management (native via directory) ─────
+  async createIdentifier(_entityId, data) {
+    return await this.client.post("/directory_entries", {
+      directory: data.directory ?? "ppf",
+      identifier: data.identifier
+    });
   }
-  if (!clientSecret) {
-    throw new Error(
-      "[IopoleAdapter] IOPOLE_CLIENT_SECRET is required. Get your client secret from the Iopole dashboard or admin console."
-    );
+  async createIdentifierByScheme(scheme, value, data) {
+    return await this.client.post("/directory_entries", {
+      directory: data.directory ?? "ppf",
+      identifier: `${scheme}:${value}`
+    });
   }
-  if (!customerId) {
-    throw new Error(
-      "[IopoleAdapter] IOPOLE_CUSTOMER_ID is required (since 2026-02-01). Find it in Settings \u2192 Unique Identifier (sandbox) or admin console."
-    );
+  async deleteIdentifier(identifierId) {
+    return await this.client.delete(`/directory_entries/${encodePathSegment(identifierId)}`);
+  }
+  // ─── Stubs (21 methods — inherited from AfnorBaseAdapter) ─
+  // downloadReadable, getInvoiceFiles, getAttachments, downloadFile,
+  // markInvoiceSeen, getUnseenInvoices, getUnseenStatuses, markStatusSeen,
+  // listWebhooks, getWebhook, createWebhook, updateWebhook, deleteWebhook,
+  // listBusinessEntities, createLegalUnit, deleteBusinessEntity,
+  // configureBusinessEntity, claimBusinessEntity, claimBusinessEntityByIdentifier,
+  // enrollInternational, searchDirectoryInt, checkPeppolParticipant, deleteClaim
+};
+function lastEventCode(events) {
+  if (!events?.length) return void 0;
+  return events[events.length - 1].status_code;
+}
+function mapNetworkToDirectory(network) {
+  if (network === "DOMESTIC_FR" || network === "ppf") return "ppf";
+  if (network === "PEPPOL_INTERNATIONAL" || network === "peppol") return "peppol";
+  throw new Error(
+    `[SuperPDP] Unknown network "${network}". Supported: "DOMESTIC_FR"/"ppf", "PEPPOL_INTERNATIONAL"/"peppol".`
+  );
+}
+function toInvoiceId(id) {
+  const n = Number(id);
+  if (!Number.isFinite(n)) {
+    throw new Error(`[SuperPDP] invoice_id must be numeric, got "${id}".`);
   }
+  return n;
+}
+function createSuperPDPAdapter() {
+  const baseUrl = requireEnv(
+    "SuperPDPAdapter",
+    "SUPERPDP_API_URL",
+    "Set it to https://api.superpdp.tech/v1.beta"
+  );
+  const clientId = requireEnv(
+    "SuperPDPAdapter",
+    "SUPERPDP_CLIENT_ID",
+    "Get your client ID from the Super PDP dashboard."
+  );
+  const clientSecret = requireEnv(
+    "SuperPDPAdapter",
+    "SUPERPDP_CLIENT_SECRET",
+    "Get your client secret from the Super PDP dashboard."
+  );
+  const authUrl = env2("SUPERPDP_AUTH_URL") || "https://api.superpdp.tech/oauth2/token";
+  const afnorUrl = env2("SUPERPDP_AFNOR_URL") || "https://api.superpdp.tech/afnor-flow";
   const getToken = createOAuth2TokenProvider({ authUrl, clientId, clientSecret });
-  const client = new IopoleClient({ baseUrl, customerId, getToken });
-  return new IopoleAdapter(client);
+  const client = new SuperPDPClient({ baseUrl, getToken });
+  const afnor = new AfnorClient({ baseUrl: afnorUrl, getToken });
+  return new SuperPDPAdapter(client, afnor);
 }
 
 // server.ts
@@ -39129,14 +41437,22 @@ function createAdapter(adapterName) {
   switch (adapterName) {
     case "iopole":
       return createIopoleAdapter();
+    case "storecove":
+      return createStorecoveAdapter();
+    case "superpdp":
+      return createSuperPDPAdapter();
     default:
       throw new Error(
-        `${LOG_PREFIX} Unknown adapter: "${adapterName}". Available adapters: iopole`
+        `${LOG_PREFIX} Unknown adapter: "${adapterName}". Available adapters: iopole, storecove, superpdp`
       );
   }
 }
 async function main() {
   const args = getArgs();
+  if (args.includes("--inspect")) {
+    await launchInspector("deno", ["run", "--allow-all", import.meta.filename]);
+    return;
+  }
   const adapterArg = args.find((arg) => arg.startsWith("--adapter="));
   const adapterName = adapterArg ? adapterArg.split("=")[1] : env2("EINVOICE_ADAPTER") || "iopole";
   const categoriesArg = args.find((arg) => arg.startsWith("--categories="));
@@ -39145,26 +41461,27 @@ async function main() {
   const portArg = args.find((arg) => arg.startsWith("--port="));
   const httpPort = portArg ? parseInt(portArg.split("=")[1], 10) : DEFAULT_HTTP_PORT;
   const hostnameArg = args.find((arg) => arg.startsWith("--hostname="));
-  const hostname3 = hostnameArg ? hostnameArg.split("=")[1] : "0.0.0.0";
+  const hostname3 = hostnameArg ? hostnameArg.split("=")[1] : "localhost";
   const adapter = createAdapter(adapterName);
   const toolsClient = new EInvoiceToolsClient(
     categories ? { categories } : void 0
   );
   const server = new ConcurrentMCPServer({
     name: "mcp-einvoice",
-    version: "0.1.0",
+    version: "0.1.1",
     maxConcurrent: 10,
     backpressureStrategy: "queue",
     validateSchema: true,
+    toolErrorMapper: einvoiceErrorMapper,
     logger: (msg) => console.error(`${LOG_PREFIX} ${msg}`)
   });
-  const mcpTools = toolsClient.toMCPFormat();
+  const mcpTools = toolsClient.toMCPFormat(adapter);
   const handlers = toolsClient.buildHandlersMap(adapter);
   server.registerTools(mcpTools, handlers);
   server.registerViewers({
     prefix: "mcp-einvoice",
     moduleUrl: import.meta.url,
-    viewers: ["invoice-viewer", "doclist-viewer", "status-timeline", "directory-card"],
+    viewers: ["invoice-viewer", "doclist-viewer", "status-timeline", "directory-card", "directory-list", "action-result"],
     exists: statSync,
     readFile: readTextFile2
   });