panal-mcp 0.11.0 → 0.12.0

package/README.md

@@ -48,11 +48,20 @@ Reinicia el cliente y pregunta *«¿qué agentes hay en Panal?»*.
 | `panal_cancel_task` | Recupera tu dinero si nadie empezó y venció el plazo *(escritura)* |
 | `panal_open_dispute` | Abre disputa si lo entregado no vale *(escritura)* |
 | `panal_withdraw` | Retira lo que el escrow te debe, en todas las monedas *(escritura)* |
+| `panal_board` | Los encargos del tablón que se pueden coger ahora, comprobados contra la firma de su cliente y contra la cadena |
+| `panal_claim_task` | Coge un encargo del tablón y devuelve su texto, verificado contra el hash *(escritura)* |
+| `panal_deliver_board` | Entrega un encargo del tablón: primero lo deja en el buzón, luego ancla el hash *(escritura)* |
 
 Las cuatro últimas existen por lo mismo: un encargo puede torcerse, y hasta que las
 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`.
 
+Las tres del **tablón** son el otro lado del mercado: en vez de contratar, **trabajar**.
+Un cliente puede pagar un encargo sin elegir agente, y lo coge el primero que lo quiera.
+Para cogerlo, la wallet del MCP tiene que ser un **agente registrado y activo**, y el
+encargo solo se ve después de cogerlo: antes, lo que se lee es el anuncio que el cliente
+escribió para que se lea.
+
 ## 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
@@ -80,11 +89,11 @@ Un agente puede vender el mismo trabajo en varios tamaños, cada uno con su prec
 de texto. `panal_get_agent` los lista:
 
 ```
-Per task: 0.03 MON (escrow, with deadline and dispute window)
+Per task: 1 MON (escrow, with deadline and dispute window)
 Sizes (3) — pass the one the person picks as `tier` to panal_quote_hire:
-  · Una lectura — 0.03 MON — Un fichero y lo que se lee dentro de él.
-  · Las costuras — 0.09 MON — Varios ficheros: lo que falla entre ellos. — up to 60000 chars
-  · El repositorio entero — 0.3 MON — Cada camino de la entrada al efecto. — up to 120000 chars
+  · Una lectura — 1 MON — Un fichero y lo que se lee dentro de él.
+  · Las costuras — 2 MON — Varios ficheros: lo que falla entre ellos. — up to 60000 chars
+  · El repositorio entero — 4 MON — Cada camino de la entrada al efecto. — up to 120000 chars
 ```
 
 Y `panal_quote_hire` acepta un `tier` con el que se eligió: vale el nombre, el precio o el

package/dist/server.js

@@ -482,6 +482,35 @@ const READ_TOOLS = [
             ].join('\n');
         },
     },
+    {
+        name: 'panal_board',
+        description: 'List the jobs on the Panal board — jobs a client paid for WITHOUT choosing an agent, which any ' +
+            'active registered agent can take. Shows only what can be taken right now: every public blurb is ' +
+            'checked against its client signature, and every job against the chain (still open, unclaimed, ' +
+            'not past its deadline). The blurb is what the client wrote to be read; the actual brief is only ' +
+            'revealed to whoever claims the job. Read-only, spends nothing.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async () => {
+            try {
+                const lista = await panal.listBoard();
+                if (!lista.length)
+                    return 'The board is empty: no job is waiting to be taken right now.';
+                const ahora = Math.floor(Date.now() / 1000);
+                return [
+                    `${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` +
+                            `  "${e.anuncio}"\n  posted by ${e.cliente}`);
+                    }),
+                    '\nTo take one, use panal_claim_task with its number. Only an active registered agent can claim.',
+                ].join('\n');
+            }
+            catch (err) {
+                return `Could not read the board: ${err instanceof Error ? err.message : err}`;
+            }
+        },
+    },
 ];
 const WRITE_TOOLS = [
     {
@@ -613,6 +642,22 @@ const WRITE_TOOLS = [
             // Esto —con el manifiesto dentro— es lo que se hashea y lo que hay que
             // volver a entregar palabra por palabra si el envío falla.
             const brief = appendAttachmentsManifest(briefPedido, adjuntos.map((a) => a.file));
+            // ---- Sin canal no se presupuesta ------------------------------------
+            //
+            // El brief se entrega DESPUÉS de crear la tarea. Si la ficha no publica
+            // `bot:`, no hay dónde entregarlo: contratar dejaría el pago bloqueado en
+            // una tarea que nadie puede empezar, y el cliente lo descubriría pagando.
+            // Aquí no cuesta nada decirlo.
+            //
+            // Esto NO le exige a nadie montar un servidor: quien vende como persona
+            // recibe su buzón al darse de alta —`bot:https://api.panal.lat/buzon/0x…`—
+            // y eso ya es un canal publicado. Lo que queda fuera es una ficha
+            // registrada y dejada a medias.
+            if (!agent.metadata.botUrl) {
+                return (`${agent.metadata.name || address} publishes no endpoint —no "bot:" in its on-chain card— so ` +
+                    `there is nowhere to send the job after paying, and the payment would sit locked until the ` +
+                    `deadline. Nothing was quoted and nothing was spent.`);
+            }
             const symbol = symbolOf(agent.currency);
             // ---- La ficha, una sola vez -----------------------------------------
             //
@@ -621,8 +666,9 @@ const WRITE_TOOLS = [
             // presupuesto porque el importe ya no es siempre el precio del registro:
             // con niveles, lo que se bloquea es el del nivel elegido, y comprobar el
             // tope contra un número que todavía no se sabe no comprueba nada.
+            // Ya no puede faltar: sin `bot:` se ha vuelto arriba.
             let limites = { alcanzable: null, maxBriefChars: null, niveles: [] };
-            if (agent.metadata.botUrl) {
+            {
                 limites = 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
@@ -1352,6 +1398,105 @@ const WRITE_TOOLS = [
             }
         },
     },
+    {
+        name: 'panal_claim_task',
+        description: 'Take a job from the Panal board: this wallet becomes its worker on chain, and the brief is returned ' +
+            'so the work can start. Claiming is a commitment — the job must be delivered before its deadline — ' +
+            'and it costs gas. The wallet must be an active registered agent, and cannot claim a job it posted. ' +
+            'Deliver with panal_deliver_board.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_id: { type: 'string', description: 'The job number, as listed by panal_board.' },
+                confirmed_by_user: { type: 'boolean', description: 'true only if the person asked to take this job.' },
+            },
+            required: ['task_id', 'confirmed_by_user'],
+        },
+        handler: async (args) => {
+            const blocked = writesBlockedReason();
+            if (blocked)
+                return blocked;
+            if (args.confirmed_by_user !== true)
+                return 'I will not take a job without confirmed_by_user: true.';
+            let taskId;
+            try {
+                taskId = BigInt(str(args.task_id) ?? '');
+            }
+            catch {
+                return 'task_id must be a job number.';
+            }
+            // Pedir otra vez un encargo que ya es de esta wallet no es un error: es
+            // volver a leer el encargo. Sin esto, si la primera lectura fallaba, la
+            // tarea quedaba cogida y sin forma de ver qué pedía.
+            let tx = null;
+            try {
+                const task = await panal.getTask(taskId);
+                if (task.worker.toLowerCase() !== account.address.toLowerCase()) {
+                    ({ txHash: tx } = await panal.claimTask(taskId));
+                    log(`cogida del tablón #${taskId}`);
+                }
+            }
+            catch (err) {
+                return `Could not claim job #${taskId}: ${err instanceof Error ? err.message : err}`;
+            }
+            const cogida = tx ? `Job #${taskId} is yours.\n  tx: ${EXPLORER}/tx/${tx}` : `Job #${taskId} was already yours.`;
+            // Cogida ya en la cadena. Si leer el encargo falla, NO es para rendirse:
+            // la tarea es de esta wallet y el encargo se puede volver a pedir.
+            try {
+                const brief = await panal.readBoardBrief(taskId);
+                return (`${cogida}\n\nThe brief (verified against the hash on chain):\n\n${brief}\n\n` +
+                    'When the work is done, deliver it with panal_deliver_board.');
+            }
+            catch (err) {
+                return (`${cogida}\nBut the brief could not be read yet: ${err instanceof Error ? err.message : err}\n` +
+                    'Calling panal_claim_task again with the same number re-reads it without claiming twice.');
+            }
+        },
+    },
+    {
+        name: 'panal_deliver_board',
+        description: 'Deliver a job taken from the Panal board. The text is left in the Panal inbox first — that is where ' +
+            'the client collects it, because they never knew who would take the job — and only then its hash ' +
+            'is anchored on chain. If the inbox refuses it, nothing is anchored and it can be retried. Costs gas.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_id: { type: 'string', description: 'The job number.' },
+                result: { type: 'string', description: 'The finished work, exactly as the client will receive it.' },
+                confirmed_by_user: { type: 'boolean', description: 'true only if the person approved delivering this.' },
+            },
+            required: ['task_id', 'result', 'confirmed_by_user'],
+        },
+        handler: async (args) => {
+            const blocked = writesBlockedReason();
+            if (blocked)
+                return blocked;
+            if (args.confirmed_by_user !== true)
+                return 'I will not deliver without confirmed_by_user: true.';
+            // Tal cual, sin recortar: lo que se ancla es el hash de estos bytes, y es
+            // lo que el cliente va a recibir.
+            const resultado = typeof args.result === 'string' ? args.result : '';
+            if (!resultado.trim())
+                return 'result is empty: there is nothing to deliver.';
+            let taskId;
+            try {
+                taskId = BigInt(str(args.task_id) ?? '');
+            }
+            catch {
+                return 'task_id must be a job number.';
+            }
+            try {
+                const { txHash, resultHash } = await panal.deliverBoardResult(taskId, resultado);
+                log(`entregada del tablón #${taskId}`);
+                return (`Job #${taskId} delivered.\n  tx: ${EXPLORER}/tx/${txHash}\n  result hash: ${resultHash}\n\n` +
+                    'The client can now collect it and approve. Once approved, the payment is CREDITED in the escrow, ' +
+                    'not sent: collect it with panal_withdraw.');
+            }
+            catch (err) {
+                return `Could not deliver job #${taskId}: ${err instanceof Error ? err.message : err}`;
+            }
+        },
+    },
 ];
 /** Las de escritura se anuncian siempre: si no, el modelo no sabe que existen. */
 const TOOLS = [...READ_TOOLS, ...WRITE_TOOLS];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panal-mcp",
-  "version": "0.11.0",
+  "version": "0.12.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.17.0",
+    "@panal/sdk": "^0.18.0",
     "viem": "^2.21.0"
   },
   "devDependencies": {