wiki-formant 0.9.4 → 0.11.0

package/dist/x402.js

@@ -0,0 +1,224 @@
+// x402.ts — per-call payment gating for an MCP envelope.
+//
+// THE LEAK THIS CLOSES. Paywalling a bulk HTTP export while the MCP tool that
+// returns the same bytes stays free reroutes a scraper one endpoint over. A
+// price one surface honours and its twin does not is not a price.
+//
+// WHY NOT AN HTTP 402 ON THE MCP ROUTE. One status covers one POST, and an MCP
+// server accepts batches — a batch of [search, get_catalogue, create_checkout]
+// would have to 402 all three or bill none. A blanket 402 would also block the
+// free tools that share the URL. And no MCP client would understand it: a
+// non-2xx from the transport reads as "server error", which is why the x402
+// Foundation's own MCP integration does not use HTTP 402 either.
+//
+// SO PAYMENT TRAVELS IN-BAND, in the JSON-RPC envelope, in the places @x402/mcp
+// puts it:
+//
+//   client -> server            params._meta["x402/payment"]        PaymentPayload
+//   unpaid tool   -> client     tool result, isError + structuredContent
+//   unpaid resource -> client   JSON-RPC error -32042, data: PaymentRequired
+//   paid -> client              result._meta["x402/payment-response"]  SettleResponse
+//
+// (resources/read has no isError result shape, hence the two forms.)
+//
+// WHY THIS IS ITS OWN SUBPATH, AND WHY IT IMPORTS NOTHING.
+// `wiki-formant` has no runtime dependencies and no framework peer, and x402 is
+// a stack of them — @x402/core, @x402/evm, @x402/extensions and viem behind
+// those. They are declared here as OPTIONAL peers, because a caller genuinely
+// cannot build an `x402ResourceServer` without them, and a wiki that never
+// imports `wiki-formant/x402` never resolves, installs or loads any of it.
+//
+// But this file imports none of them either. The resource server arrives as a
+// PORT, for the same reason the Prisma delegates in `rola.ts` do: the caller
+// already holds a configured one, its construction is deployment policy (which
+// chain, which facilitator, whose gas key, whose money), and typing it
+// structurally is what keeps a viem-sized dependency tree out of a package
+// three other wikis install. `declareDiscoveryExtension` arrives the same way,
+// so the lazy `import()` that keeps it off the free path stays lazy and stays
+// the caller's.
+//
+// WHAT STAYS WITH THE CALLER, deliberately: which surfaces cost what, the
+// prices, the terms text, the service name and the sentence that tells an agent
+// how to pay. Those are policy. What is here is the envelope surgery —
+// verify before dispatch, settle only after a non-error answer, splice the
+// challenges back into the caller's original order — which is the part that is
+// the same wherever it is written and the part that is easy to get subtly
+// wrong.
+/** Structural check only — `verifyPayment` does the real one, as @x402/mcp does. */
+function metaPayment(req) {
+    const meta = (req.params ?? {})._meta;
+    const payment = meta?.['x402/payment'];
+    return payment && typeof payment === 'object' && 'x402Version' in payment && 'payload' in payment
+        ? payment
+        : null;
+}
+const passthrough = (body) => ({
+    body: body,
+    empty: false,
+    finish: async (r) => r,
+});
+/**
+ * Verify payment for every paid entry, withhold the unpaid ones, and return a
+ * `finish` that reassembles the response.
+ *
+ * The ordering mirrors `withX402`: verify BEFORE dispatch, settle only AFTER
+ * the handler produced something that is not an error. A tool that raises
+ * cancels rather than settles — the caller pays for an answer, not an attempt.
+ */
+export async function gatePaidCalls(raw, options) {
+    const { resolve, network, payTo, maxTimeoutSeconds, serviceName, tags, maxBatch } = options;
+    if (options.enabled === false)
+        return passthrough(raw);
+    const isBatch = Array.isArray(raw);
+    const entries = (isBatch ? raw : [raw]);
+    // Malformed or oversized bodies go straight through: handleMcp owns those
+    // errors and says them better. The batch cap especially — it is enforced
+    // downstream, after this function would have removed entries, so a 500-entry
+    // batch must not be allowed to shrink past it here.
+    if (!entries.length || entries.length > maxBatch)
+        return passthrough(raw);
+    if (entries.some(e => !e || typeof e !== 'object'))
+        return passthrough(raw);
+    const targets = entries
+        .map((entry, index) => ({ entry, index, spec: resolve(entry) }))
+        .filter((t) => t.spec !== null);
+    // The overwhelmingly common case: nothing paid in this envelope, so the
+    // facilitator is never contacted and the free surface pays no latency for
+    // the existence of the paid one.
+    if (!targets.length)
+        return passthrough(raw);
+    const blocked = new Map();
+    const settlers = new Map();
+    /** A withheld entry, in whichever form this method can carry. */
+    const refuse = (entry, kind, message, data) => kind === 'tool'
+        ? {
+            jsonrpc: '2.0',
+            id: entry.id,
+            result: {
+                content: [{ type: 'text', text: JSON.stringify(data ?? { error: message }) }],
+                ...(data ? { structuredContent: data } : {}),
+                isError: true,
+            },
+        }
+        : { jsonrpc: '2.0', id: entry.id, error: { code: -32042, message, data } };
+    // An unreachable facilitator THROWS out of initialize() rather than returning
+    // anything. Uncaught here it would 500 the entire POST — taking down the free
+    // tools in the same batch, which is precisely the blast radius this per-entry
+    // design exists to avoid. Withhold only the paid entries and let everything
+    // else through.
+    let server;
+    try {
+        server = await options.server();
+    }
+    catch {
+        for (const { entry, index, spec } of targets) {
+            blocked.set(index, refuse(entry, spec.kind, 'Payment verification is temporarily unavailable. Retry shortly.'));
+        }
+        return finishWith(entries, isBatch, blocked, new Map());
+    }
+    for (const { entry, index, spec } of targets) {
+        const accepts = await server.buildPaymentRequirements({
+            scheme: 'exact',
+            network,
+            payTo,
+            price: spec.price,
+            maxTimeoutSeconds,
+        });
+        // The full PaymentRequired object, in whichever envelope slot this method
+        // has: a tool result can carry structuredContent, resources/read cannot.
+        const extensions = spec.discovery && options.declareDiscovery
+            ? await options.declareDiscovery(spec.discovery)
+            : undefined;
+        const challenge = async (error, payload) => refuse(entry, spec.kind, error, await server.createPaymentRequiredResponse(accepts, {
+            url: spec.resource,
+            description: spec.description,
+            mimeType: spec.mimeType,
+            serviceName,
+            tags,
+        }, error, extensions, spec.context, payload));
+        const payload = metaPayment(entry);
+        if (!payload) {
+            blocked.set(index, await challenge(spec.unpaidMessage));
+            continue;
+        }
+        const requirements = server.findMatchingRequirements(accepts, payload);
+        if (!requirements) {
+            blocked.set(index, await challenge('No matching payment requirements found.', payload));
+            continue;
+        }
+        const verify = await server.verifyPayment(payload, requirements, extensions, spec.context);
+        if (!verify.isValid) {
+            blocked.set(index, await challenge(verify.invalidReason || 'Payment verification failed.', payload));
+            continue;
+        }
+        settlers.set(index, () => server.settlePayment(payload, requirements, extensions, spec.context));
+    }
+    return finishWith(entries, isBatch, blocked, settlers);
+}
+/**
+ * Assemble the Gate: what to dispatch, and how to put the answer back together.
+ *
+ * Shared by the normal path and the facilitator-unreachable one, which differ
+ * only in whether anything is left to settle.
+ */
+function finishWith(entries, isBatch, blocked, settlers) {
+    const kept = entries.filter((_, i) => !blocked.has(i));
+    const failedResult = (id, message) => ({
+        jsonrpc: '2.0',
+        id,
+        result: { content: [{ type: 'text', text: JSON.stringify({ error: message }) }], isError: true },
+    });
+    return {
+        body: isBatch ? kept : kept[0],
+        empty: kept.length === 0,
+        async finish(dispatched) {
+            // handleMcp returns a bare object for a single request and an array for a
+            // batch, and drops notification entries — so positions do not survive it.
+            // Rejoin on the JSON-RPC id, the only stable handle either side has.
+            //
+            // Its one hazard, stated rather than hidden: a batch that repeats an id
+            // collapses onto one entry here, so the duplicates lose their answers.
+            // That envelope is malformed under JSON-RPC 2.0 and no client sends it,
+            // but it is the reason the obvious "pass a per-call context to handlers
+            // and rejoin by position" refactor is not the improvement it looks like:
+            // McpTool.handler is (args) => Promise<unknown> and widening it cannot
+            // carry a settlement receipt back out, so the rejoin would still be here.
+            const answers = dispatched == null ? [] : Array.isArray(dispatched) ? dispatched : [dispatched];
+            const byId = new Map(answers.map(a => [a.id, a]));
+            await Promise.all([...settlers].map(async ([index, settle]) => {
+                const id = entries[index].id;
+                const answer = byId.get(id);
+                // No answer, a JSON-RPC error, or a handler that raised: the caller is
+                // not getting the data, so nothing is charged for it.
+                const failed = !answer
+                    || 'error' in answer
+                    || answer.result?.isError === true;
+                if (failed)
+                    return;
+                try {
+                    const receipt = await settle();
+                    if (receipt.success === false) {
+                        // Settlement failed after the handler ran. The bytes exist but must
+                        // not ship — nobody was charged for them.
+                        byId.set(id, failedResult(id, 'Payment settlement failed.'));
+                        return;
+                    }
+                    const result = answer.result;
+                    result._meta = { ...result._meta, 'x402/payment-response': receipt };
+                }
+                catch {
+                    // Facilitator unreachable at settle time. Fail CLOSED: withholding a
+                    // bulk export costs a retry, and handing one over uncharged is what a
+                    // scraper waits for.
+                    byId.set(id, failedResult(id, 'Payment settlement is temporarily unavailable. Retry shortly.'));
+                }
+            }));
+            // Rebuild in the caller's original order, challenges spliced back in.
+            const merged = entries
+                .map((e, i) => blocked.get(i) ?? byId.get(e.id))
+                .filter(Boolean);
+            return isBatch ? merged : (merged[0] ?? null);
+        },
+    };
+}
+//# sourceMappingURL=x402.js.map

package/dist/x402.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.js","sourceRoot":"","sources":["../src/x402.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wiki-formant",
-  "version": "0.9.4",
-  "description": "The portable half of a wiki: derived taxonomy with pressable facet controls, a spec-correct MCP transport, markdown twins, block rendering, link normalisation, freshness, rate limiting, a collapsible sidebar, typeahead and hover-preview hooks, editor nodes, server-side analytics for both the agent and human lanes, and the conditional-GET plumbing agent surfaces need.",
+  "version": "0.11.0",
+  "description": "The portable half of a wiki: derived taxonomy with pressable facet controls, a spec-correct MCP transport, markdown twins, block rendering, link normalisation, freshness, rate limiting, a collapsible rail and a server-rendered facet bar and breadcrumb trail, typeahead and hover-preview hooks, editor nodes, x402 payment gating for an MCP envelope, server-side analytics for both the agent and human lanes, a dead-className check as a bin, and the conditional-GET plumbing agent surfaces need.",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -24,7 +24,9 @@
     "facets-ui",
     "typeahead",
     "search-analytics",
-    "tiptap"
+    "tiptap",
+    "x402",
+    "breadcrumbs"
   ],
   "sideEffects": false,
   "exports": {
@@ -128,6 +130,10 @@
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js"
     },
+    "./react-server": {
+      "types": "./dist/react-server.d.ts",
+      "import": "./dist/react-server.js"
+    },
     "./dom": {
       "types": "./dist/dom.d.ts",
       "import": "./dist/dom.js"
@@ -135,10 +141,22 @@
     "./tiptap": {
       "types": "./dist/tiptap.d.ts",
       "import": "./dist/tiptap.js"
+    },
+    "./rola": {
+      "types": "./dist/rola.d.ts",
+      "import": "./dist/rola.js"
+    },
+    "./x402": {
+      "types": "./dist/x402.d.ts",
+      "import": "./dist/x402.js"
     }
   },
+  "bin": {
+    "check-classes": "./bin/check-classes.mjs"
+  },
   "files": [
-    "dist"
+    "dist",
+    "bin"
   ],
   "engines": {
     "node": ">=20"
@@ -149,6 +167,7 @@
     "prepublishOnly": "npm run build && node --test 'test/*.test.js'"
   },
   "devDependencies": {
+    "@radixdlt/rola": "^2.1.0",
     "@tiptap/core": "^2.10.0",
     "@tiptap/extension-code-block": "^2.10.0",
     "@tiptap/extension-youtube": "^2.10.0",
@@ -156,15 +175,23 @@
     "@tiptap/react": "^2.10.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
+    "jose": "^6.2.10",
     "react": "^19.2.4",
     "typescript": "^5.9.0"
   },
   "peerDependencies": {
-    "react": ">=18",
     "@tiptap/core": ">=2.10",
-    "@tiptap/react": ">=2.10",
+    "@tiptap/extension-code-block": ">=2.10",
     "@tiptap/extension-youtube": ">=2.10",
-    "@tiptap/extension-code-block": ">=2.10"
+    "@tiptap/react": ">=2.10",
+    "react": ">=18",
+    "jose": ">=5",
+    "@radixdlt/rola": ">=2",
+    "@x402/core": "*",
+    "@x402/evm": "*",
+    "@x402/next": "*",
+    "@x402/extensions": "*",
+    "viem": "*"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -181,6 +208,27 @@
     },
     "@tiptap/extension-code-block": {
       "optional": true
+    },
+    "jose": {
+      "optional": true
+    },
+    "@radixdlt/rola": {
+      "optional": true
+    },
+    "@x402/core": {
+      "optional": true
+    },
+    "@x402/evm": {
+      "optional": true
+    },
+    "@x402/next": {
+      "optional": true
+    },
+    "@x402/extensions": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
     }
   }
 }