"""Lordevo tools for LlamaIndex (llama-index-core). One FunctionTool per Lordevo tool, built from the lordevo-x402 tool table, paid per call with x402 (USDC on Base), free trial first when the client was made with trial=True: from llama_index.core.agent.workflow import FunctionAgent from lordevo_x402 import LordevoSync from lordevo_llamaindex import lordevo_tools agent = FunctionAgent(tools=lordevo_tools(LordevoSync.from_private_key(key, trial=True)), llm=llm) """ from __future__ import annotations import json from typing import Any, Optional from llama_index.core.tools import FunctionTool from lordevo_x402 import TOOLS, LordevoError, price_label from pydantic import Field, create_model # The 5 tools this drop-in exposes by default (all $0.003 per call). Pass your own list to change it. DEFAULT_TOOLS = ["page-markdown", "can-fetch", "tech-stack", "dns-lookup", "email-validate"] def error_json(e: Exception) -> str: """Errors reach the model as JSON it can read (error, message, charged), instead of an exception.""" if isinstance(e, LordevoError): out = {"error": e.code or f"http_{e.status}", "message": str(e), "charged": bool(e.charged)} if e.trial: out["free_trial"] = e.trial return json.dumps(out) return json.dumps({"error": "client_error", "message": str(e), "charged": False}) def _args_model(t: dict): alt = t.get("alt") or {} desc = t.get("param_description", t["param"]) fields: dict[str, Any] = {t["param"]: (Optional[str], Field(None, description=desc)) if alt else (str, Field(..., description=desc))} for k, d in alt.items(): fields[k] = (Optional[str], Field(None, description=d)) for k, o in (t.get("options") or {}).items(): d = o.get("description", k) + (f" One of: {', '.join(o['enum'])}." if "enum" in o else "") fields[k] = (str, Field(..., description=d)) if o.get("required") else (Optional[str], Field(None, description=d)) return create_model(f"{t['mcp_tool']}_args", **fields) def lordevo_tools(client: Any, only: list[str] | None = None) -> list[FunctionTool]: """client: a LordevoSync (from lordevo_x402). only: tool slugs (default DEFAULT_TOOLS).""" def make(slug: str, t: dict) -> FunctionTool: def run(**kw: Any) -> str: try: return json.dumps(client.call(slug, **{k: v for k, v in kw.items() if v is not None})) except Exception as e: # noqa: BLE001 - the model gets every error as JSON return error_json(e) return FunctionTool.from_defaults(fn=run, name=t["mcp_tool"], fn_schema=_args_model(t), description=f"{t['title']}. Costs {price_label(t['price_usd'])} per call (x402, USDC on Base); failed calls are not charged.") return [make(s, TOOLS[s]) for s in (only or DEFAULT_TOOLS)]