opedd-mcp 0.10.0 → 0.11.0

package/README.md

@@ -95,7 +95,7 @@ Exposes up to 19 tools to any AI assistant (some are conditional on env vars):
 | `verify_license` | Verify a license key — returns validity, article, publisher, blockchain proof |
 | `browse_registry` | Browse the public Opedd registry — lists issued LICENSES (use `publisher_directory` to browse publishers themselves) |
 | `publisher_directory` | Browse the public Opedd publisher catalog — paginated publishers with article counts + pricing + sample articles (primary buyer-discovery surface for AI labs) |
-| `place_licence_order` | Place a licence order for one or more publishers: AI answers (`monthly` full text, or `metered` pay-per-request snippets ≤300 words / 25%), AI training (`one_time`, back catalogue), client display (`monthly` × end clients). Each publisher is its own Schedule at its own price; returns the order, lines, `unavailable` publishers and `hosted_invoice_url`. Needs `OPEDD_BUYER_JWT` and `terms_accepted: true` |
+| `place_licence_order` | Place a licence order for one or more publishers: AI answers (`monthly` full text, or `metered` pay-per-request snippets ≤300 words / 25%), Full catalogue (`archive`, `one_time`: everything published up to the order date, kept permanently, no AI training), AI training (`one_time`, back catalogue), client display (`monthly` × end clients). Optional `include_archive: true` on a monthly AI answers order adds each publisher's Full catalogue for complete access. Each publisher is its own Schedule at its own price; returns the order, lines, `unavailable` publishers and `hosted_invoice_url`. Needs `OPEDD_BUYER_JWT` and `terms_accepted: true` |
 | `rsl_get` | Fetch a publisher's RSL Standard manifest — public discovery surface; `jsonld: true` returns CDSM Article 4(3) signed receipt (Phase 12 W1.1) |
 | `detect_platform` | Detect the content platform behind a URL — returns suggested onboarding workflow for Substack / Beehiiv / Ghost / Medium / Brevo / custom (Phase 12 W3.1) |
 

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { type Tool } from "@modelcontextprotocol/sdk/types.js";
-export declare const CURRENT_MSA_VERSION = "master-services-agreement-2026-07-22b";
 export interface Credentials {
     apiBase: string;
     buyerEmail?: string;

package/dist/index.js

@@ -6,11 +6,19 @@ import { pathToFileURL } from "node:url";
 import { initTelemetry, captureToolCall, shutdownTelemetry } from "./telemetry.js";
 import { SERVER_VERSION } from "./version.js";
 // ─── Configuration ────────────────────────────────────────────────────────────
-// Current Opedd Master Services Agreement version label. MUST match
-// opedd-backend supabase/functions/_shared/msa-version.ts CURRENT_MSA_VERSION
-// (the backend rejects superseded labels). On an MSA version bump, update this
-// constant and cut a new package release.
-export const CURRENT_MSA_VERSION = "master-services-agreement-2026-07-22b";
+// The Buyer Master Agreement label is read from the API when an order is
+// placed (GET /api?action=trust_facts -> agreements.enterprise_msa_current),
+// never pinned here: a pinned label went stale when the agreement was
+// republished, and the API refuses any label that is not the current one
+// (409 NOT_CURRENT_VERSION), so every place_licence_order from 0.10.0 failed.
+async function currentTermsVersion(creds) {
+    const facts = (await opeddFetch(creds, "/api?action=trust_facts"));
+    const label = facts?.data?.agreements?.enterprise_msa_current;
+    if (typeof label !== "string" || !label) {
+        throw new Error("Could not read the current Buyer Master Agreement from the API");
+    }
+    return label;
+}
 export function envCredentials() {
     return {
         apiBase: process.env.OPEDD_API_URL ?? "https://api.opedd.com",
@@ -376,19 +384,28 @@ function buildTools(has) {
             description: "Place a licence order with Opedd for one or more publishers. One order = one licence and one billing mode; " +
                 "each publisher becomes its own Schedule priced from that publisher's settings (publishers that do not offer it are " +
                 "returned in `unavailable` and never charged). Licences: 'enterprise' (AI answers: 'monthly' full text per article, or " +
-                "'metered' pay-per-request snippets of up to 300 words or 25% of the article), 'training' (AI training of the back " +
-                "catalogue up to the order date: 'one_time', bulk export via stream_feed_ndjson), 'display' (client display: 'monthly', " +
-                "quantity = number of end clients). Returns the order, its lines, the access key (works once paid) and " +
+                "'metered' pay-per-request snippets of up to 300 words or 25% of the article), 'archive' (Full catalogue: everything " +
+                "the publisher published up to the order date, kept permanently, not for AI training: 'one_time', full text in the feed), " +
+                "'training' (AI training of the back catalogue up to the order date: 'one_time', bulk export via stream_feed_ndjson), " +
+                "'display' (client display: 'monthly', quantity = number of end clients). A monthly AI answers subscription only covers " +
+                "articles published from the day it starts; set include_archive=true on a 'enterprise' + 'monthly' order to add each " +
+                "publisher's Full catalogue in the same order (complete access). Returns the order, its lines, the access key (works once paid) and " +
                 "hosted_invoice_url — the buyer (your principal) pays there. Requires a buyer session (OPEDD_BUYER_JWT) and " +
                 "terms_accepted=true after the buyer has accepted the Opedd Master Services Agreement (opedd.com/terms).",
             inputSchema: {
                 type: "object",
                 required: ["licence", "billing_mode", "publisher_ids", "terms_accepted"],
                 properties: {
-                    licence: { type: "string", enum: ["enterprise", "training", "display"], description: "enterprise = AI answers, training = AI training, display = client display" },
-                    billing_mode: { type: "string", enum: ["monthly", "metered", "one_time"], description: "enterprise: monthly | metered; training: one_time; display: monthly" },
+                    licence: { type: "string", enum: ["enterprise", "archive", "training", "display"], description: "enterprise = AI answers, archive = Full catalogue (everything published up to the order date, kept permanently, no AI training), training = AI training, display = client display" },
+                    billing_mode: { type: "string", enum: ["monthly", "metered", "one_time"], description: "enterprise: monthly | metered; archive: one_time; training: one_time; display: monthly" },
                     publisher_ids: { type: "array", items: { type: "string" }, description: "Publisher UUIDs (1-500; at most 18 for metered)" },
                     quantity: { type: "number", description: "display only: number of end clients (1-500)" },
+                    include_archive: {
+                        type: "boolean",
+                        description: "Optional, monthly AI answers only (licence 'enterprise' + billing_mode 'monthly'). true adds each publisher's " +
+                            "Full catalogue to the same order: everything published before the order date, kept permanently, not for AI training. " +
+                            "Publishers that do not sell their Full catalogue are returned in `unavailable`.",
+                    },
                     terms_accepted: {
                         type: "boolean",
                         description: "REQUIRED. Set true only after the buyer has accepted the Opedd Master Services Agreement at opedd.com/terms. " +
@@ -951,14 +968,24 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                 if (!creds.buyerJwt) {
                     return credErr("A buyer session is required to place an order", "OPEDD_BUYER_JWT", HOW_BUYER_JWT);
                 }
-                const { licence, billing_mode, publisher_ids, quantity, terms_accepted } = args;
+                const { licence, billing_mode, publisher_ids, quantity, include_archive, terms_accepted } = args;
                 if (!licence || !billing_mode)
                     return err("licence and billing_mode are required");
+                if (include_archive !== undefined && typeof include_archive !== "boolean") {
+                    return err("include_archive must be true or false");
+                }
+                // Same rule and wording as the API (opedd-backend
+                // _shared/licence-order-lines.ts parseOrderRequest): the Full catalogue
+                // is what a monthly AI answers subscription leaves out.
+                if (include_archive === true && !(licence === "enterprise" && billing_mode === "monthly")) {
+                    return err("include_archive applies only to a monthly AI answers licence");
+                }
                 if (!Array.isArray(publisher_ids) || publisher_ids.length === 0)
                     return err("publisher_ids must be a non-empty array");
                 if (terms_accepted !== true) {
-                    return err("terms_accepted must be true — confirm with the buyer that they accept the Opedd Master Services Agreement (opedd.com/terms) before ordering.");
+                    return err("terms_accepted must be true — confirm with the buyer that they accept the Opedd Buyer Master Agreement and the Standard Licence Terms (opedd.com/licence-terms) before ordering.");
                 }
+                const termsVersion = await currentTermsVersion(creds);
                 const data = await opeddFetch(creds, "/enterprise-license", {
                     method: "POST",
                     headers: { Authorization: `Bearer ${creds.buyerJwt}` },
@@ -967,10 +994,10 @@ export async function dispatchTool(name, args, creds = ENV_CREDS) {
                         billing_mode,
                         publisher_ids,
                         ...(quantity !== undefined ? { quantity } : {}),
+                        ...(include_archive === true ? { include_archive: true } : {}),
                         // Genuine assent moment: the agent asserted terms_accepted=true just
-                        // now. On an MSA version bump this constant must be updated (new
-                        // package release) to match opedd-backend _shared/msa-version.ts.
-                        terms_version: CURRENT_MSA_VERSION,
+                        // now, for the agreement currently in force.
+                        terms_version: termsVersion,
                     }),
                 });
                 return ok(data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opedd-mcp",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Licensed, rights-cleared content for AI agents — verifiable license keys, on-chain proof, and EU AI Act attestation. The MCP alternative to unlicensed scraping for RAG and AI search.",
   "type": "module",
   "main": "dist/index.js",