panal-mcp 0.5.1 → 0.6.0

package/dist/fetch-result.d.ts

@@ -52,8 +52,21 @@ export declare function pushBrief(botUrl: string, taskId: bigint, brief: string,
  * «no hay tope» es volver a averiguarlo pagando.
  */
 export declare function parseMaxBriefChars(card: unknown): number | null;
-export declare function fetchAgentLimits(botUrl: string): Promise<{
+export interface LimitesDelAgente {
+    /**
+     * Si contestó ALGO, aunque fuera un error.
+     *
+     * Un 404 en `/agent.json` cuenta como alcanzable: hay agentes que no sirven
+     * tarjeta y su `POST /brief` funciona igual. Lo que descalifica es que no
+     * conteste nadie —DNS que no resuelve, conexión rechazada, timeout— o que la
+     * URL no pase el guard, porque entonces el encargo tampoco va a llegar.
+     *
+     * `null` = no se preguntó (el agente no publica endpoint, que es un modo
+     * soportado: el encargo se le hace llegar por otro canal).
+     */
+    alcanzable: boolean | null;
     maxBriefChars: number | null;
-}>;
+}
+export declare function fetchAgentLimits(botUrl: string): Promise<LimitesDelAgente>;
 /** Descarga acotada: se corta en cuanto se pasa del tope. */
 export declare function fetchResultText(botUrl: string, taskId: bigint, client: string, signature: string, expira: number): Promise<string>;

package/dist/fetch-result.js

@@ -110,27 +110,35 @@ export function parseMaxBriefChars(card) {
     return typeof max === 'number' && Number.isInteger(max) && max > 0 ? max : null;
 }
 export async function fetchAgentLimits(botUrl) {
-    const desconocido = { maxBriefChars: null };
     let url;
     try {
         const base = await assertPublicUrl(botUrl);
         url = new URL('/agent.json', base);
     }
     catch {
-        return desconocido;
+        // El guard rechaza la URL: a esa dirección no se le puede entregar nada, ni
+        // ahora ni al contratar. Es inalcanzable, no «no lo sé».
+        return { alcanzable: false, maxBriefChars: null };
     }
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
     try {
         const res = await fetch(url, { signal: controller.signal, redirect: 'error' });
+        // A partir de aquí YA contestó, y eso no se revoca: una tarjeta ilegible o
+        // un 500 dejan el tope sin saber, pero el agente sigue siendo contratable.
+        // Meter el parseo en el catch de la red convertiría un JSON roto en «este
+        // agente no existe», que es una acusación distinta y falsa.
         if (!res.ok)
-            return desconocido;
-        return { maxBriefChars: parseMaxBriefChars(await res.json()) };
+            return { alcanzable: true, maxBriefChars: null };
+        try {
+            return { alcanzable: true, maxBriefChars: parseMaxBriefChars(await res.json()) };
+        }
+        catch {
+            return { alcanzable: true, maxBriefChars: null };
+        }
     }
     catch {
-        // Un agente sin tarjeta, o que tarda, no impide contratarlo: solo deja el
-        // límite sin comprobar. Fallar aquí seria peor que el problema.
-        return desconocido;
+        return { alcanzable: false, maxBriefChars: null };
     }
     finally {
         clearTimeout(timer);

package/dist/server.js

@@ -405,7 +405,16 @@ const WRITE_TOOLS = [
             // tarea. Aquí no cuesta nada y evita dejar dinero atrapado hasta que
             // vence el plazo.
             if (agent.metadata.botUrl) {
-                const { maxBriefChars } = await fetchAgentLimits(agent.metadata.botUrl);
+                const { alcanzable, maxBriefChars } = await fetchAgentLimits(agent.metadata.botUrl);
+                // Que el endpoint no conteste descalifica el encargo entero: el brief se
+                // entrega DESPUÉS de crear la tarea, así que contratar ahora dejaría el
+                // pago bloqueado en una tarea que nadie puede empezar. Aquí no cuesta
+                // nada y basta con reintentar cuando el agente vuelva.
+                if (alcanzable === false) {
+                    return (`${agent.metadata.name || address} publishes ${agent.metadata.botUrl} but nothing answers there, ` +
+                        `so the job could not be delivered even after paying. Nothing was quoted and nothing was spent. ` +
+                        `Try again when the agent is back up.`);
+                }
                 if (maxBriefChars !== null && brief.length > maxBriefChars) {
                     return (`That job does not fit: ${agent.metadata.name || address} accepts ${maxBriefChars} characters ` +
                         `and this brief is ${brief.length}. Nothing was quoted and nothing was spent. ` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panal-mcp",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Servidor MCP de Panal: busca y contrata agentes de IA on-chain desde Claude",
   "type": "module",
   "license": "MIT",