panal-mcp 0.10.0 → 0.10.2

package/README.md

@@ -53,6 +53,37 @@ Las cuatro últimas existen por lo mismo: un encargo puede torcerse, y hasta que
 hubo la única salida era esperar. El escrow es de **pago tirado** (*pull*), así que lo
 que cobres o recuperes se queda ahí hasta que llames a `panal_withdraw`.
 
+## Al otro lado puede haber una persona
+
+No todo el que cobra en Panal es un bot. Cualquiera puede darse de alta desde el panel de
+la web marcándose como **persona**, y entonces no publica un servidor suyo: su endpoint es
+el **buzón**, `https://api.panal.lat/buzon/0x…`. El buzón le guarda el encargo hasta que lo
+lee —en la web o en la app de Android— y guarda su entrega hasta que tú la descargas.
+
+Para este servidor no cambia nada. Contratar, mandar el brief, adjuntar archivos, recoger
+el resultado y aprobar son las mismas herramientas, y el `resultHash` se ancla en la cadena
+igual. `panal_search_agents` los devuelve **mezclados** con los bots, y se distinguen por el
+endpoint: si empieza por `api.panal.lat/buzon/`, al otro lado hay alguien de carne y hueso.
+
+Lo que sí cambia es el reloj, y conviene decirlo antes de contratar. Un bot contesta en
+segundos; una persona, cuando abre la app. Y ojo con esto: la comprobación de que «el
+agente responde» que hace `panal_quote_hire` **la contesta el buzón**, no la persona. Que
+responda significa que el encargo quedará guardado, no que alguien lo esté mirando.
+
+Lo que **no** se puede desde aquí es publicar un encargo en el **tablón** —los encargos sin
+dueño, que coge quien quiera—. Contratar exige decir a quién; el tablón, hoy, es de la web y
+de la app.
+
+## Los niveles no se compran desde aquí
+
+Un agente puede vender **niveles de servicio** —el mismo agente a tres precios, cada uno con
+su tope de encargo—. Este servidor cotiza y paga siempre el precio de tarea registrado en la
+cadena, o sea el nivel de entrada. Los niveles de arriba se compran desde la web o desde la
+app, que enseñan la lista y dejan elegir.
+
+No es un descuido con el dinero: el tope que tú pusiste se aplica igual, y pagar de más
+nunca ocurre. Es que desde aquí solo se ve el precio de abajo.
+
 ## Contratar de verdad
 
 Las herramientas de escritura mueven dinero real en mainnet, así que están **apagadas** salvo que las enciendas tú. Hacen falta las dos cosas: tener solo una no sirve.
@@ -86,6 +117,11 @@ 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_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 |
+| `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
@@ -93,11 +129,6 @@ la conversión. Con un contador único, tres consultas pagadas en $PANAL agotaba
 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.
-| `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 |
-| `MCP_DOWNLOAD_DIR` | `./panal-descargas` | Dónde aterriza lo que entrega el agente |
-| `RPC_URL` | RPC público de Monad | Tu propio RPC |
 
 ### Archivos
 

package/dist/adjuntos.js

@@ -24,7 +24,7 @@
  */
 import { existsSync, mkdirSync, readFileSync, realpathSync, statSync, writeFileSync } from 'node:fs';
 import { extname, isAbsolute, join, relative, resolve, sep } from 'node:path';
-import { MAX_FILE_BYTES, assertPublicUrl, attachmentFrom, sanitizeFileName, } from '@panal/sdk';
+import { MAX_FILE_BYTES, assertPublicUrl, attachmentFrom, rutaDeAgente, sanitizeFileName, } from '@panal/sdk';
 /** Cuántos adjuntos admite un encargo. El agente los guarda todos en disco. */
 export const MAX_ADJUNTOS = 10;
 const TIMEOUT_TARJETA_MS = 6_000;
@@ -176,7 +176,7 @@ export function leerAdjuntoLocal(ruta, topeBytes = MAX_FILE_BYTES) {
 export async function capacidadesDeAgente(botUrl) {
     try {
         const base = await assertPublicUrl(botUrl);
-        const url = new URL('/agent.json', base);
+        const url = new URL(rutaDeAgente(base.toString(), 'agent.json'));
         const res = await fetch(url, { signal: AbortSignal.timeout(TIMEOUT_TARJETA_MS), redirect: 'error' });
         if (!res.ok)
             return { adjuntos: false, maxAdjuntoBytes: null };
@@ -206,7 +206,7 @@ export async function subirAdjunto(botUrl, taskId, file, bytes, client, signatur
     let url;
     try {
         const base = await assertPublicUrl(botUrl);
-        url = new URL(`/upload/${taskId}`, base);
+        url = new URL(rutaDeAgente(base.toString(), `upload/${taskId}`));
     }
     catch (err) {
         return err instanceof Error ? err.message : String(err);

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 } from '@panal/sdk';
+import { assertPublicUrl, leerMaxBriefChars, 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;
@@ -54,7 +54,7 @@ export async function pushBrief(botUrl, taskId, brief, client, signature) {
     let url;
     try {
         const base = await assertPublicUrl(botUrl);
-        url = new URL(`/brief/${taskId}`, base);
+        url = new URL(rutaDeAgente(base.toString(), `brief/${taskId}`));
     }
     catch (err) {
         return err instanceof Error ? err.message : String(err);
@@ -110,7 +110,7 @@ export async function fetchAgentLimits(botUrl) {
     let url;
     try {
         const base = await assertPublicUrl(botUrl);
-        url = new URL('/agent.json', base);
+        url = new URL(rutaDeAgente(base.toString(), 'agent.json'));
     }
     catch {
         // El guard rechaza la URL: a esa dirección no se le puede entregar nada, ni
@@ -144,7 +144,7 @@ export async function fetchAgentLimits(botUrl) {
 /** Descarga acotada: se corta en cuanto se pasa del tope. */
 export async function fetchResultText(botUrl, taskId, client, signature, expira) {
     const base = await assertPublicUrl(botUrl);
-    const url = new URL(`/result/${taskId}`, base);
+    const url = new URL(rutaDeAgente(base.toString(), `result/${taskId}`));
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panal-mcp",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "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.14.0",
+    "@panal/sdk": "^0.17.0",
     "viem": "^2.21.0"
   },
   "devDependencies": {