@panal/sdk 0.24.0 → 0.26.0

package/dist/idiomas.js

@@ -35,6 +35,7 @@
  * y que hoy son lo único que un francés no puede leer.
  * ───────────────────────────────────────────────────────────────────────────
  */
+import { sinBarraFinal } from './net.js';
 /**
  * Los idiomas del marketplace, en códigos ISO 639-1.
  *
@@ -63,7 +64,7 @@ export function normalizarIdioma(v) {
  * en un código que no existe.
  */
 export function fichaEnIdioma(botUrl, idioma) {
-    const base = `${botUrl.replace(/\/+$/, '')}/agent.json`;
+    const base = `${sinBarraFinal(botUrl)}/agent.json`;
     const lang = normalizarIdioma(idioma);
     return lang ? `${base}?lang=${lang}` : base;
 }

package/dist/index.d.ts

@@ -46,7 +46,7 @@ export { componerNivel, conTextoDeLaFicha, esTokenDeNivel, leerNivelDeSegmento,
 export { esTokenDeTipo, leerTipo, leerTipoDeSegmento, tokenDeTipo } from './tipo.js';
 export type { TipoDeAgente } from './tipo.js';
 export { componerEjemplo, conEjemplosDeLaFicha, EJEMPLOS_EDITABLES, esTokenDeEjemplo, falloDeEjemplo, leerEjemploDeSegmento, leerEjemplos, leerEjemplosDeMetadata, MAX_EJEMPLO, } from './ejemplos.js';
-export { rutaDeAgente } from './net.js';
+export { rutaDeAgente, sinBarraFinal } from './net.js';
 export { BUZON_URL, TABLON, VENTANA_FIRMA_S, encargoSignMessage, entregaSignMessage, ofertaSignMessage, } from './tablon.js';
 export type { EncargoDelTablon } from './tablon.js';
 export { fichaEnIdioma, IDIOMAS, NOMBRE_IDIOMA, normalizarIdioma } from './idiomas.js';
@@ -54,5 +54,6 @@ 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 { 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';
+export { CATEGORIAS_TABLON, EstadoTablon, MARGEN_ASIGNACION_S, MAX_ANUNCIO, MAX_ARCHIVOS_TABLON, MAX_BYTES_ARCHIVOS_TABLON, MAX_CATEGORIAS, MAX_TEXTO_ANUNCIO, MAX_OFERTAS, MAX_VENTANA_ELECCION_S, MIN_PLAZO_ENTREGA_S, ModoTablon, anuncioPara, audienciaAdmite, categoriaDelTablon, categoriasDeMascara, claveDeCampana, encargoDeLaCadena, entregaConArchivos, idDeCampana, leerAnuncio, ofertaDeLaCadena, problemaAlPublicar, problemaConArchivos, situacionDe, tablonAccesoSignMessage, tablonArchivoSignMessage, tablonDisputaSignMessage, tablonEncargoSignMessage, tablonEntregaSignMessage, tablonResultadoSignMessage, } from './tablon-reglas.js';
+export type { ArchivoParaSubir, AudienciaTablon, CategoriaTablon, EncargoConReglas, OfertaConReglas, PublicarEnElTablon, SituacionEnElTablon, } from './tablon-reglas.js';
+export { CIFRADO_V1, aBase64, accesoSignMessage, archivosAnunciadosEnSobre, claveDesdeFirma, concederAcceso, cifrarArchivo, cifrarTexto, comprobarClavePublicada, deBase64, descifrarArchivo, descifrarTexto, destinatariosDe, disputaSignMessage, esArchivoCifrado, esTextoCifrado, mensajeParaDerivarClave, mensajeParaPublicarClave, nombreEnBuzon, puedeAbrir, type Acceso, type ArchivoAnunciado, type ClaveDeCifrado, type ClavePublicada, type Destinatario, } from './cifrado.js';

package/dist/index.js

@@ -54,7 +54,7 @@ export { componerEjemplo, conEjemplosDeLaFicha, EJEMPLOS_EDITABLES, esTokenDeEje
 // propio agente y no un servicio de Panal.
 // Unir una ruta con la URL de un agente. Ver por qué en `net.ts`: un agente
 // puede vivir en un subcamino, y `new URL('/x', base)` se lo come.
-export { rutaDeAgente } from './net.js';
+export { rutaDeAgente, sinBarraFinal } from './net.js';
 // El tablón: encargos sin dueño para que los coja un programa. Los mensajes de
 // firma se exportan porque cualquiera que hable con el buzón sin este cliente
 // —otro lenguaje, otro runtime— necesita producir exactamente estos bytes.
@@ -67,4 +67,7 @@ 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 { 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 { CATEGORIAS_TABLON, EstadoTablon, MARGEN_ASIGNACION_S, MAX_ANUNCIO, MAX_ARCHIVOS_TABLON, MAX_BYTES_ARCHIVOS_TABLON, MAX_CATEGORIAS, MAX_TEXTO_ANUNCIO, MAX_OFERTAS, MAX_VENTANA_ELECCION_S, MIN_PLAZO_ENTREGA_S, ModoTablon, anuncioPara, audienciaAdmite, categoriaDelTablon, categoriasDeMascara, claveDeCampana, encargoDeLaCadena, entregaConArchivos, idDeCampana, leerAnuncio, ofertaDeLaCadena, problemaAlPublicar, problemaConArchivos, situacionDe, tablonAccesoSignMessage, tablonArchivoSignMessage, tablonDisputaSignMessage, tablonEncargoSignMessage, tablonEntregaSignMessage, tablonResultadoSignMessage, } from './tablon-reglas.js';
+// Encargos cifrados de punta a punta: la clave sale de una firma, el sobre se
+// abre solo con la de sus destinatarios, y el buzón guarda lo que no sabe leer.
+export { CIFRADO_V1, aBase64, accesoSignMessage, archivosAnunciadosEnSobre, claveDesdeFirma, concederAcceso, cifrarArchivo, cifrarTexto, comprobarClavePublicada, deBase64, descifrarArchivo, descifrarTexto, destinatariosDe, disputaSignMessage, esArchivoCifrado, esTextoCifrado, mensajeParaDerivarClave, mensajeParaPublicarClave, nombreEnBuzon, puedeAbrir, } from './cifrado.js';

package/dist/net.d.ts

@@ -68,3 +68,12 @@ export declare function fetchLimited(url: URL | string, init?: RequestInit & {
  * rutas se hace en un sitio y no a mano en cada llamada.
  */
 export declare function rutaDeAgente(base: string, ruta: string): string;
+/**
+ * Una URL sin las barras del final.
+ *
+ * Con un bucle y no con `replace(/\/+$/, '')`: esa expresión, sobre un texto
+ * lleno de barras que no acaba en barra, vuelve a probar desde cada una y
+ * tarda un tiempo cuadrático. Y la URL de un agente la escribe él en su
+ * ficha: con unos miles de barras bastaría para colgar a quien la lea.
+ */
+export declare function sinBarraFinal(url: string): string;

package/dist/net.js

@@ -163,5 +163,19 @@ export async function fetchLimited(url, init = {}) {
  * rutas se hace en un sitio y no a mano en cada llamada.
  */
 export function rutaDeAgente(base, ruta) {
-    return `${base.replace(/\/+$/, '')}/${ruta.replace(/^\/+/, '')}`;
+    return `${sinBarraFinal(base)}/${ruta.replace(/^\/+/, '')}`;
+}
+/**
+ * Una URL sin las barras del final.
+ *
+ * Con un bucle y no con `replace(/\/+$/, '')`: esa expresión, sobre un texto
+ * lleno de barras que no acaba en barra, vuelve a probar desde cada una y
+ * tarda un tiempo cuadrático. Y la URL de un agente la escribe él en su
+ * ficha: con unos miles de barras bastaría para colgar a quien la lea.
+ */
+export function sinBarraFinal(url) {
+    let fin = url.length;
+    while (fin > 0 && url.charCodeAt(fin - 1) === 47)
+        fin--;
+    return url.slice(0, fin);
 }

package/dist/tablon-reglas.d.ts

@@ -185,6 +185,19 @@ export interface PublicarEnElTablon {
         id: Hex;
         topePorAgente: number;
     };
+    /**
+     * Archivos que acompañan al encargo. Su hash se anuncia dentro del encargo
+     * antes de publicar, así que el `taskHash` los cubre; los bytes se suben al
+     * buzón del tablón después.
+     */
+    adjuntos?: ArchivoParaSubir[];
+    /**
+     * Confidencial: el encargo y sus adjuntos se cifran para quien publica, y al
+     * elegir una oferta se le da acceso solo a quien se elige (que tiene que
+     * tener su clave publicada). El anuncio sigue siendo público. Solo en
+     * selección: en inmediato lo cogería cualquiera sin que nadie le diera acceso.
+     */
+    confidencial?: boolean;
 }
 /**
  * Las comprobaciones de `post()` antes de firmar, con el motivo en claro.
@@ -201,3 +214,32 @@ export declare function tablonEncargoSignMessage(jobId: bigint, expira: number):
 export declare function tablonEntregaSignMessage(jobId: bigint, resultHash: Hex, expira: number): string;
 /** Su cliente se lleva la entrega. */
 export declare function tablonResultadoSignMessage(jobId: bigint, expira: number): string;
+/** Su cliente sube un adjunto del encargo, o su agente un archivo de la entrega. */
+export declare function tablonArchivoSignMessage(jobId: bigint, expira: number): string;
+/**
+ * Una parte da acceso a lo cifrado de su encargo: a quien lo cogió o a quien
+ * decide una disputa (`concederAcceso`, en cifrado.ts).
+ */
+export declare function tablonAccesoSignMessage(jobId: bigint, expira: number): string;
+/** Un firmante de la multisig lee una disputa: el encargo, la entrega y sus archivos. */
+export declare function tablonDisputaSignMessage(jobId: bigint, expira: number): string;
+export declare const MAX_ARCHIVOS_TABLON = 5;
+export declare const MAX_BYTES_ARCHIVOS_TABLON: number;
+/** Un archivo para subir al tablón: su nombre, sus bytes y su tipo si se sabe. */
+export interface ArchivoParaSubir {
+    name: string;
+    bytes: Uint8Array;
+    mime?: string;
+}
+/**
+ * El texto de una entrega del tablón con sus archivos anunciados: nombre,
+ * tamaño, tipo y hash de cada uno, dentro de lo que se ancla. La ruta es
+ * relativa al buzón del tablón (`${buzonUrl}/${tablon}`).
+ *
+ * UNA sola función para todos —SDK, web, app y plantilla— porque este texto se
+ * hashea: dos versiones que difieran en un espacio darían dos hashes, y el
+ * cliente vería una entrega que no cuadra con la anclada.
+ */
+export declare function entregaConArchivos(jobId: bigint, texto: string, archivos: ArchivoParaSubir[]): string;
+/** Por qué estos archivos no caben en un lado del encargo, o `null`. */
+export declare function problemaConArchivos(archivos: ArchivoParaSubir[]): string | null;

package/dist/tablon-reglas.js

@@ -18,6 +18,7 @@
  * rechazaría. Lo que lee y firma está en client.ts.
  */
 import { encodeAbiParameters, keccak256, toBytes } from 'viem';
+import { MAX_FILE_BYTES, appendFilesManifest, sanitizeFileName } from './files.js';
 /** Cómo se asigna un encargo. */
 export var ModoTablon;
 (function (ModoTablon) {
@@ -212,6 +213,9 @@ export function problemaAlPublicar(p) {
     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.confidencial && p.modo !== ModoTablon.Seleccion) {
+        return 'Un encargo confidencial se publica en selección: a quien lo coge se le da acceso al elegirlo.';
+    }
     if (p.modo === ModoTablon.Seleccion) {
         const ofertas = p.ventanaOfertasS ?? 0;
         const eleccion = p.ventanaEleccionS ?? 0;
@@ -222,6 +226,11 @@ export function problemaAlPublicar(p) {
         if (p.caducaEnS < ofertas + eleccion)
             return 'Caduca antes de que acabe el tiempo de elegir.';
     }
+    if (p.adjuntos?.length) {
+        const archivos = problemaConArchivos(p.adjuntos);
+        if (archivos)
+            return archivos;
+    }
     if (p.campana && (p.campana.topePorAgente < 1 || p.campana.topePorAgente > 255)) {
         return 'El tope de una campaña es de 1 a 255 encargos por agente.';
     }
@@ -251,3 +260,80 @@ export function tablonEntregaSignMessage(jobId, resultHash, expira) {
 export function tablonResultadoSignMessage(jobId, expira) {
     return `Panal tablón con reglas · resultado #${jobId.toString()} · ${expira}`;
 }
+/** Su cliente sube un adjunto del encargo, o su agente un archivo de la entrega. */
+export function tablonArchivoSignMessage(jobId, expira) {
+    return `Panal tablón con reglas · archivo #${jobId.toString()} · ${expira}`;
+}
+/**
+ * Una parte da acceso a lo cifrado de su encargo: a quien lo cogió o a quien
+ * decide una disputa (`concederAcceso`, en cifrado.ts).
+ */
+export function tablonAccesoSignMessage(jobId, expira) {
+    return `Panal tablón con reglas · acceso #${jobId.toString()} · ${expira}`;
+}
+/** Un firmante de la multisig lee una disputa: el encargo, la entrega y sus archivos. */
+export function tablonDisputaSignMessage(jobId, expira) {
+    return `Panal tablón con reglas · disputa #${jobId.toString()} · ${expira}`;
+}
+/*
+ * Archivos en el tablón.
+ *
+ * Los mismos que en un encargo normal: el hash de cada archivo va DENTRO del
+ * texto que se ancla —el encargo, en `[panal-attach/1]`; la entrega, en
+ * `[panal-files/1]`—, así que la cadena cubre los bytes y nadie los cambia
+ * después. Los bytes viajan por el buzón del tablón, que solo los da al cliente
+ * y a su agente.
+ *
+ * Los topes son POR LADO. El buzón guarda 10 archivos y 60 MB por encargo entre
+ * los dos (bot/src/buzon-store.ts); la mitad para los adjuntos del cliente y la
+ * mitad para la entrega, para que adjuntar mucho no deje al agente sin sitio.
+ */
+export const MAX_ARCHIVOS_TABLON = 5;
+export const MAX_BYTES_ARCHIVOS_TABLON = 30 * 1024 * 1024;
+/**
+ * El texto de una entrega del tablón con sus archivos anunciados: nombre,
+ * tamaño, tipo y hash de cada uno, dentro de lo que se ancla. La ruta es
+ * relativa al buzón del tablón (`${buzonUrl}/${tablon}`).
+ *
+ * UNA sola función para todos —SDK, web, app y plantilla— porque este texto se
+ * hashea: dos versiones que difieran en un espacio darían dos hashes, y el
+ * cliente vería una entrega que no cuadra con la anclada.
+ */
+export function entregaConArchivos(jobId, texto, archivos) {
+    const entregados = archivos.map((a) => {
+        const nombre = sanitizeFileName(a.name);
+        return {
+            name: nombre,
+            size: a.bytes.byteLength,
+            hash: keccak256(a.bytes),
+            ...(a.mime ? { mime: a.mime } : {}),
+            path: `/archivo/${jobId.toString()}/${encodeURIComponent(nombre)}?de=entrega`,
+        };
+    });
+    return appendFilesManifest(texto, entregados);
+}
+/** Por qué estos archivos no caben en un lado del encargo, o `null`. */
+export function problemaConArchivos(archivos) {
+    if (archivos.length > MAX_ARCHIVOS_TABLON)
+        return `Como mucho ${MAX_ARCHIVOS_TABLON} archivos.`;
+    const nombres = [];
+    for (const a of archivos) {
+        try {
+            nombres.push(sanitizeFileName(a.name));
+        }
+        catch {
+            return `«${a.name}» no es un nombre de archivo que se pueda usar.`;
+        }
+        if (a.bytes.byteLength === 0)
+            return `«${a.name}» está vacío.`;
+        if (a.bytes.byteLength > MAX_FILE_BYTES)
+            return `«${a.name}» pasa de ${MAX_FILE_BYTES / 1024 / 1024} MB.`;
+    }
+    // Se piden por nombre: dos con el mismo serían uno.
+    if (new Set(nombres).size !== nombres.length)
+        return 'Hay dos archivos con el mismo nombre.';
+    const total = archivos.reduce((n, a) => n + a.bytes.byteLength, 0);
+    if (total > MAX_BYTES_ARCHIVOS_TABLON)
+        return `Entre todos pasan de ${MAX_BYTES_ARCHIVOS_TABLON / 1024 / 1024} MB.`;
+    return null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panal/sdk",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "description": "SDK de Panal: contrata agentes de IA autonomos on-chain en Monad",
   "type": "module",
   "license": "MIT",
@@ -34,6 +34,11 @@
   "engines": {
     "node": ">=20"
   },
+  "dependencies": {
+    "@noble/ciphers": "^1.3.0",
+    "@noble/curves": "^1.9.1",
+    "@noble/hashes": "^1.8.0"
+  },
   "peerDependencies": {
     "viem": "^2.21.0"
   },
@@ -45,7 +50,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "tsx test/sdk.test.ts && tsx test/currencies.test.ts && tsx test/x402.test.ts && tsx test/x402-server.test.ts && tsx test/envelope.test.ts && tsx test/files.test.ts && tsx test/attachments.test.ts && tsx test/llm.test.ts && tsx test/skill.test.ts && tsx test/agent-card.test.ts && tsx test/niveles.test.ts && tsx test/ejemplos.test.ts && tsx test/tablon.test.ts && tsx test/reserva.test.ts && tsx test/precios.test.ts && tsx test/tablon-reglas.test.ts",
+    "test": "tsx test/sdk.test.ts && tsx test/currencies.test.ts && tsx test/x402.test.ts && tsx test/x402-server.test.ts && tsx test/envelope.test.ts && tsx test/files.test.ts && tsx test/attachments.test.ts && tsx test/llm.test.ts && tsx test/skill.test.ts && tsx test/agent-card.test.ts && tsx test/niveles.test.ts && tsx test/ejemplos.test.ts && tsx test/tablon.test.ts && tsx test/reserva.test.ts && tsx test/precios.test.ts && tsx test/tablon-reglas.test.ts && tsx test/cifrado.test.ts",
     "test:nombres": "tsx test/nombres.test.ts"
   }
 }