panal-mcp 0.14.0 → 0.15.0

package/dist/niveles.d.ts

@@ -41,7 +41,7 @@ export declare function precioDeNivel(nivel: Nivel, symbol: string): string;
  * agente que vende tres tamaños se veía con un precio suelto —el más barato— y
  * el encargo grande se contrataba al precio del pequeño.
  */
-export declare function renderNiveles(niveles: Nivel[], symbol: string): string[];
+export declare function renderNiveles(niveles: Nivel[], symbol: string, enUsd?: (wei: bigint) => string): string[];
 /**
  * Los niveles en UNA línea, para las listas.
  *

package/dist/niveles.js

@@ -47,13 +47,13 @@ export function precioDeNivel(nivel, symbol) {
  * agente que vende tres tamaños se veía con un precio suelto —el más barato— y
  * el encargo grande se contrataba al precio del pequeño.
  */
-export function renderNiveles(niveles, symbol) {
+export function renderNiveles(niveles, symbol, enUsd = () => '') {
     if (niveles.length === 0)
         return [];
     return [
         `  Sizes (${niveles.length}) — pass the one the person picks as \`tier\` to panal_quote_hire:`,
         ...niveles.map((n) => {
-            const partes = [`    · ${n.name ?? '(unnamed)'} — ${precioDeNivel(n, symbol)}`];
+            const partes = [`    · ${n.name ?? '(unnamed)'} — ${precioDeNivel(n, symbol)}${enUsd(n.wei)}`];
             if (n.description)
                 partes.push(n.description);
             if (n.maxBriefChars)

package/dist/server.js

@@ -42,7 +42,7 @@ import { createInterface } from 'node:readline';
 import { fileURLToPath } from 'node:url';
 import { formatEther, formatUnits, isAddress, keccak256, parseEther, toBytes } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
-import { NATIVE_CURRENCY, TaskStatus, appendAttachmentsManifest, conEjemplosDeLaFicha, createPanalClient, downloadDeliveredFile, erc20Abi, leerEjemplosDeMetadata, matchAttachment, parseAttachmentsManifest, parseFilesManifest, stripFilesManifest, x402Currency, } from '@panal/sdk';
+import { NATIVE_CURRENCY, TaskStatus, appendAttachmentsManifest, conEjemplosDeLaFicha, createPanalClient, downloadDeliveredFile, enDolares, formatearDolares, erc20Abi, leerEjemplosDeMetadata, 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';
@@ -125,6 +125,31 @@ function symbolOf(currency) {
 function fmt(amount, currency) {
     return formatUnits(amount, esNativa(currency) ? 18 : (x402Currency(currency)?.decimals ?? 18));
 }
+/**
+ * Los precios en dólares, leídos como mucho cada 30 s.
+ *
+ * Solo para enseñar: lo que se firma y se bloquea sigue siendo la cantidad en
+ * su moneda. MON sale de Pyth y $PANAL de la curva de nad.fun, los dos en la
+ * cadena (ver precios.ts del SDK). Si no se pueden leer, las respuestas salen
+ * sin dólares, igual que antes.
+ */
+let preciosCache = { leidos: 0, valor: null };
+async function refrescarPrecios() {
+    if (Date.now() - preciosCache.leidos < 30_000)
+        return;
+    preciosCache = { leidos: Date.now(), valor: await panal.precios().catch(() => null) };
+}
+/**
+ * « (≈ $0.60)» si hay un precio de menos de cinco minutos para esa moneda;
+ * nada si no. Las estables ya son dólares y no llevan nada.
+ */
+function usd(amount, currency) {
+    const sym = symbolOf(currency);
+    if (sym !== 'MON' && sym !== '$PANAL')
+        return '';
+    const d = enDolares(amount, sym, preciosCache.valor);
+    return d ? ` (≈ ${formatearDolares(d.usd)})` : '';
+}
 /** Las monedas que este servidor sabe manejar: las que tienen presupuesto. */
 function monedasConocidas() {
     return [...limits.porMoneda.keys()];
@@ -234,7 +259,7 @@ function trustLine(agent) {
     return `  Trust: ${partes.join('; ')}`;
 }
 function renderAgent(agent, niveles = [], detallado = false) {
-    const price = `${formatEther(agent.pricePerTask)} ${symbolOf(agent.currency)}`;
+    const price = `${formatEther(agent.pricePerTask)} ${symbolOf(agent.currency)}${usd(agent.pricePerTask, agent.currency)}`;
     const skills = agent.metadata.skills.length ? agent.metadata.skills.join(', ') : '(no skills declared)';
     return [
         `${agent.metadata.name || '(no name)'} — ${agent.address}`,
@@ -247,7 +272,9 @@ function renderAgent(agent, niveles = [], detallado = false) {
         // Los niveles van DEBAJO del precio de tarea y no en su lugar: ese precio
         // sigue siendo el que se bloquea si nadie elige tamaño, y el que cobran
         // los agentes —casi todos— que no venden ninguno.
-        ...(detallado ? renderNiveles(niveles, symbolOf(agent.currency)) : [lineaDeNiveles(niveles, symbolOf(agent.currency))]),
+        ...(detallado
+            ? renderNiveles(niveles, symbolOf(agent.currency), (wei) => usd(wei, agent.currency))
+            : [lineaDeNiveles(niveles, symbolOf(agent.currency))]),
         `  Skills: ${skills}`,
         agent.metadata.description ? `  Description: ${agent.metadata.description}` : null,
         agent.metadata.botUrl ? `  Endpoint: ${agent.metadata.botUrl}` : null,
@@ -262,7 +289,7 @@ function renderTask(task) {
         `Task #${task.id} — ${TaskStatus[task.status] ?? task.status}`,
         `  Client: ${task.client}`,
         `  Agent:   ${task.worker}`,
-        `  Amount:  ${formatEther(task.amount)} ${symbolOf(task.currency)}`,
+        `  Amount:  ${formatEther(task.amount)} ${symbolOf(task.currency)}${usd(task.amount, task.currency)}`,
         `  Deadline: ${deadline}`,
         `  Job hash: ${task.taskHash}`,
         task.resultHash && !/^0x0+$/.test(task.resultHash) ? `  Result hash: ${task.resultHash}` : null,
@@ -335,6 +362,7 @@ const READ_TOOLS = [
             },
         },
         handler: async (args) => {
+            await refrescarPrecios();
             const found = await panal.searchAgents(str(args.query), {
                 includeInactive: args.include_inactive === true,
             });
@@ -363,7 +391,7 @@ const READ_TOOLS = [
             const address = str(args.address);
             if (!address || !isAddress(address))
                 return 'I need a valid 0x address.';
-            const agent = await panal.getAgent(address);
+            const [agent] = await Promise.all([panal.getAgent(address), refrescarPrecios()]);
             // El perfil es donde alguien mira el precio, así que aquí sí se paga la
             // llamada al manifiesto del agente: enseñar solo el de tarea era la
             // razón de que el precio por consulta fuese invisible desde aquí. En
@@ -409,7 +437,8 @@ const READ_TOOLS = [
             const count = await panal.getTaskCount();
             if (BigInt(id) >= count)
                 return `Task #${id} does not exist: there are ${count} so far.`;
-            return renderTask(await panal.getTask(BigInt(id)));
+            const [task] = await Promise.all([panal.getTask(BigInt(id)), refrescarPrecios()]);
+            return renderTask(task);
         },
     },
     {
@@ -433,7 +462,7 @@ const READ_TOOLS = [
                 return 'I need a valid 0x address for the agent.';
             if (!prompt)
                 return 'I need the question.';
-            const agent = await panal.getAgent(address);
+            const [agent] = await Promise.all([panal.getAgent(address), refrescarPrecios()]);
             const name = agent.metadata.name || address;
             let quote;
             try {
@@ -467,7 +496,7 @@ const READ_TOOLS = [
             });
             return [
                 `${name} charges per question:`,
-                `  Price: ${fmt(amount, quote.asset)} ${symbol} for this one question`,
+                `  Price: ${fmt(amount, quote.asset)} ${symbol}${usd(amount, quote.asset)} for this one question`,
                 `  Paid to: ${quote.payTo}`,
                 quote.description ? `  Covers: ${quote.description}` : null,
                 '',
@@ -515,7 +544,7 @@ const READ_TOOLS = [
         inputSchema: { type: 'object', properties: {} },
         handler: async () => {
             try {
-                const lista = await panal.listBoard();
+                const [lista] = await Promise.all([panal.listBoard(), refrescarPrecios()]);
                 if (!lista.length)
                     return 'The board is empty: no job is waiting to be taken right now.';
                 const ahora = Math.floor(Date.now() / 1000);
@@ -523,7 +552,7 @@ const READ_TOOLS = [
                     `${lista.length} job(s) on the board:`,
                     ...lista.map((e) => {
                         const horas = Math.max(0, Math.floor((Number(e.deadline) - ahora) / 3600));
-                        return (`\n#${e.taskId} — ${formatEther(e.amount)} ${symbolOf(e.currency)}, ${horas} h left\n` +
+                        return (`\n#${e.taskId} — ${formatEther(e.amount)} ${symbolOf(e.currency)}${usd(e.amount, e.currency)}, ${horas} h left\n` +
                             `  "${e.anuncio}"\n  posted by ${e.cliente}`);
                     }),
                     '\nTo take one, use panal_claim_task with its number. Only an active registered agent can claim.',
@@ -561,7 +590,8 @@ 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, m) => (v === null ? 'could not be read' : fmt(v, m));
+            await refrescarPrecios();
+            const importe = (v, m) => v === null ? 'could not be read' : `${fmt(v, m)}${v > 0n ? usd(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.
@@ -630,7 +660,7 @@ const WRITE_TOOLS = [
             if (rutas.length > MAX_ADJUNTOS) {
                 return `That is ${rutas.length} attachments and the limit is ${MAX_ADJUNTOS} per job.`;
             }
-            const agent = await panal.getAgent(address);
+            const [agent] = await Promise.all([panal.getAgent(address), refrescarPrecios()]);
             if (!agent.active)
                 return `${agent.metadata.name || address} is delisted and does not take jobs.`;
             // ---- Adjuntos -------------------------------------------------------
@@ -775,7 +805,7 @@ const WRITE_TOOLS = [
             });
             return [
                 `Quote for ${quote.agentName}:`,
-                `  Price: ${formatEther(amount)} ${symbol}${elegido ? ` — size "${elegido.name}"` : ''}`,
+                `  Price: ${formatEther(amount)} ${symbol}${usd(amount, agent.currency)}${elegido ? ` — size "${elegido.name}"` : ''}`,
                 // Los otros tamaños se enseñan SIEMPRE que existan, también cuando ya
                 // se eligió uno: quien está leyendo esto es quien paga, y enterarse de
                 // que había uno más grande después de contratar no sirve de nada.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panal-mcp",
-  "version": "0.14.0",
+  "version": "0.15.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.20.0",
+    "@panal/sdk": "^0.21.0",
     "viem": "^2.21.0"
   },
   "devDependencies": {