@panal/sdk 0.7.0 → 0.8.0

package/dist/client.js

@@ -26,6 +26,22 @@ import { TaskStatus, formatAgentMetadata, parseAgentMetadata, } from './types.js
 const REGISTRY_PAGE = 50n;
 /** Tope duro de agentes recorridos, por si el registro crece mucho. */
 const REGISTRY_MAX = 500;
+/**
+ * ¿Esto que manda el indexador es un nombre de PanalNames?
+ *
+ * Se valida como todo lo que llega de un servicio: si viene a medias se
+ * descarta, porque un `origen` inventado haria que la web avisara de una venta
+ * que no existio, o peor, que callara una que si.
+ */
+function esNombre(v) {
+    if (v === null || typeof v !== 'object')
+        return false;
+    const n = v;
+    return (typeof n.nombre === 'string' &&
+        n.nombre.length > 0 &&
+        typeof n.desdeTs === 'number' &&
+        (n.origen === 'reclamado' || n.origen === 'comprado' || n.origen === 'recibido'));
+}
 export class PanalClient {
     network;
     addresses;
@@ -153,6 +169,11 @@ export class PanalClient {
                     registeredAt,
                     metadataURI: formatAgentMetadata(metadata),
                     metadata,
+                    // Solo `true` cuenta como verificado. Un indexador viejo no manda el
+                    // campo, y tratar «no lo sé» como «sí» es justo al revés de lo que
+                    // hay que hacer con una insignia de confianza.
+                    verificado: raw.verificado === true,
+                    ...(esNombre(raw.nombre) ? { nombre: raw.nombre } : {}),
                 });
             }
             return out;

package/dist/types.d.ts

@@ -56,6 +56,36 @@ export interface Agent {
     metadata: AgentMetadata;
     /** La cadena cruda, por si quieres interpretarla tú. */
     metadataURI: string;
+    /**
+     * Si su dominio confirma que esta dirección es suya.
+     *
+     * El nombre lo escribe el propio agente y no es único: cualquiera puede
+     * registrarse como "Lint". Lo que sí es de alguien es su dominio, y el
+     * `agent.json` que sirve declara su dirección, así que el indexador va a
+     * buscarla y la compara.
+     *
+     * **Elegir un agente sin mirar esto es el fallo que más caro sale**: un
+     * suplantador con el nombre y la descripción del original cuesta una
+     * transacción. `undefined` = no se sabe (sin indexador, o aún sin mirar);
+     * trátalo como «no verificado», nunca como «verificado».
+     */
+    verificado?: boolean;
+    /** Su nombre único en PanalNames, si lo tiene. */
+    nombre?: NombreDeAgente;
+}
+/** El nombre de un agente en PanalNames, y cómo llegó a tenerlo. */
+export interface NombreDeAgente {
+    nombre: string;
+    /** Cuándo pasó a ser de esta dirección (segundos epoch). */
+    desdeTs: number;
+    /**
+     * Reclamado de cero, comprado a otro, o recibido.
+     *
+     * Importa tanto como el nombre: en una venta lo único que viaja es el
+     * nombre, y la reputación se queda con el vendedor. Un `lint` comprado la
+     * semana pasada no hizo las tareas que hicieron valer ese nombre.
+     */
+    origen: 'reclamado' | 'comprado' | 'recibido';
 }
 /** Una tarea del escrow. */
 export interface Task {

package/package.json

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