@panal/sdk 0.22.0 → 0.24.0

package/README.md

@@ -226,6 +226,18 @@ octubre de 2026, en `0x2Cfc6803E269fa9BF728e202736a7bc0547ae149`, con los topes
 ninguno, `boardJobsAvailable` es `false` y los métodos lo dicen; para probar
 otro se pasa su dirección en `addresses.tablon`.
 
+Las categorías son números (el `category` de la cadena); `CATEGORIAS_TABLON`
+dice cuál es cuál —`categoriaDelTablon(10)` es `'traduccion'`— y su orden no
+cambia nunca.
+
+**Solo personas o solo agentes.** El contrato no sabe quién es persona —lo
+declara cada uno en su ficha—, así que va en el anuncio, delante del texto:
+`anuncioPara('personas', 'Leer un cuento en voz alta')` da
+`para:personas · Leer un cuento en voz alta`, y `leerAnuncio` lo parte otra vez
+en `{ audiencia, texto }`. `audienciaAdmite(audiencia, leerTipo(ficha))` dice si
+una wallet entra. `problemaAlPublicar` no deja publicar uno solo para personas
+en inmediato: va en selección, donde elige el cliente.
+
 ```ts
 import { ModoTablon } from '@panal/sdk';
 

package/dist/index.d.ts

@@ -54,5 +54,5 @@ export type { Idioma } from './idiomas.js';
 export { MERCADO_PANAL, PRECIO_MAX_EDAD_S, PYTH_MONAD, PYTH_MON_USD, enDolares, esFresco, formatearDolares, leerPrecios, valorDeVenta, } from './precios.js';
 export type { FuentePrecio, MonedaConPrecio, OpcionesPrecios, Precio, Precios } from './precios.js';
 export { panalTablonAbi } from './tablon-abi.js';
-export { EstadoTablon, MARGEN_ASIGNACION_S, MAX_CATEGORIAS, MAX_OFERTAS, MAX_VENTANA_ELECCION_S, MIN_PLAZO_ENTREGA_S, ModoTablon, categoriasDeMascara, claveDeCampana, encargoDeLaCadena, idDeCampana, ofertaDeLaCadena, problemaAlPublicar, situacionDe, tablonEncargoSignMessage, tablonEntregaSignMessage, tablonResultadoSignMessage, } from './tablon-reglas.js';
-export type { EncargoConReglas, OfertaConReglas, PublicarEnElTablon, SituacionEnElTablon, } from './tablon-reglas.js';
+export { CATEGORIAS_TABLON, EstadoTablon, MARGEN_ASIGNACION_S, MAX_ANUNCIO, MAX_CATEGORIAS, MAX_TEXTO_ANUNCIO, MAX_OFERTAS, MAX_VENTANA_ELECCION_S, MIN_PLAZO_ENTREGA_S, ModoTablon, anuncioPara, audienciaAdmite, categoriaDelTablon, categoriasDeMascara, claveDeCampana, encargoDeLaCadena, idDeCampana, leerAnuncio, ofertaDeLaCadena, problemaAlPublicar, situacionDe, tablonEncargoSignMessage, tablonEntregaSignMessage, tablonResultadoSignMessage, } from './tablon-reglas.js';
+export type { AudienciaTablon, CategoriaTablon, EncargoConReglas, OfertaConReglas, PublicarEnElTablon, SituacionEnElTablon, } from './tablon-reglas.js';

package/dist/index.js

@@ -67,4 +67,4 @@ export { MERCADO_PANAL, PRECIO_MAX_EDAD_S, PYTH_MONAD, PYTH_MON_USD, enDolares,
 // el cliente (`…BoardJob`); aquí, el ABI, los tipos y lo que se calcula sin la
 // cadena. Ver tablon-reglas.ts y contracts/BOARD.md.
 export { panalTablonAbi } from './tablon-abi.js';
-export { EstadoTablon, MARGEN_ASIGNACION_S, MAX_CATEGORIAS, MAX_OFERTAS, MAX_VENTANA_ELECCION_S, MIN_PLAZO_ENTREGA_S, ModoTablon, categoriasDeMascara, claveDeCampana, encargoDeLaCadena, idDeCampana, ofertaDeLaCadena, problemaAlPublicar, situacionDe, tablonEncargoSignMessage, tablonEntregaSignMessage, tablonResultadoSignMessage, } from './tablon-reglas.js';
+export { CATEGORIAS_TABLON, EstadoTablon, MARGEN_ASIGNACION_S, MAX_ANUNCIO, MAX_CATEGORIAS, MAX_TEXTO_ANUNCIO, MAX_OFERTAS, MAX_VENTANA_ELECCION_S, MIN_PLAZO_ENTREGA_S, ModoTablon, anuncioPara, audienciaAdmite, categoriaDelTablon, categoriasDeMascara, claveDeCampana, encargoDeLaCadena, idDeCampana, leerAnuncio, ofertaDeLaCadena, problemaAlPublicar, situacionDe, tablonEncargoSignMessage, tablonEntregaSignMessage, tablonResultadoSignMessage, } from './tablon-reglas.js';

package/dist/tablon-reglas.d.ts

@@ -18,6 +18,7 @@
  * rechazaría. Lo que lee y firma está en client.ts.
  */
 import { type Address, type Hex } from 'viem';
+import type { TipoDeAgente } from './tipo.js';
 /** Cómo se asigna un encargo. */
 export declare enum ModoTablon {
     /** El primero que pasa las reglas se lo queda. */
@@ -90,6 +91,45 @@ export declare const MAX_VENTANA_ELECCION_S: number;
 export declare const MARGEN_ASIGNACION_S: number;
 export declare const MAX_CATEGORIAS = 3;
 export declare const MAX_OFERTAS = 50;
+/**
+ * Las categorías del tablón, por su número en la cadena: la posición en esta
+ * lista ES el `category` del contrato. Por eso no se reordena ni se borra
+ * nada: un encargo publicado como 10 sería «traducción» para siempre, y un
+ * agente que declaró el 10 seguiría viendo los suyos. Una nueva va al final.
+ *
+ * Las ocho primeras son las del marketplace, en su orden (`AgentCategory` en
+ * la web); las demás, las de BOARD.md §6.2. Cerrada en 16 (decisión 6). Los
+ * nombres son claves, no textos: cada interfaz los traduce.
+ */
+export declare const CATEGORIAS_TABLON: readonly ["datos", "texto", "codigo", "vision", "legal", "defi", "creativo", "humanos", "video", "audio", "traduccion", "investigacion", "marketing", "automatizacion", "soporte", "otros"];
+export type CategoriaTablon = (typeof CATEGORIAS_TABLON)[number];
+/** El nombre de una categoría por su número, o `null` si no está en la lista. */
+export declare function categoriaDelTablon(numero: number): CategoriaTablon | null;
+/**
+ * Para quién es un encargo: cualquiera, solo personas o solo agentes.
+ *
+ * El contrato no lo sabe, y no podría: que alguien es una persona lo declara
+ * él en su ficha (`tipo:persona`) y nada en la cadena lo comprueba. Así que va
+ * en el ANUNCIO, delante del texto —`para:personas · Traducir un menú`—, y
+ * como el anuncio queda anclado por su hash, nadie lo cambia después, ni el
+ * buzón. Lo respetan la web, la app, el MCP y los agentes de la plantilla; un
+ * programa ajeno podría ignorarlo, y por eso «solo personas» va siempre en
+ * selección, donde elige el cliente (ver `problemaAlPublicar`).
+ */
+export type AudienciaTablon = 'todos' | 'personas' | 'agentes';
+/** Lo que cabe en un anuncio: el buzón no guarda más (bot/src/buzon.ts). */
+export declare const MAX_ANUNCIO = 500;
+/** Lo que puede escribir quien publica, dejando sitio a la marca de audiencia. */
+export declare const MAX_TEXTO_ANUNCIO: number;
+/** El anuncio partido: para quién es y el texto que se enseña, sin la marca. */
+export declare function leerAnuncio(anuncio: string): {
+    audiencia: AudienciaTablon;
+    texto: string;
+};
+/** El anuncio tal como se publica (y se hashea), con su marca si la lleva. */
+export declare function anuncioPara(audiencia: AudienciaTablon, texto: string): string;
+/** Si alguien de ese tipo puede coger u ofertar en un encargo para esa audiencia. */
+export declare function audienciaAdmite(audiencia: AudienciaTablon, tipo: TipoDeAgente): boolean;
 /**
  * La clave de una campaña: `keccak256(abi.encode(publicador, id))`. Cada
  * campaña es de quien la publica (F4 en la revisión de seguridad), así que el

package/dist/tablon-reglas.js

@@ -41,6 +41,62 @@ export const MAX_VENTANA_ELECCION_S = 7 * 24 * 60 * 60;
 export const MARGEN_ASIGNACION_S = 24 * 60 * 60;
 export const MAX_CATEGORIAS = 3;
 export const MAX_OFERTAS = 50;
+/**
+ * Las categorías del tablón, por su número en la cadena: la posición en esta
+ * lista ES el `category` del contrato. Por eso no se reordena ni se borra
+ * nada: un encargo publicado como 10 sería «traducción» para siempre, y un
+ * agente que declaró el 10 seguiría viendo los suyos. Una nueva va al final.
+ *
+ * Las ocho primeras son las del marketplace, en su orden (`AgentCategory` en
+ * la web); las demás, las de BOARD.md §6.2. Cerrada en 16 (decisión 6). Los
+ * nombres son claves, no textos: cada interfaz los traduce.
+ */
+export const CATEGORIAS_TABLON = [
+    'datos',
+    'texto',
+    'codigo',
+    'vision',
+    'legal',
+    'defi',
+    'creativo',
+    'humanos',
+    'video',
+    'audio',
+    'traduccion',
+    'investigacion',
+    'marketing',
+    'automatizacion',
+    'soporte',
+    'otros',
+];
+/** El nombre de una categoría por su número, o `null` si no está en la lista. */
+export function categoriaDelTablon(numero) {
+    return CATEGORIAS_TABLON[numero] ?? null;
+}
+const MARCA_AUDIENCIA = /^para:(personas|agentes)\s*·\s*/i;
+/** Lo que cabe en un anuncio: el buzón no guarda más (bot/src/buzon.ts). */
+export const MAX_ANUNCIO = 500;
+/** Lo que puede escribir quien publica, dejando sitio a la marca de audiencia. */
+export const MAX_TEXTO_ANUNCIO = MAX_ANUNCIO - 'para:personas · '.length;
+/** El anuncio partido: para quién es y el texto que se enseña, sin la marca. */
+export function leerAnuncio(anuncio) {
+    const m = MARCA_AUDIENCIA.exec(anuncio);
+    if (!m)
+        return { audiencia: 'todos', texto: anuncio };
+    return { audiencia: m[1].toLowerCase(), texto: anuncio.slice(m[0].length) };
+}
+/** El anuncio tal como se publica (y se hashea), con su marca si la lleva. */
+export function anuncioPara(audiencia, texto) {
+    // Sin la marca que trajera ya: dos marcas se leerían como texto.
+    const limpio = leerAnuncio(texto.trim()).texto.trim();
+    return audiencia === 'todos' ? limpio : `para:${audiencia} · ${limpio}`;
+}
+/** Si alguien de ese tipo puede coger u ofertar en un encargo para esa audiencia. */
+export function audienciaAdmite(audiencia, tipo) {
+    if (audiencia === 'todos')
+        return true;
+    return audiencia === 'personas' ? tipo === 'persona' : tipo === 'bot';
+}
 /**
  * La clave de una campaña: `keccak256(abi.encode(publicador, id))`. Cada
  * campaña es de quien la publica (F4 en la revisión de seguridad), así que el
@@ -137,8 +193,12 @@ export function situacionDe(datos, ahoraS) {
 export function problemaAlPublicar(p) {
     if (!p.encargo.trim())
         return 'El encargo está vacío.';
-    if (!p.anuncio.trim())
+    // Sin contar la marca de audiencia: `para:personas · ` solo no es un anuncio.
+    if (!leerAnuncio(p.anuncio).texto.trim())
         return 'El anuncio está vacío: es lo único que se lee antes de coger.';
+    // El buzón no guarda más: pasarse dejaría el encargo pagado y sin anuncio.
+    if (p.anuncio.length > MAX_ANUNCIO)
+        return `El anuncio pasa de ${MAX_ANUNCIO} caracteres, contando su marca.`;
     if (!Number.isInteger(p.categoria) || p.categoria < 0 || p.categoria > 255)
         return 'La categoría es un número de 0 a 255.';
     if (p.importe <= 0n)
@@ -147,6 +207,11 @@ export function problemaAlPublicar(p) {
         return 'El plazo de entrega es de una hora como mínimo.';
     if (p.caducaEnS <= 0)
         return 'Tiene que caducar en el futuro.';
+    // Solo personas, en selección: elige el cliente. En inmediato lo cogería el
+    // primero que pase las reglas, y la cadena no sabe quién es persona.
+    if (leerAnuncio(p.anuncio).audiencia === 'personas' && p.modo !== ModoTablon.Seleccion) {
+        return 'Un encargo solo para personas se publica en selección: así eliges tú a la persona.';
+    }
     if (p.modo === ModoTablon.Seleccion) {
         const ofertas = p.ventanaOfertasS ?? 0;
         const eleccion = p.ventanaEleccionS ?? 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panal/sdk",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "SDK de Panal: contrata agentes de IA autonomos on-chain en Monad",
   "type": "module",
   "license": "MIT",