create-panal-agent 0.26.0 → 0.27.0

package/README.md

@@ -242,6 +242,13 @@ devuelve archivos, se suben ahí y su hash entra en la entrega anclada (hasta 5
 anuncio tiene que mencionar alguna) y `TABLON_MINIMO_USD` (lo mínimo que te tiene que dejar
 en dólares, después del 2,5 %) son opcionales.
 
+**Los confidenciales también.** Un encargo marcado como confidencial va cifrado y solo lo
+lee el agente que su cliente elija. Tu agente oferta en ellos como en los demás: antes publica
+su clave de cifrado (dos firmas con su wallet, sin gas), lee el encargo y sus adjuntos con el
+acceso que le da el cliente al elegirlo, y cifra la entrega para el cliente y para sí mismo.
+`handleTask` recibe el texto y los archivos ya abiertos; en disco quedan cifrados, que es lo
+que cubre su hash.
+
 Lo que le asignen a tu agente en el tablón **se trabaja aunque `TABLON` esté apagado**: si
 ofertas a mano desde la web con su wallet y el cliente te elige, el vigilante lo recoge, lee
 el encargo y lo entrega. La primera vez arranca en el nivel 0, con dos encargos de novato de

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-panal-agent",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Crea un agente de IA para Panal, funcionando y cobrando on-chain, en cinco minutos",
   "type": "module",
   "license": "MIT",

package/template/_package.json

@@ -10,7 +10,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@panal/sdk": "^0.25.0",
+    "@panal/sdk": "^0.26.0",
     "unpdf": "^1.8.1",
     "dotenv": "^17.0.0",
     "tsx": "^4.19.0",

package/template/src/server.ts

@@ -70,6 +70,7 @@ import {
   verifyNativePayment,
   x402Currencies,
   x402CurrencyByName,
+  sinBarraFinal,
 } from '@panal/sdk';
 import { comoAdjunto } from './salida.js';
 import { privateKeyToAccount } from 'viem/accounts';
@@ -870,8 +871,14 @@ interface ComoEntregar {
   jobId: bigint;
   /** Deja la entrega en el buzón del tablón —con sus archivos, si hay— y ancla su hash. */
   entregar: (texto: string, archivos: ArchivoParaSubir[]) => Promise<{ txHash: Hex }>;
-  /** Los adjuntos del encargo, del buzón del tablón y comprobados contra su hash. */
+  /**
+   * Los adjuntos del encargo, del buzón del tablón y comprobados contra su
+   * hash, TAL COMO ESTÁN: cifrados si el encargo es confidencial. Son los
+   * bytes que su hash cubre, y así se guardan y se vuelven a comprobar.
+   */
   bajarAdjuntos: (archivos: AttachedFile[]) => Promise<Uint8Array[]>;
+  /** Abre un adjunto guardado, si va cifrado (con el acceso que dio el cliente). */
+  abrirAdjunto: (bytes: Uint8Array) => Promise<Uint8Array>;
 }
 
 /** Los archivos de la salida de `handleTask`, como se suben al tablón. */
@@ -938,6 +945,11 @@ async function work(
       // quedaba esperando para siempre sin que nadie volviera a mirarla.
       return 'esperando';
     }
+    // Un encargo confidencial los trae cifrados: se abren justo antes de
+    // trabajar, que en disco quedan como los cubre su hash.
+    if (delTablon && recibidos.length > 0) {
+      recibidos = await Promise.all(recibidos.map(async (r) => ({ ...r, bytes: await delTablon.abrirAdjunto(r.bytes) })));
+    }
     if (recibidos.length > 0) console.log(`[panal] #${taskId} con ${recibidos.length} adjunto(s) del cliente`);
 
     const task = await leerTarea(taskId);
@@ -1396,7 +1408,7 @@ const server = createServer((req, res) => {
     // LexPanal tuvo x402 funcionando y nadie lo usó, sencillamente porque no
     // salía en su tarjeta: un cobro que nadie puede descubrir no existe.
     if (url.pathname === '/agent.json' && req.method === 'GET') {
-      const base = process.env.PUBLIC_URL?.trim().replace(/\/+$/, '') || null;
+      const base = sinBarraFinal(process.env.PUBLIC_URL?.trim() ?? '') || null;
       /**
        * `?lang=fr`: la misma ficha con las frases en francés.
        *
@@ -2071,9 +2083,11 @@ const trabajarDelTablon = async (job: EncargoConReglas, brief: string): Promise<
   (await work(job.escrowTaskId, brief, null, {
     cliente: job.cliente,
     jobId: job.id,
-    // Compone el mismo texto que se guardó (`entregaConArchivos`): su hash es el que se ancla.
+    // Compone el mismo texto que se guardó (`entregaConArchivos`): su hash es el
+    // que se ancla. Salvo en uno confidencial, que se cifra al entregar.
     entregar: (texto, archivos) => panal.deliverBoardJob(job.id, texto, archivos),
-    bajarAdjuntos: (archivos) => panal.downloadBoardJobFiles(job.id, archivos, 'adjunto'),
+    bajarAdjuntos: (archivos) => panal.downloadBoardJobFiles(job.id, archivos, 'adjunto', { abrir: false }),
+    abrirAdjunto: (bytes) => panal.openBoardJobFile(job.id, bytes),
   })) === 'entregada';
 
 // El vigilante. Va DESPUÉS de escuchar: su primer repaso puede tardar unos

package/template/src/tablon.ts

@@ -77,6 +77,7 @@ import {
   esFresco,
   formatearDolares,
   leerAnuncio,
+  stripFilesManifest,
 } from '@panal/sdk';
 import type { ArchivoParaSubir, EncargoConReglas, PanalClient } from '@panal/sdk';
 
@@ -500,11 +501,20 @@ export async function retomarDelTablon(
 
   const resultado = deps.resultadoGuardado(taskId);
   if (resultado !== null) {
+    const archivos = deps.archivosGuardados?.(taskId, resultado) ?? [];
+    // Confidencial: lo guardado está en claro y la entrega se cifra al hacerla,
+    // así que se vuelve a componer desde el texto y los archivos de disco —que
+    // `deliverBoardJob` cifra y sube con su nombre opaco— y nunca se suben
+    // en claro. Va otro hash, y vale: el escrow aún no ancló ninguno.
+    if (await deps.panal.isBoardJobConfidential(job.id)) {
+      const { txHash } = await deps.panal.deliverBoardJob(job.id, stripFilesManifest(resultado), archivos);
+      console.log(`[tablon] encargo #${job.id} (tarea #${taskId}) entregado al segundo intento · tx ${txHash}`);
+      return true;
+    }
     // Si la entrega anuncia archivos, se vuelven a subir de disco antes: el
     // proceso pudo morir entre guardarla y subirlos, y anclar un texto que
     // anuncia archivos que el buzón no tiene dejaría al cliente sin ellos.
     // Subir otra vez lo mismo no ocupa más.
-    const archivos = deps.archivosGuardados?.(taskId, resultado) ?? [];
     if (archivos.length > 0) await deps.panal.publishBoardJobFiles(job.id, archivos);
     const { txHash } = await deps.panal.deliverBoardJob(job.id, resultado);
     console.log(`[tablon] encargo #${job.id} (tarea #${taskId}) entregado al segundo intento · tx ${txHash}`);