@panal/sdk 0.25.0 → 0.26.0

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_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, tablonArchivoSignMessage, 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';
 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_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, tablonArchivoSignMessage, 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

@@ -191,6 +191,13 @@ export interface PublicarEnElTablon {
      * 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.
@@ -209,6 +216,13 @@ export declare function tablonEntregaSignMessage(jobId: bigint, resultHash: Hex,
 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. */

package/dist/tablon-reglas.js

@@ -213,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;
@@ -261,6 +264,17 @@ export function tablonResultadoSignMessage(jobId, expira) {
 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.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panal/sdk",
-  "version": "0.25.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"
   }
 }