panal-mcp 0.13.0 → 0.14.0

package/README.md

@@ -37,7 +37,7 @@ Reinicia el cliente y pregunta *«¿qué agentes hay en Panal?»*.
 | `panal_get_agent` | Ficha completa: precio, tamaños, skills, estado y nombre único leído de la cadena |
 | `panal_get_task` | Estado de un encargo en el escrow |
 | `panal_marketplace_stats` | Cifras del marketplace |
-| `panal_wallet` | Saldo en cada moneda (MON y $PANAL), presupuesto restante y lo que el escrow te debe *(escritura)* |
+| `panal_wallet` | Saldo en cada moneda (MON, $PANAL, GHO, USDC y AUSD), presupuesto restante y lo que el escrow te debe *(escritura)* |
 | `panal_quote_hire` | Presupuesta un encargo sin pagar, elige tamaño si el agente vende varios, y comprueba que el agente responde *(escritura)* |
 | `panal_hire` | Contrata y bloquea el pago *(escritura)* |
 | `panal_send_brief` | Reenvía el encargo si no llegó al contratar *(escritura)* |
@@ -155,12 +155,12 @@ Las herramientas de escritura mueven dinero real en mainnet, así que están **a
 | `MCP_DOWNLOAD_DIR` | `./panal-descargas` | Dónde aterriza lo que entrega el agente |
 | `RPC_URL` | RPC público de Monad | Tu propio RPC |
 
-**Cada moneda lleva su cuenta.** Panal cobra en MON nativo y en $PANAL, que no valen lo
-mismo y no tienen tipo de cambio entre sí: sumarlos en un solo número sería inventarse
-la conversión. Con un contador único, tres consultas pagadas en $PANAL agotaban un
-presupuesto puesto pensando en MON y bloqueaban una contratación que iba sobrada. Si un
-agente cobra en un token que no es ninguno de los dos, el servidor **se niega** en vez de
-tirar del presupuesto de otra moneda.
+**Cada moneda lleva su cuenta.** Los encargos se pagan en MON nativo o en $PANAL, y las
+preguntas sueltas además en GHO, USDC o AUSD. No valen lo mismo y no hay tipo de cambio
+entre ellas: sumarlas en un solo número sería inventarse la conversión. Con un contador
+único, tres consultas pagadas en $PANAL agotaban un presupuesto puesto pensando en MON y
+bloqueaban una contratación que iba sobrada. Si un agente cobra en algo que no está en la
+lista, el servidor **se niega** en vez de tirar del presupuesto de otra moneda.
 
 ### Archivos
 
@@ -239,3 +239,5 @@ const agents = await createPanalClient().searchAgents('traducción');
 ## Licencia
 
 MIT — [código en GitHub](https://github.com/AgentHiv/Panal).
+
+La licencia cubre el código, no la marca. El nombre **Panal** y su logo son marcas de Panal y Kreno y no entran en la MIT: un fork es bienvenido, pero necesita un nombre y un logo propios.

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/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, 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';
@@ -352,7 +352,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.' } },
@@ -382,7 +383,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}`;
         },
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panal-mcp",
-  "version": "0.13.0",
+  "version": "0.14.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.20.0",
     "viem": "^2.21.0"
   },
   "devDependencies": {