z-zero-mcp-server 1.1.2 → 1.2.0

package/README.md

@@ -1,5 +1,9 @@
 # OpenClaw: Z-ZERO AI Agent MCP Server
 
+[![npm](https://img.shields.io/npm/v/z-zero-mcp-server)](https://www.npmjs.com/package/z-zero-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
+[![Built with Tether WDK](https://img.shields.io/badge/Built%20with-Tether%20WDK-00A86B)](https://wdk.tether.to)
+
 A Zero-Trust Payment Protocol built specifically for AI Agents using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). Give your local agents (Claude, Cursor, AntiGravity) the ability to make real-world purchases — securely, without ever seeing a real card number.
 
 ## How It Works

package/dist/index.js

@@ -304,6 +304,60 @@ server.tool("get_merchant_hints", "Fetch checkout hints for a specific domain fr
     }
 });
 // ============================================================
+// TOOL 4b: Report Checkout Fail (Self-Healing Feedback Loop)
+// Agent calls this when a purchase task could not be completed.
+// Logs the checkout URL for admin review → future hints creation.
+// ============================================================
+server.tool("report_checkout_fail", "Report a checkout URL that you could not complete. Call this when you failed to finish a purchase — for any reason (field not found, bot blocked, timeout, unknown form). The URL will be logged for admin review to improve future checkout success rates. This is part of Z-ZERO's self-healing loop.", {
+    url: zod_1.z
+        .string()
+        .url()
+        .describe("The checkout/payment page URL where the purchase failed."),
+    error_type: zod_1.z
+        .string()
+        .optional()
+        .describe("Short error category: 'field_not_found', 'timeout', 'bot_blocked', 'unknown_form', 'price_mismatch', or 'other'."),
+    error_message: zod_1.z
+        .string()
+        .optional()
+        .describe("Brief description of what went wrong, e.g. 'Could not find card number field' or 'Page redirected to CAPTCHA'."),
+}, async ({ url, error_type, error_message }) => {
+    const ZZERO_API = process.env.Z_ZERO_API_BASE || "https://www.clawcard.store";
+    const INTERNAL_SECRET = process.env.Z_ZERO_INTERNAL_SECRET || "";
+    try {
+        const resp = await fetch(`${ZZERO_API}/api/checkout-hints`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-internal-secret": INTERNAL_SECRET,
+                "x-mcp-version": version_js_2.CURRENT_MCP_VERSION,
+            },
+            body: JSON.stringify({
+                url,
+                error_type: error_type || "other",
+                error_message: error_message || null,
+                mcp_version: version_js_2.CURRENT_MCP_VERSION,
+            }),
+        });
+        const data = await resp.json();
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        reported: true,
+                        message: "Checkout failure logged. An admin will review this URL to create or update hints for future agents. Thank you for contributing to the self-healing loop.",
+                        ...data,
+                    }, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        reported: false,
+                        message: `Could not reach fail-report API: ${err?.message || "unknown error"}. Please inform the user manually.`,
+                    }, null, 2) }],
+        };
+    }
+});
+// ============================================================
 // TOOL 4b: Execute payment (The "Invisible Hand")
 // ============================================================
 server.tool("execute_payment", "Execute a payment using a temporary token. This tool will securely fill the checkout form on the target website. You will NEVER see the real card number - it is handled securely in the background.", {
@@ -400,6 +454,7 @@ server.tool("execute_payment", "Execute a payment using a temporary token. This
                         message: result.message || "Payment was declined by merchant.",
                         token_status: "ACTIVE",
                         note: "Token NOT burned. Funds will be refunded automatically via webhook within minutes.",
+                        self_heal_hint: "If this failure was caused by the checkout form (wrong selector, unknown iframe, CAPTCHA, etc.), call report_checkout_fail(checkout_url) to help improve future checkouts. Do NOT report if the user cancelled or had insufficient balance.",
                     }, null, 2),
                 },
             ],

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const CURRENT_MCP_VERSION = "1.1.2";
+export declare const CURRENT_MCP_VERSION = "1.2.0";

package/dist/version.js

@@ -3,4 +3,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CURRENT_MCP_VERSION = void 0;
 // Single source of truth for MCP version
 // Imported by both index.ts and wdk_backend.ts to avoid circular dependency
-exports.CURRENT_MCP_VERSION = "1.1.2";
+exports.CURRENT_MCP_VERSION = "1.2.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "z-zero-mcp-server",
-    "version": "1.1.2",
+    "version": "1.2.0",
     "description": "Z-ZERO MCP Server — Secure JIT Virtual Card Payment tools for AI Agents (Claude, Cursor, AutoGPT) — Real Single-Use Visa Cards",
     "main": "dist/index.js",
     "bin": "dist/index.js",