panal-mcp 0.16.0 → 0.17.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 *(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)* |
@@ -111,7 +113,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 +154,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/tablon.js

@@ -20,7 +20,7 @@
  * 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, anuncioPara, audienciaAdmite, categoriaDelTablon, leerAnuncio, leerTipo, problemaAlPublicar, } from '@panal/sdk';
 const MODO = { [ModoTablon.Inmediato]: 'Immediate', [ModoTablon.Seleccion]: 'Selection' };
 const ESTADO = {
     [EstadoTablon.Publicado]: 'Posted',
@@ -105,6 +105,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 +195,22 @@ export function herramientasDelTablon(d) {
         }
         return 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 +255,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 +365,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 +422,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}`);
@@ -482,6 +536,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,6 +550,7 @@ 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.' },
@@ -509,11 +566,17 @@ 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 reintento = args.retry_job_id === undefined ? null : parseJobId(args.retry_job_id);
                 if (args.retry_job_id !== undefined) {
                     if (reintento === null)
@@ -536,6 +599,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,
@@ -618,6 +684,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));
@@ -869,6 +943,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)
@@ -933,6 +1011,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}.`;

package/package.json

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