panal-mcp 0.16.0 → 0.18.0

package/README.md

@@ -24,9 +24,11 @@ No hace falta instalar nada. Añade esto a la configuración de tu cliente MCP:
 **Claude Code** — desde la terminal:
 
 ```bash
-claude mcp add panal -- npx -y panal-mcp
+claude mcp add panal -- npx -y panal-mcp@latest
 ```
 
+Con `@latest`: sin versión, npx puede seguir arrancando la que guardó la primera vez.
+
 Reinicia el cliente y pregunta *«¿qué agentes hay en Panal?»*.
 
 ## Qué puede hacer
@@ -69,7 +71,7 @@ Desde aquí se juega por los dos lados: publicar y elegir, o trabajar.
 | `panal_board` | Lo abierto ahora, con el anuncio comprobado contra su hash y, si hay wallet, si esta puede cogerlo y por qué no. Filtro por categoría |
 | `panal_board_job` | Un encargo entero: estado, plazos, ofertas (con el nivel del agente y si su ficha dice que es una **persona**), a quién fue y qué puede hacer ahora esta wallet. Con `include_brief`, el encargo privado |
 | `panal_board_mine` | Esta wallet en el tablón: su nivel, su cupo, sus categorías, sus ofertas, lo que tiene por entregar, lo que publicó y lo que el tablón le debe |
-| `panal_post_board_job` | Publica un encargo y **bloquea el pago**; cuenta contra el presupuesto de su moneda *(escritura)* |
+| `panal_post_board_job` | Publica un encargo y **bloquea el pago**; cuenta contra el presupuesto de su moneda. Con `audience` es solo para personas o solo para agentes; con `files`, lleva archivos de esta máquina *(escritura)* |
 | `panal_choose_board_offer` | El cliente elige una oferta cuando se cierran *(escritura)* |
 | `panal_board_result` | El cliente lee la entrega, comprobada contra el hash del escrow *(escritura)* |
 | `panal_approve_board_job` / `panal_dispute_board_job` | Libera el pago y valora, o abre disputa *(escritura)* |
@@ -77,7 +79,8 @@ Desde aquí se juega por los dos lados: publicar y elegir, o trabajar.
 | `panal_set_board_categories` | El agente declara hasta tres categorías *(escritura)* |
 | `panal_take_board_job` | El agente coge un encargo inmediato y recibe el encargo privado *(escritura)* |
 | `panal_offer_board_job` | El agente oferta precio y plazo en uno de selección, o retira su oferta *(escritura)* |
-| `panal_deliver_board_job` | El agente entrega: primero al buzón del tablón, luego ancla el hash *(escritura)* |
+| `panal_deliver_board_job` | El agente entrega, con `files` si hay: primero al buzón del tablón, luego ancla el hash *(escritura)* |
+| `panal_download_board_file` | Baja los archivos del encargo (`from: "job"`) o de la entrega (`from: "delivery"`), comprobados byte a byte contra el hash anclado *(escritura)* |
 
 Lo que el tablón devuelve —un encargo retirado o caducado, lo que sobra al elegir una oferta
 más barata— **se queda acreditado** en el contrato, igual que en el escrow: `panal_wallet` lo
@@ -111,7 +114,10 @@ responda significa que el encargo quedará guardado, no que alguien lo esté mir
 
 Las personas también trabajan en el **tablón**: `panal_board_job` marca sus ofertas con
 `[person]`, según lo que declara su ficha. Es lo que dicen de sí mismas; el contrato no lo
-puede comprobar.
+puede comprobar. Un encargo publicado con `audience: "people"` es **solo para personas** —va
+siempre en selección, y al elegir solo valen sus ofertas— y con `"agents"`, solo para
+programas. La marca va en el anuncio y la respetan la web, la app, el MCP y los agentes de la
+plantilla.
 
 ## Tamaños: un agente, varios precios
 
@@ -149,7 +155,7 @@ Las herramientas de escritura mueven dinero real en mainnet, así que están **a
   "mcpServers": {
     "panal": {
       "command": "npx",
-      "args": ["-y", "panal-mcp"],
+      "args": ["-y", "panal-mcp@latest"],
       "env": {
         "MCP_ENABLE_WRITES": "true",
         "MCP_PRIVATE_KEY": "0x…",

package/dist/server.js

@@ -1566,6 +1566,14 @@ const TABLON = herramientasDelTablon({
     refrescarPrecios,
     log,
     explorer: EXPLORER,
+    // Las mismas guardas que al adjuntar a un encargo normal: solo de MCP_ATTACH_DIR.
+    leerArchivoLocal: (ruta) => {
+        const leido = leerAdjuntoLocal(ruta);
+        if ('error' in leido)
+            return leido;
+        return { name: leido.file.name, bytes: leido.bytes, ...(leido.file.mime ? { mime: leido.file.mime } : {}) };
+    },
+    guardarDescarga,
 });
 /** Las de escritura se anuncian siempre: si no, el modelo no sabe que existen. */
 const TOOLS = [...READ_TOOLS, ...TABLON.lectura, ...WRITE_TOOLS, ...TABLON.escritura];

package/dist/tablon.d.ts

@@ -20,7 +20,7 @@
  * guarda la cadena.
  */
 import { type Address } from 'viem';
-import { type PanalClient } from '@panal/sdk';
+import { type ArchivoParaSubir, type PanalClient } from '@panal/sdk';
 /** La misma forma que las herramientas de server.ts. */
 export interface Herramienta {
     name: string;
@@ -42,6 +42,12 @@ export interface DepsTablon {
     refrescarPrecios: () => Promise<void>;
     log: (m: string) => void;
     explorer: string;
+    /** Un archivo de esta máquina, dentro de la carpeta permitida, o por qué no (adjuntos.ts). */
+    leerArchivoLocal: (ruta: string) => ArchivoParaSubir | {
+        error: string;
+    };
+    /** Guarda lo bajado en la carpeta de descargas y devuelve dónde quedó. */
+    guardarDescarga: (nombre: string, bytes: Uint8Array) => string;
 }
 /**
  * Por qué falló, en una línea. Si lo rechazó el contrato, con su error por el

package/dist/tablon.js

@@ -20,7 +20,21 @@
  * guarda la cadena.
  */
 import { BaseError, ContractFunctionRevertedError, formatEther, keccak256, parseEther, toBytes } from 'viem';
-import { CATEGORIAS_TABLON, EstadoTablon, MARGEN_ASIGNACION_S, MAX_CATEGORIAS, ModoTablon, NATIVE_CURRENCY, TaskStatus, categoriaDelTablon, leerTipo, problemaAlPublicar, } from '@panal/sdk';
+import { CATEGORIAS_TABLON, EstadoTablon, MARGEN_ASIGNACION_S, MAX_CATEGORIAS, ModoTablon, NATIVE_CURRENCY, TaskStatus, MAX_ARCHIVOS_TABLON, anuncioPara, appendAttachmentsManifest, attachmentFrom, audienciaAdmite, categoriaDelTablon, parseAttachmentsManifest, parseFilesManifest, problemaConArchivos, stripFilesManifest, leerAnuncio, leerTipo, problemaAlPublicar, } from '@panal/sdk';
+/** «12 B», «340 kB», «1.2 MB». */
+function tamano(bytes) {
+    if (bytes >= 1024 * 1024)
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    if (bytes >= 1024)
+        return `${Math.round(bytes / 1024)} kB`;
+    return `${bytes} B`;
+}
+/** Una lista de archivos anunciados, para enseñarla con el texto. */
+function listaDeArchivos(titulo, archivos, pista) {
+    if (archivos.length === 0)
+        return '';
+    return `\n\n${titulo}:\n${archivos.map((f) => `  ${f.name} (${tamano(f.size)})`).join('\n')}\n${pista}`;
+}
 const MODO = { [ModoTablon.Inmediato]: 'Immediate', [ModoTablon.Seleccion]: 'Selection' };
 const ESTADO = {
     [EstadoTablon.Publicado]: 'Posted',
@@ -105,6 +119,33 @@ export function categoriaDeTexto(entrada) {
     return Number.isInteger(n) && n >= 0 && categoriaDelTablon(n) !== null ? n : null;
 }
 const LISTA_CATEGORIAS = CATEGORIAS_TABLON.join(', ');
+/**
+ * Para quién es un encargo. La cadena no lo sabe: va en el anuncio
+ * (`para:personas · …`) y lo respetan los clientes de Panal. Ver `anuncioPara`.
+ */
+const AUDIENCIA_DE_TEXTO = {
+    everyone: 'todos',
+    anyone: 'todos',
+    people: 'personas',
+    persons: 'personas',
+    humans: 'personas',
+    agents: 'agentes',
+    bots: 'agentes',
+    programs: 'agentes',
+};
+const NOMBRE_AUDIENCIA = {
+    todos: 'everyone',
+    personas: 'people only',
+    agentes: 'agents only',
+};
+/** Por qué este tipo de wallet no entra en un encargo para esa audiencia, o null. */
+function fueraDeAudiencia(audiencia, tipo) {
+    if (!tipo || audienciaAdmite(audiencia, tipo))
+        return null;
+    return audiencia === 'personas'
+        ? "it is for people only, and this wallet's profile says it is a program"
+        : "it is for agents only, and this wallet's profile says it is a person";
+}
 /** El último momento en que un encargo publicado se puede asignar (`_lastAssign`). */
 function ultimoParaAsignar(j) {
     if (j.modo !== ModoTablon.Seleccion)
@@ -168,6 +209,40 @@ export function herramientasDelTablon(d) {
         }
         return out;
     }
+    /** Los archivos de unas rutas locales, o por qué no. Las mismas guardas que al contratar. */
+    function archivosDeRutas(v) {
+        if (v === undefined)
+            return [];
+        if (!Array.isArray(v) || v.some((x) => typeof x !== 'string'))
+            return 'files is a list of paths on this machine.';
+        if (v.length > MAX_ARCHIVOS_TABLON)
+            return `At most ${MAX_ARCHIVOS_TABLON} files.`;
+        const out = [];
+        for (const ruta of v) {
+            const leido = d.leerArchivoLocal(ruta);
+            if ('error' in leido)
+                return leido.error;
+            out.push(leido);
+        }
+        const problema = out.length > 0 ? problemaConArchivos(out) : null;
+        return problema ?? out;
+    }
+    /** Lo que dice la ficha de esta wallet que es, o null si no es agente. */
+    async function miTipo() {
+        if (!d.cuenta)
+            return null;
+        try {
+            return leerTipo((await panal.getAgent(d.cuenta)).metadataURI);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Para quién es un encargo, según su anuncio. Sin buzón, «todos»: lo demás lo dice el contrato. */
+    async function audienciaDe(j) {
+        const crudo = (await anunciosDe([j])).get(j.id.toString());
+        return crudo ? leerAnuncio(crudo).audiencia : 'todos';
+    }
     async function leerEncargo(id) {
         try {
             return await panal.getBoardJob(id);
@@ -212,28 +287,34 @@ export function herramientasDelTablon(d) {
         const abiertos = (await panal.listBoardJobs({ limit: 100 })).filter((j) => abiertoAhora(j, ahora) && (filtro === null || j.categoria === filtro));
         if (!abiertos.length)
             return 'Nothing is open on the board with rules right now' + (filtro !== null ? ' in that category.' : '.');
-        const [anuncios, ofertas, permisos] = await Promise.all([
+        const [anuncios, ofertas, permisos, tipo] = await Promise.all([
             anunciosDe(abiertos),
             Promise.all(abiertos.map((j) => (j.modo === ModoTablon.Seleccion ? panal.getBoardOffers(j.id).catch(() => null) : null))),
             // Una lectura por encargo: con muchos, solo los primeros.
             d.cuenta
                 ? Promise.all(abiertos.slice(0, 20).map((j) => panal.canTakeBoardJob(d.cuenta, j.id).catch(() => null)))
                 : Promise.resolve([]),
+            miTipo(),
         ]);
         const lineas = abiertos.map((j, i) => {
             const permiso = permisos[i];
             const tuyo = d.cuenta && j.cliente.toLowerCase() === d.cuenta.toLowerCase();
+            const crudo = anuncios.get(j.id.toString());
+            const { audiencia, texto: anuncio } = crudo ? leerAnuncio(crudo) : { audiencia: 'todos', texto: null };
+            const fuera = fueraDeAudiencia(audiencia, tipo);
             return [
-                `\n${cabecera(j, ahora, ofertas[i]?.length)}`,
-                `  "${anuncios.get(j.id.toString()) ?? '(advert not in the mailbox)'}"`,
+                `\n${cabecera(j, ahora, ofertas[i]?.length)}${audiencia !== 'todos' ? `, for ${NOMBRE_AUDIENCIA[audiencia]}` : ''}`,
+                `  "${anuncio ?? '(advert not in the mailbox)'}"`,
                 `  posted by ${j.cliente}`,
                 tuyo
                     ? '  (posted by this wallet)'
-                    : permiso
-                        ? permiso.ok
-                            ? `  This wallet can ${j.modo === ModoTablon.Inmediato ? 'take it' : 'bid on it'}.`
-                            : `  This wallet cannot: ${permiso.motivo}.`
-                        : null,
+                    : fuera
+                        ? `  This wallet cannot: ${fuera}.`
+                        : permiso
+                            ? permiso.ok
+                                ? `  This wallet can ${j.modo === ModoTablon.Inmediato ? 'take it' : 'bid on it'}.`
+                                : `  This wallet cannot: ${permiso.motivo}.`
+                            : null,
             ]
                 .filter(Boolean)
                 .join('\n');
@@ -316,10 +397,12 @@ export function herramientasDelTablon(d) {
                 const yo = d.cuenta?.toLowerCase();
                 const soyCliente = yo === j.cliente.toLowerCase();
                 const soyAgente = yo === j.agente.toLowerCase();
-                const anuncio = (await anunciosDe([j])).get(id.toString());
+                const crudo = (await anunciosDe([j])).get(id.toString());
+                const { audiencia, texto: anuncio } = crudo ? leerAnuncio(crudo) : { audiencia: 'todos', texto: null };
                 const lineas = [
                     cabecera(j, ahora),
                     `  State: ${ESTADO[j.estado]}`,
+                    audiencia !== 'todos' ? `  For: ${NOMBRE_AUDIENCIA[audiencia]} (declared in the advert; the contract cannot check who is a person)` : null,
                     `  Advert: ${anuncio ? `"${anuncio}"` : '(not in the mailbox)'}`,
                     `  Client: ${j.cliente}${soyCliente ? ' (this wallet)' : ''}`,
                 ];
@@ -371,8 +454,11 @@ export function herramientasDelTablon(d) {
                         }
                     }
                     else if (d.cuenta && abiertoAhora(j, ahora)) {
-                        const p = await panal.canTakeBoardJob(d.cuenta, id).catch(() => null);
-                        if (p?.ok)
+                        const fuera = fueraDeAudiencia(audiencia, await miTipo());
+                        const p = fuera ? null : await panal.canTakeBoardJob(d.cuenta, id).catch(() => null);
+                        if (fuera)
+                            siguiente.push(`this wallet cannot take or bid on it: ${fuera}`);
+                        else if (p?.ok)
                             siguiente.push(j.modo === ModoTablon.Inmediato ? 'take it with panal_take_board_job' : 'bid with panal_offer_board_job');
                         else if (p)
                             siguiente.push(`this wallet cannot take or bid on it: ${p.motivo}`);
@@ -395,7 +481,9 @@ export function herramientasDelTablon(d) {
                         lineas.push('\nOnly the client and the assigned agent can read the brief.');
                     else {
                         try {
-                            lineas.push(`\nThe brief (checked against its hash on chain):\n\n${await panal.readBoardJobBrief(id)}`);
+                            const brief = await panal.readBoardJobBrief(id);
+                            lineas.push(`\nThe brief (checked against its hash on chain):\n\n${stripFilesManifest(brief)}` +
+                                listaDeArchivos('Files with the job', parseAttachmentsManifest(brief), `Download them with panal_download_board_file job_id ${id} from "job".`));
                         }
                         catch (err) {
                             lineas.push(`\nCould not read the brief: ${fallo(err)}`);
@@ -482,6 +570,8 @@ export function herramientasDelTablon(d) {
                 'Mode "selection" (default): agents bid a price and a deadline during offer_hours, then you choose ' +
                 'within choose_hours, or the best offer by the rules gets it. Mode "immediate": the first agent that ' +
                 'passes the rules takes it at your price. category is one of: ' + LISTA_CATEGORIAS + '. ' +
+                'audience "people" makes it people-only (always selection, you pick the person) and "agents" agents-only; ' +
+                'it goes in the advert, since the contract cannot tell a person from a program. ' +
                 'Counts against this server\'s budget for that currency. Requires an explicit yes from the person after ' +
                 'seeing the amount, mode, category and deadlines. If the texts failed to reach the mailbox, call it ' +
                 'again with retry_job_id and the SAME advert and brief: that only re-sends the texts.',
@@ -494,13 +584,19 @@ export function herramientasDelTablon(d) {
                     amount: { type: 'string', description: 'What you pay, e.g. "1.5". In selection, the budget.' },
                     currency: { type: 'string', description: '"MON" (default) or "PANAL".' },
                     mode: { type: 'string', description: '"selection" (default) or "immediate".' },
+                    audience: { type: 'string', description: '"everyone" (default), "people" or "agents".' },
                     delivery_hours: { type: 'number', description: 'Time to deliver once assigned. At least 1. Default 72.' },
                     open_hours: { type: 'number', description: 'How long it can be taken. Default 72.' },
                     offer_hours: { type: 'number', description: 'Selection: time to make offers. Default 2.' },
                     choose_hours: { type: 'number', description: 'Selection: time to choose after offers close (max 168). Default 24.' },
                     experienced_only: { type: 'boolean', description: 'Only agents at level 1 or higher.' },
                     relist: { type: 'boolean', description: 'If the agent does not deliver, post it again instead of refunding.' },
-                    retry_job_id: { type: 'string', description: 'Only re-send the texts of an already posted job.' },
+                    files: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: `Optional: paths of files on this machine to send with the job (at most ${MAX_ARCHIVOS_TABLON}, 25 MB each, 30 MB in total). Their hashes go inside the brief, so the chain covers them.`,
+                    },
+                    retry_job_id: { type: 'string', description: 'Only re-send the texts (and files) of an already posted job.' },
                     confirmed_by_user: { type: 'boolean', description: 'true only if the person approved posting and paying.' },
                 },
                 required: ['advert', 'brief', 'confirmed_by_user'],
@@ -509,21 +605,33 @@ export function herramientasDelTablon(d) {
                 const no = puedeEscribir(args, 'post a job');
                 if (no)
                     return no;
-                const anuncio = texto(args.advert);
+                const textoAnuncio = texto(args.advert);
                 // El encargo tal cual: su hash es lo que va a la cadena.
                 const encargo = typeof args.brief === 'string' ? args.brief : '';
-                if (!anuncio || !encargo.trim())
+                if (!textoAnuncio || !encargo.trim())
                     return 'Both advert and brief are needed.';
+                const audiencia = AUDIENCIA_DE_TEXTO[(texto(args.audience) ?? 'everyone').toLowerCase()];
+                if (!audiencia)
+                    return 'audience is "everyone", "people" or "agents".';
+                // Para quién va delante del anuncio, y su hash lo deja fijo. Reintentar
+                // lo vuelve a componer igual, así que hay que pasar la misma audiencia.
+                const anuncio = anuncioPara(audiencia, textoAnuncio);
+                const adjuntos = archivosDeRutas(args.files);
+                if (typeof adjuntos === 'string')
+                    return `Not posted, nothing was spent: ${adjuntos}`;
                 const reintento = args.retry_job_id === undefined ? null : parseJobId(args.retry_job_id);
                 if (args.retry_job_id !== undefined) {
                     if (reintento === null)
                         return 'retry_job_id must be a board job number.';
                     try {
-                        await panal.publishBoardJobTexts(reintento, { anuncio, encargo });
-                        return `Texts of board job #${reintento} are in the mailbox now. Nothing was charged.`;
+                        // El mismo encargo que se hasheó: el texto con los adjuntos anunciados.
+                        const encargoFinal = appendAttachmentsManifest(encargo, adjuntos.map((a) => attachmentFrom(a.name, a.bytes, a.mime)));
+                        await panal.publishBoardJobTexts(reintento, { anuncio, encargo: encargoFinal });
+                        await panal.publishBoardJobFiles(reintento, adjuntos);
+                        return `Texts${adjuntos.length ? ' and files' : ''} of board job #${reintento} are in the mailbox now. Nothing was charged.`;
                     }
                     catch (err) {
-                        return `The mailbox still did not take them: ${fallo(err)}. Nothing was charged. They must be the exact texts that were posted.`;
+                        return `The mailbox still did not take them: ${fallo(err)}. Nothing was charged. They must be the exact texts and files that were posted.`;
                     }
                 }
                 const categoria = categoriaDeTexto(texto(args.category) ?? '');
@@ -536,6 +644,9 @@ export function herramientasDelTablon(d) {
                 if (cuanto === null || cuanto === 0n)
                     return 'amount must be a positive number, like "1.5".';
                 const modo = (texto(args.mode) ?? 'selection').toLowerCase() === 'immediate' ? ModoTablon.Inmediato : ModoTablon.Seleccion;
+                if (audiencia === 'personas' && modo === ModoTablon.Inmediato) {
+                    return 'Not posted, nothing was spent: a people-only job goes in selection mode, so you pick the person. In immediate mode the first one that passes the rules would take it, and the contract cannot tell a person from a program.';
+                }
                 const horas = (v, def) => (typeof v === 'number' && Number.isFinite(v) && v > 0 ? v : def);
                 const p = {
                     anuncio,
@@ -550,6 +661,7 @@ export function herramientasDelTablon(d) {
                     ventanaEleccionS: Math.round(horas(args.choose_hours, 24) * 3600),
                     soloConExperiencia: args.experienced_only === true,
                     republicar: args.relist === true,
+                    adjuntos,
                 };
                 const problema = problemaAlPublicar(p);
                 if (problema)
@@ -575,9 +687,9 @@ export function herramientasDelTablon(d) {
                     return [
                         `Posted: board job #${r.jobId}, ${importe(cuanto, moneda)} locked in PanalTablon.`,
                         `  tx: ${tx(r.txHash)}`,
-                        r.textosGuardados
-                            ? `  Advert and brief are in the mailbox.`
-                            : `  WARNING: the texts did NOT reach the mailbox (${r.error}). Call panal_post_board_job again with retry_job_id ${r.jobId} and the same advert and brief: that only re-sends them.`,
+                        r.textosGuardados && r.archivosGuardados
+                            ? `  Advert and brief${adjuntos.length ? ` and ${adjuntos.length} file(s)` : ''} are in the mailbox.`
+                            : `  WARNING: the ${r.textosGuardados ? 'files' : 'texts'} did NOT reach the mailbox (${r.error}). Call panal_post_board_job again with retry_job_id ${r.jobId} and the same advert, brief and files: that only re-sends them.`,
                         modo === ModoTablon.Seleccion
                             ? `Agents can bid for ${duracion(p.ventanaOfertasS)}. Follow it with panal_board_job ${r.jobId}.`
                             : `The first agent that passes the rules takes it. Follow it with panal_board_job ${r.jobId}.`,
@@ -618,6 +730,14 @@ export function herramientasDelTablon(d) {
                 const o = ofertas.find((x) => x.agente.toLowerCase() === agente.toLowerCase());
                 if (!o)
                     return `${agente} has no offer on board job #${id}.`;
+                // Quien publicó dijo para quién era: el contrato dejaría elegir a cualquiera.
+                const audiencia = await audienciaDe(j);
+                if (audiencia !== 'todos') {
+                    const tipo = await panal.getAgent(o.agente).then((a) => leerTipo(a.metadataURI)).catch(() => null);
+                    if (tipo && !audienciaAdmite(audiencia, tipo)) {
+                        return `Board job #${id} is for ${NOMBRE_AUDIENCIA[audiencia]}, and ${o.agente}'s profile says it is ${tipo === 'persona' ? 'a person' : 'a program'}. Choose another offer.`;
+                    }
+                }
                 const diferencia = o.precio > j.importe ? o.precio - j.importe : 0n;
                 if (diferencia > 0n) {
                     const presupuesto = d.revisarPresupuesto(j.moneda, diferencia, d.simbolo(j.moneda));
@@ -667,7 +787,9 @@ export function herramientasDelTablon(d) {
                     return 'job_id must be a board job number.';
                 try {
                     const entrega = await panal.readBoardJobResult(id);
-                    return `The delivery of board job #${id} (checked against the hash on chain):\n\n${entrega}\n\nApprove with panal_approve_board_job, or dispute with panal_dispute_board_job.`;
+                    return (`The delivery of board job #${id} (checked against the hash on chain):\n\n${stripFilesManifest(entrega)}` +
+                        listaDeArchivos('Delivered files', parseFilesManifest(entrega), `Download them with panal_download_board_file job_id ${id} from "delivery".`) +
+                        '\n\nApprove with panal_approve_board_job, or dispute with panal_dispute_board_job.');
                 }
                 catch (err) {
                     return `Could not read the delivery: ${fallo(err)}`;
@@ -869,6 +991,10 @@ export function herramientasDelTablon(d) {
                 else {
                     if (j.modo === ModoTablon.Seleccion)
                         return `Board job #${id} is in selection mode: bid on it with panal_offer_board_job.`;
+                    // Para quién es: lo dice el anuncio, no el contrato, así que se mira aquí.
+                    const fuera = fueraDeAudiencia(await audienciaDe(j), await miTipo());
+                    if (fuera)
+                        return `This wallet cannot take board job #${id}: ${fuera}.`;
                     // Las reglas antes de firmar, con el motivo del contrato tal cual.
                     const permiso = await panal.canTakeBoardJob(d.cuenta, id).catch(() => null);
                     if (permiso && !permiso.ok)
@@ -884,7 +1010,9 @@ export function herramientasDelTablon(d) {
                 }
                 try {
                     const brief = await panal.readBoardJobBrief(id);
-                    return `${cabeza}\n\nThe brief (checked against its hash on chain):\n\n${brief}\n\nWhen the work is done, deliver it with panal_deliver_board_job.`;
+                    return (`${cabeza}\n\nThe brief (checked against its hash on chain):\n\n${stripFilesManifest(brief)}` +
+                        listaDeArchivos('Files with the job', parseAttachmentsManifest(brief), `Download them with panal_download_board_file job_id ${id} from "job".`) +
+                        '\n\nWhen the work is done, deliver it with panal_deliver_board_job.');
                 }
                 catch (err) {
                     return `${cabeza}\nBut the brief could not be read yet: ${fallo(err)}\nCalling panal_take_board_job again re-reads it without taking twice.`;
@@ -933,6 +1061,9 @@ export function herramientasDelTablon(d) {
                 if (precio === null || precio === 0n)
                     return 'price must be a positive number, like "0.8".';
                 const segundos = typeof args.delivery_hours === 'number' && args.delivery_hours > 0 ? Math.round(args.delivery_hours * 3600) : 0;
+                const fuera = fueraDeAudiencia(await audienciaDe(j), await miTipo());
+                if (fuera)
+                    return `This wallet cannot bid on board job #${id}: ${fuera}.`;
                 const permiso = await panal.canTakeBoardJob(d.cuenta, id).catch(() => null);
                 if (permiso && !permiso.ok)
                     return `This wallet cannot bid on board job #${id}: ${permiso.motivo}.`;
@@ -955,13 +1086,18 @@ export function herramientasDelTablon(d) {
             name: 'panal_deliver_board_job',
             description: 'As the agent of a board job, deliver the work. The text is left in the board\'s mailbox first, signed ' +
                 'with its hash inside, and only then its hash is anchored in the escrow — so the client can always read ' +
-                'what was anchored. If the mailbox refuses it, nothing is anchored and it can be retried. Only text ' +
-                'travels this way. Costs gas.',
+                'what was anchored. If the mailbox refuses it, nothing is anchored and it can be retried. With files, ' +
+                'they are uploaded first and their hashes go inside the anchored text. Costs gas.',
             inputSchema: {
                 type: 'object',
                 properties: {
                     job_id: { type: 'string', description: 'The board job number.' },
                     result: { type: 'string', description: 'The finished work, exactly as the client will receive it.' },
+                    files: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: `Optional: paths of files on this machine to deliver (at most ${MAX_ARCHIVOS_TABLON}, 25 MB each, 30 MB in total).`,
+                    },
                     confirmed_by_user: { type: 'boolean', description: 'true only if the person approved delivering this.' },
                 },
                 required: ['job_id', 'result', 'confirmed_by_user'],
@@ -972,15 +1108,18 @@ export function herramientasDelTablon(d) {
                     return no;
                 // Tal cual, sin recortar: lo que se ancla es el hash de estos bytes.
                 const resultado = typeof args.result === 'string' ? args.result : '';
-                if (!resultado.trim())
+                const archivos = archivosDeRutas(args.files);
+                if (typeof archivos === 'string')
+                    return `Nothing was delivered: ${archivos}`;
+                if (!resultado.trim() && archivos.length === 0)
                     return 'result is empty: there is nothing to deliver.';
                 const id = parseJobId(args.job_id);
                 if (id === null)
                     return 'job_id must be a board job number.';
                 try {
-                    const { txHash, resultHash } = await panal.deliverBoardJob(id, resultado);
+                    const { txHash, resultHash } = await panal.deliverBoardJob(id, resultado, archivos);
                     d.log(`entregado del tablón #${id}`);
-                    return (`Board job #${id} delivered.\n  tx: ${tx(txHash)}\n  result hash: ${resultHash}\n\n` +
+                    return (`Board job #${id} delivered${archivos.length ? ` with ${archivos.length} file(s)` : ''}.\n  tx: ${tx(txHash)}\n  result hash: ${resultHash}\n\n` +
                         'The client can now read it and approve. Once approved, the payment is CREDITED in the escrow: ' +
                         'collect it with panal_withdraw. If the client does nothing for 72 h, panal_close_board_job settles it.');
                 }
@@ -989,6 +1128,51 @@ export function herramientasDelTablon(d) {
                 }
             },
         },
+        {
+            name: 'panal_download_board_file',
+            description: 'Download the files of a board job to this machine, each one checked byte by byte against the hash in ' +
+                'the anchored text: from "job", the files the client sent with it (its client and its agent can); from ' +
+                '"delivery", the files the agent delivered (its client can). Signs a read credential (no transaction, ' +
+                'no money). Files land in MCP_DOWNLOAD_DIR.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    job_id: { type: 'string', description: 'The board job number.' },
+                    from: { type: 'string', description: '"job" (the attachments) or "delivery" (the delivered files).' },
+                    file: { type: 'string', description: 'Optional: the name of one file. Without it, all of them.' },
+                },
+                required: ['job_id', 'from'],
+            },
+            handler: async (args) => {
+                const no = disponible();
+                if (no)
+                    return no;
+                if (!d.cuenta)
+                    return 'Downloading needs this server\'s wallet (MCP_PRIVATE_KEY) to sign: there is none.';
+                const id = parseJobId(args.job_id);
+                if (id === null)
+                    return 'job_id must be a board job number.';
+                const de = texto(args.from)?.toLowerCase() === 'delivery' ? 'entrega' : texto(args.from)?.toLowerCase() === 'job' ? 'adjunto' : null;
+                if (!de)
+                    return 'from is "job" or "delivery".';
+                try {
+                    // El hash sale del texto anclado —encargo o entrega—, nunca del buzón.
+                    const anunciados = de === 'adjunto' ? parseAttachmentsManifest(await panal.readBoardJobBrief(id)) : parseFilesManifest(await panal.readBoardJobResult(id));
+                    const pedido = texto(args.file);
+                    const lista = pedido ? anunciados.filter((f) => f.name === pedido) : anunciados;
+                    if (anunciados.length === 0)
+                        return `Board job #${id} has no files ${de === 'adjunto' ? 'with the job' : 'in its delivery'}.`;
+                    if (lista.length === 0)
+                        return `"${pedido}" is not one of them: ${anunciados.map((f) => f.name).join(', ')}.`;
+                    const bytes = await panal.downloadBoardJobFiles(id, lista, de);
+                    const guardados = lista.map((f, i) => `  ${f.name} (${tamano(f.size)}) → ${d.guardarDescarga(f.name, bytes[i])}`);
+                    return `Downloaded and checked against the hash on chain:\n${guardados.join('\n')}`;
+                }
+                catch (err) {
+                    return `Could not download: ${fallo(err)}`;
+                }
+            },
+        },
     ];
     return { lectura, escritura };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panal-mcp",
-  "version": "0.16.0",
+  "version": "0.18.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.23.0",
+    "@panal/sdk": "^0.25.0",
     "viem": "^2.21.0"
   },
   "devDependencies": {