// cat-helpers.jsx - plain-language ("human") + machine-payload ("agent") layers const { useState: useCS, useMemo: useCM, useRef: useCR, useEffect: useCE } = React; /* ---------- icons (line, inherit currentColor) ---------- */ const Ico = { human: , agent: , chev: , check: , dot: , block: , copy: , ext: , verified: , mismatch: , gate: , bolt: , arrow: , sun: , moon: , }; /* ---------- plain-language helpers ---------- */ const TYPE_WORD = { string: "text", number: "number", boolean: "true / false", array: "list", object: "object" }; // One-line "what it costs / how you reach it" plain summary line. function priceLine(t) { if (!t.has_x402) return { label: "Free", per: "no payment", free: true }; const p = fmtPrice(t.price_usdc); if (p == null) return { label: "x402", per: "metered", free: false }; return { label: p, per: "per call · USDC", free: false }; } // Human-readable requirement checklist derived from the same planCall logic. function humanChecklist(t, ctx) { const plan = planCall(t, ctx); const items = []; // status if (t.status !== "active") { items.push({ state: "block", text: <>This capability was deregistered from the index and can no longer be called. }); } else { items.push({ state: "met", text: <>Active in the registry on Base. }); } // manifest integrity if (t.manifest_status === "verified") { items.push({ state: "met", text: <>Manifest verified - the published spec matches its on-chain hash. }); } else { items.push({ state: "block", text: <>Manifest hash mismatch - the live spec doesn't match what was registered. Treat results with caution. }); } // access predicate if (t.access === "gated") { const reqLabels = (t.access_reqs || []).map((r) => r.label).filter(Boolean); const cond = reqLabels.length ? reqLabels.join(", ") : "an on-chain predicate"; if (!ctx.wallet) { items.push({ state: "req", text: <>Gated access - your wallet must satisfy {cond}. Connect a wallet to check. }); } else { items.push({ state: "req", text: <>Gated access - caller wallet must satisfy {cond}. }); } } // auth if (t.has_auth) { items.push({ state: ctx.auth ? "met" : "req", text: ctx.auth ? <>Wallet sign-in (SIWE) available. : <>Requires wallet sign-in (SIWE) before the call. }); } // payment if (t.has_x402) { const p = fmtPrice(t.price_usdc); if (!ctx.x402) { items.push({ state: "block", text: <>Paid via x402{p != null ? <> ({p} USDC/call) : null} - but your caller settings disallow payments. }); } else if (p != null && ctx.budget < t.price_usdc) { items.push({ state: "block", text: <>Costs {p} USDC per call - above your {ctx.budget.toFixed(2)} USDC budget. }); } else { items.push({ state: ctx.x402 ? "met" : "req", text: <>Settles {p != null ? p + " USDC" : "payment"} per call over x402 before responding. }); } } else { items.push({ state: "met", text: <>No payment required. }); } return { plan, items }; } const VERDICT_COPY = { callable: { label: "Ready to call", line: "Every requirement is satisfied under your current caller context." }, conditional:{ label: "Callable with conditions", line: "Reachable once the conditions below are met." }, blocked: { label: "Not callable", line: "Blocked under your current caller context." }, }; /* ---------- agent-payload builders (legible JSON) ---------- */ function resolveRecord(t) { return { chain_id: REG.chain_id, registry: REG.registry, tool_id: t.id, name: t.name, endpoint: t.endpoint, method: "POST", access: t.access, requires_auth: t.has_auth, settlement: t.has_x402 ? "x402" : "none", price_usdc: t.price_usdc, manifest_verified: t.manifest_status === "verified", tags: t.tags || [], }; } function canCallRecord(t, ctx) { const plan = planCall(t, ctx); const steps = []; if (plan.status !== "blocked") { if (t.has_auth) steps.push("sign SIWE challenge"); if (t.access === "gated") steps.push("present predicate proof"); if (t.has_x402) steps.push("attach x-payment (x402)"); steps.push("POST inputs -> 200"); } return { tool_id: t.id, status: plan.status, caller: { wallet: ctx.wallet ? "0x...connected" : null, budget_usdc: ctx.budget, allow_x402: ctx.x402, has_auth: ctx.auth }, requirements: plan.req, blockers: plan.block, invocation: steps, }; } function invokeSnippet(t) { const body = {}; (t.inputs || []).forEach((f) => { body[f.name] = f.type === "string" ? "<" + f.name + ">" : f.type === "array" ? [] : f.type === "number" ? 0 : f.type === "boolean" ? false : null; }); const lines = []; lines.push(`POST ${t.endpoint || "https://endpoint.invalid"}`); lines.push(`content-type: application/json`); if (t.has_auth) lines.push(`authorization: Bearer `); if (t.has_x402) lines.push(`x-payment: `); lines.push(""); lines.push(JSON.stringify(body, null, 2)); return lines.join("\n"); } // Highlight a header+JSON invocation block. function hlInvoke(text) { const esc = (s) => s.replace(/&/g, "&").replace(//g, ">"); return esc(text).split("\n").map((ln) => { if (/^POST /.test(ln)) return `POST ${ln.slice(5)}`; if (/^[a-z-]+:/.test(ln)) { const i = ln.indexOf(":"); return `${ln.slice(0, i)}:${ln.slice(i + 1)}`; } return ln .replace(/("(?:[^"\\]|\\.)*")(\s*:)/g, '$1$2') .replace(/:\s*("(?:[^"\\]|\\.)*")/g, ': $1') .replace(/\b(true|false|null)\b/g, '$1') .replace(/:\s*(-?\d+(?:\.\d+)?)/g, ': $1'); }).join("\n"); } /* ---------- small shared components ---------- */ function CodeBlock({ verb, endpoint, html, raw, push }) { return (

{verb} {endpoint && {endpoint}}

); } Object.assign(window, { Ico, TYPE_WORD, priceLine, humanChecklist, VERDICT_COPY, resolveRecord, canCallRecord, invokeSnippet, hlInvoke, CodeBlock, });