panal-mcp 0.13.1 → 0.15.0

package/dist/fetch-result.d.ts

@@ -84,6 +84,11 @@ export interface LimitesDelAgente {
      * el agente caído y el único que nadie puede cambiar entre mirar y pagar.
      */
     niveles: Nivel[];
+    /**
+     * Los encargos de ejemplo de la ficha, si trae. Salen de la misma lectura,
+     * por lo mismo. La fuente es la cadena: ver `conEjemplosDeLaFicha`.
+     */
+    ejemplos?: string[];
 }
 export declare function fetchAgentLimits(botUrl: string): Promise<LimitesDelAgente>;
 /** Descarga acotada: se corta en cuanto se pasa del tope. */

package/dist/fetch-result.js

@@ -14,7 +14,7 @@
 // implementaciones equivalentes de lo mismo —la del SDK y una aquí—, y dos
 // copias de un control de seguridad son una que se queda atrás sin que nadie
 // se entere el día que la otra mejora.
-import { assertPublicUrl, leerMaxBriefChars, leerNiveles, rutaDeAgente } from '@panal/sdk';
+import { assertPublicUrl, leerEjemplos, leerMaxBriefChars, leerNiveles, rutaDeAgente } from '@panal/sdk';
 /** Tope de la respuesta. Sin esto, un endpoint hostil tumba el proceso. */
 const MAX_BYTES = 512 * 1024;
 const TIMEOUT_MS = 20_000;
@@ -129,7 +129,12 @@ export async function fetchAgentLimits(botUrl) {
             return { alcanzable: true, maxBriefChars: null, niveles: [] };
         try {
             const card = await res.json();
-            return { alcanzable: true, maxBriefChars: parseMaxBriefChars(card), niveles: leerNiveles(card) };
+            return {
+                alcanzable: true,
+                maxBriefChars: parseMaxBriefChars(card),
+                niveles: leerNiveles(card),
+                ejemplos: leerEjemplos(card),
+            };
         }
         catch {
             return { alcanzable: true, maxBriefChars: null, niveles: [] };

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, createPanalClient, downloadDeliveredFile, erc20Abi, 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,
             });
@@ -352,7 +380,8 @@ const READ_TOOLS = [
     },
     {
         name: 'panal_get_agent',
-        description: 'Full profile of a Panal agent, by address: price, the sizes it sells if it sells several, skills, status and its on-chain name.',
+        description: 'Full profile of a Panal agent, by address: price, the sizes it sells if it sells several, skills, status, ' +
+            'its on-chain name and the example jobs its owner suggests.',
         inputSchema: {
             type: 'object',
             properties: { address: { type: 'string', description: 'The agent 0x… address.' } },
@@ -362,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
@@ -382,7 +411,15 @@ const READ_TOOLS = [
                 ? `  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}`;
+            // Los encargos de ejemplo que propone su dueño: ayudan a redactar el
+            // encargo con lo que este agente hace de verdad. Son una idea, no un
+            // encargo listo — al que pide le falta añadir su material.
+            const ejemplos = conEjemplosDeLaFicha(leerEjemplosDeMetadata(agent.metadataURI), ficha?.ejemplos ?? []);
+            const lineaEjemplos = ejemplos.length > 0
+                ? `\n  Example jobs its owner suggests (a starting point; the brief still needs the actual material): ` +
+                    ejemplos.map((e) => `"${e}"`).join(' · ')
+                : '';
+            return `${renderAgent(agent, niveles, true)}\n${porLlamada}${lineaEjemplos}`;
         },
     },
     {
@@ -400,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);
         },
     },
     {
@@ -424,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 {
@@ -458,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,
                 '',
@@ -506,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);
@@ -514,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.',
@@ -552,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.
@@ -621,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 -------------------------------------------------------
@@ -766,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.13.1",
+  "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.19.0",
+    "@panal/sdk": "^0.21.0",
     "viem": "^2.21.0"
   },
   "devDependencies": {