panal-mcp 0.12.0 → 0.13.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Panal and Kreno (founder: Gustavo Chura C.)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -143,6 +143,12 @@ Las herramientas de escritura mueven dinero real en mainnet, así que están **a
 | `MCP_DAILY_BUDGET_WEI` | `5e18` (5 MON) | Tope por día UTC **en MON**, persistido en disco |
 | `MCP_MAX_PER_TASK_PANAL_WEI` | `1e18` (1 $PANAL) | Tope por encargo, **en $PANAL** |
 | `MCP_DAILY_BUDGET_PANAL_WEI` | `5e18` (5 $PANAL) | Tope por día UTC **en $PANAL** |
+| `MCP_MAX_PER_TASK_GHO_UNITS` | `1e18` (1 GHO) | Tope por consulta **en GHO** |
+| `MCP_DAILY_BUDGET_GHO_UNITS` | `5e18` (5 GHO) | Tope por día UTC **en GHO** |
+| `MCP_MAX_PER_TASK_USDC_UNITS` | `1e6` (1 USDC) | Tope por consulta **en USDC** (6 decimales) |
+| `MCP_DAILY_BUDGET_USDC_UNITS` | `5e6` (5 USDC) | Tope por día UTC **en USDC** |
+| `MCP_MAX_PER_TASK_AUSD_UNITS` | `1e6` (1 AUSD) | Tope por consulta **en AUSD** (6 decimales) |
+| `MCP_DAILY_BUDGET_AUSD_UNITS` | `5e6` (5 AUSD) | Tope por día UTC **en AUSD** |
 | `MCP_TASK_DEADLINE_HOURS` | `24` | Plazo de entrega |
 | `MCP_SPEND_FILE` | `.panal-mcp/spend.json` | Dónde se guarda el gasto del día |
 | `MCP_ATTACH_DIR` | el directorio de trabajo | Única carpeta desde la que se puede adjuntar |

package/dist/limits.d.ts

@@ -6,7 +6,7 @@
  * servidor, y nunca en el prompt: un prompt se puede negociar, un `if` no.
  */
 import type { Address } from 'viem';
-import type { AttachedFile } from '@panal/sdk';
+import { type AttachedFile } from '@panal/sdk';
 /**
  * Las dos maneras de pagar a un agente, y no son intercambiables.
  *

package/dist/limits.js

@@ -8,6 +8,7 @@
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { randomUUID } from 'node:crypto';
+import { x402Currencies } from '@panal/sdk';
 /** Vida de un presupuesto. Corto a propósito: el precio del agente puede cambiar. */
 const QUOTE_TTL_MS = 5 * 60 * 1000;
 /**
@@ -193,5 +194,21 @@ export function limitsFromEnv() {
         envMaxPerTask: 'MCP_MAX_PER_TASK_PANAL_WEI',
         envDailyBudget: 'MCP_DAILY_BUDGET_PANAL_WEI',
     });
+    // Las estables con las que se paga por consulta: GHO, USDC y AUSD. Cada una
+    // con su cuenta, en SUS unidades mínimas (6 decimales en USDC y AUSD): 1 por
+    // consulta y 5 al día de partida, que es un dólar y cinco.
+    for (const c of x402Currencies()) {
+        // $PANAL y MON ya tienen las suyas, las de siempre.
+        if (c.address.toLowerCase() === PANAL || c.scheme === 'native-transfer')
+            continue;
+        const nombre = c.symbol.replace(/^\$/, '');
+        const unidad = 10n ** BigInt(c.decimals);
+        porMoneda.set(clave(c.address), {
+            maxPerTaskWei: parse(`MCP_MAX_PER_TASK_${nombre}_UNITS`, unidad),
+            dailyBudgetWei: parse(`MCP_DAILY_BUDGET_${nombre}_UNITS`, 5n * unidad),
+            envMaxPerTask: `MCP_MAX_PER_TASK_${nombre}_UNITS`,
+            envDailyBudget: `MCP_DAILY_BUDGET_${nombre}_UNITS`,
+        });
+    }
     return { deadlineHours: Number.isFinite(hours) && hours > 0 ? hours : 24, porMoneda };
 }

package/dist/server.js

@@ -40,9 +40,9 @@ import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { createInterface } from 'node:readline';
 import { fileURLToPath } from 'node:url';
-import { formatEther, isAddress, keccak256, parseEther, toBytes } from 'viem';
+import { formatEther, formatUnits, isAddress, keccak256, parseEther, toBytes } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
-import { NATIVE_CURRENCY, TaskStatus, appendAttachmentsManifest, createPanalClient, downloadDeliveredFile, erc20Abi, matchAttachment, parseAttachmentsManifest, parseFilesManifest, stripFilesManifest, } from '@panal/sdk';
+import { NATIVE_CURRENCY, TaskStatus, appendAttachmentsManifest, createPanalClient, downloadDeliveredFile, erc20Abi, matchAttachment, parseAttachmentsManifest, parseFilesManifest, stripFilesManifest, x402Currency, } from '@panal/sdk';
 import { MAX_ADJUNTOS, capacidadesDeAgente, guardarDescarga, leerAdjuntoLocal, raizAdjuntos, raizDescargas, subirAdjunto, } from './adjuntos.js';
 import { buscarNivel, lineaDeNiveles, nivelesDeAgente, precioDeNivel, renderNiveles, } from './niveles.js';
 import { QuoteBook, SpendLedger, limitFor, limitsFromEnv } from './limits.js';
@@ -108,8 +108,22 @@ function writesBlockedReason() {
 function esNativa(currency) {
     return currency.toLowerCase() === NATIVE_CURRENCY.toLowerCase();
 }
+/**
+ * El nombre de una moneda, de la lista de Panal. Nunca el que trae la
+ * cotización: lo escribe el agente, y con un nombre a su gusto se podía cobrar
+ * en un token enseñando otro. Lo que no está en la lista se nombra por su
+ * dirección, que es lo único que se sabe de verdad.
+ */
 function symbolOf(currency) {
-    return esNativa(currency) ? 'MON' : '$PANAL';
+    return esNativa(currency) ? 'MON' : (x402Currency(currency)?.symbol ?? currency);
+}
+/**
+ * Un importe en unidades mínimas, con los decimales de SU moneda: 18 en MON,
+ * $PANAL y GHO, 6 en USDC y AUSD. Con `formatEther` para todo, un millón de
+ * unidades de USDC —un dólar— salía como 0,000000000001.
+ */
+function fmt(amount, currency) {
+    return formatUnits(amount, esNativa(currency) ? 18 : (x402Currency(currency)?.decimals ?? 18));
 }
 /** Las monedas que este servidor sabe manejar: las que tienen presupuesto. */
 function monedasConocidas() {
@@ -152,16 +166,16 @@ function revisarPresupuesto(currency, amount, symbol) {
     const lim = limitFor(limits, currency);
     if (!lim) {
         return (`That agent charges in a token this server has no budget for (${currency}). ` +
-            'Only MON and $PANAL have caps configured; there is no exchange rate to reuse another one.');
+            `Caps are configured for ${monedasConocidas().map(symbolOf).join(', ')}; there is no exchange rate to reuse another one.`);
     }
     if (amount > lim.maxPerTaskWei) {
-        return (`That costs ${formatEther(amount)} ${symbol} and the per-item cap for ${symbol} is ` +
-            `${formatEther(lim.maxPerTaskWei)}. Raise ${lim.envMaxPerTask} if that is intended.`);
+        return (`That costs ${fmt(amount, currency)} ${symbol} and the per-item cap for ${symbol} is ` +
+            `${fmt(lim.maxPerTaskWei, currency)}. Raise ${lim.envMaxPerTask} if that is intended.`);
     }
     const spent = ledger.spentToday(currency);
     if (spent + amount > lim.dailyBudgetWei) {
-        return (`That would blow today's ${symbol} budget: ${formatEther(spent)} of ` +
-            `${formatEther(lim.dailyBudgetWei)} spent and this costs ${formatEther(amount)} ${symbol}. ` +
+        return (`That would blow today's ${symbol} budget: ${fmt(spent, currency)} of ` +
+            `${fmt(lim.dailyBudgetWei, currency)} spent and this costs ${fmt(amount, currency)} ${symbol}. ` +
             `Raise ${lim.envDailyBudget} if that is intended.`);
     }
     return null;
@@ -365,7 +379,7 @@ const READ_TOOLS = [
                     : Promise.resolve(null),
             ]);
             const porLlamada = q
-                ? `  Per question: ${formatEther(BigInt(q.amount))} ${q.assetSymbol ?? symbolOf(q.asset)} (x402, answered on the spot)`
+                ? `  Per question: ${fmt(BigInt(q.amount), q.asset)} ${symbolOf(q.asset)} (x402, answered on the spot)`
                 : '  Per question: not offered (this agent only takes jobs through escrow)';
             const niveles = nivelesDeAgente(agent.metadataURI, ficha?.niveles ?? []);
             return `${renderAgent(agent, niveles, true)}\n${porLlamada}`;
@@ -425,7 +439,7 @@ const READ_TOOLS = [
                     `per task, via panal_quote_hire.`);
             }
             const amount = BigInt(quote.amount);
-            const symbol = quote.assetSymbol ?? symbolOf(quote.asset);
+            const symbol = symbolOf(quote.asset);
             const saved = quotes.issue({
                 kind: 'ask',
                 worker: agent.address,
@@ -444,7 +458,7 @@ const READ_TOOLS = [
             });
             return [
                 `${name} charges per question:`,
-                `  Price: ${formatEther(amount)} ${symbol} for this one question`,
+                `  Price: ${fmt(amount, quote.asset)} ${symbol} for this one question`,
                 `  Paid to: ${quote.payTo}`,
                 quote.description ? `  Covers: ${quote.description}` : null,
                 '',
@@ -538,23 +552,23 @@ const WRITE_TOOLS = [
                 // perdido — y también hay que preguntarlo moneda a moneda.
                 Promise.all(monedas.map((m) => panal.getPendingWithdrawal(address, m).catch(() => null))),
             ]);
-            const importe = (v) => (v === null ? 'could not be read' : formatEther(v));
-            const balances = monedas.map((m, i) => `  ${symbolOf(m)}: ${importe(saldos[i] ?? null)}`);
+            const importe = (v, m) => (v === null ? 'could not be read' : fmt(v, m));
+            const balances = monedas.map((m, i) => `  ${symbolOf(m)}: ${importe(saldos[i] ?? null, m)}`);
             // Un presupuesto por moneda: MON y $PANAL no valen lo mismo y no hay
             // tipo de cambio, así que se enseñan por separado o no se entienden.
             const presupuestos = monedas.map((moneda) => {
                 const lim = limitFor(limits, moneda);
                 const spent = ledger.spentToday(moneda);
                 const left = lim.dailyBudgetWei > spent ? lim.dailyBudgetWei - spent : 0n;
-                return (`  ${symbolOf(moneda)}: per job ${formatEther(lim.maxPerTaskWei)} · today ${formatEther(spent)} of ` +
-                    `${formatEther(lim.dailyBudgetWei)} spent · ${formatEther(left)} left`);
+                return (`  ${symbolOf(moneda)}: per job ${fmt(lim.maxPerTaskWei, moneda)} · today ${fmt(spent, moneda)} of ` +
+                    `${fmt(lim.dailyBudgetWei, moneda)} spent · ${fmt(left, moneda)} left`);
             });
             // Solo se nombra lo que hay que cobrar, o lo que no se pudo comprobar. Un
             // «0» por cada moneda sería ruido en la respuesta más leída del servidor.
             const enEscrow = monedas
-                .map((m, i) => ({ sym: symbolOf(m), v: pendientes[i] ?? null }))
+                .map((m, i) => ({ m, sym: symbolOf(m), v: pendientes[i] ?? null }))
                 .filter(({ v }) => v === null || v > 0n)
-                .map(({ sym, v }) => `  ${sym}: ${importe(v)}`);
+                .map(({ m, sym, v }) => `  ${sym}: ${importe(v, m)}`);
             return [
                 `Wallet: ${address}`,
                 'Balance:',
@@ -826,7 +840,7 @@ const WRITE_TOOLS = [
                 // Se registra lo REALMENTE pagado, y en SU moneda: un gasto anotado en
                 // el contador equivocado agota un presupuesto que nadie tocó.
                 ledger.record(quote.currency, res.paid);
-                log(`consulta pagada a ${quote.worker}: ${formatEther(res.paid)} ${quote.symbol}`);
+                log(`consulta pagada a ${quote.worker}: ${fmt(res.paid, quote.currency)} ${quote.symbol}`);
                 return [
                     `Paid ${formatEther(res.paid)} ${quote.symbol} to ${quote.agentName}.`,
                     res.txHash ? `  tx: ${EXPLORER}/tx/${res.txHash}` : null,
@@ -1455,9 +1469,11 @@ const WRITE_TOOLS = [
     },
     {
         name: 'panal_deliver_board',
-        description: 'Deliver a job taken from the Panal board. The text is left in the Panal inbox first — that is where ' +
-            'the client collects it, because they never knew who would take the job — and only then its hash ' +
-            'is anchored on chain. If the inbox refuses it, nothing is anchored and it can be retried. Costs gas.',
+        description: 'Deliver a job taken from the Panal board, for a wallet that receives through its Panal inbox (a ' +
+            'person, or an agent without its own server). The text is left in THIS wallet\'s inbox — the endpoint ' +
+            'it publishes, which is where the client collects any delivery — and only then its hash is anchored on ' +
+            'chain. If the inbox refuses it, nothing is anchored and it can be retried. An agent with its own server ' +
+            'must serve the result itself instead, and this tool refuses. Costs gas.',
         inputSchema: {
             type: 'object',
             properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panal-mcp",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Servidor MCP de Panal: busca y contrata agentes de IA on-chain desde Claude",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@panal/sdk": "^0.18.0",
+    "@panal/sdk": "^0.19.0",
     "viem": "^2.21.0"
   },
   "devDependencies": {