@panal/sdk 0.14.0 → 0.16.0

package/dist/idiomas.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Panal — la ficha de un agente en el idioma de quien la lee.
+ *
+ * ───────────────────────────────────────────────────────────────────────────
+ * EL PROBLEMA
+ *
+ * El marketplace habla diez idiomas. Los AGENTES no: su nombre, su descripción
+ * y sus niveles son texto libre que escribió una persona en el suyo, y ese
+ * texto sale igual en las diez versiones del escaparate. Hoy en mainnet hay
+ * fichas que enseñan las dos cosas a la vez —la descripción en inglés y los
+ * niveles en español, en la misma tarjeta—, porque una la escribió el registro
+ * y los otros el código del bot.
+ *
+ * QUIÉN TRADUCE
+ *
+ * El propio agente. No hay un traductor de Panal en medio, por dos razones que
+ * no son de gusto:
+ *
+ *   - Un servicio central que traduzca todas las fichas es un servidor que hay
+ *     que pagar, mantener y del que pasa a depender el escaparate. Panal no
+ *     tiene ninguno: el catálogo se puede reconstruir leyendo la cadena.
+ *   - El agente YA es un modelo. Traducir cuatro frases suyas es la llamada más
+ *     barata que va a hacer en su vida, y la paga quien se beneficia.
+ *
+ * Se pide con `?lang=`, y lo que vuelve es la MISMA ficha con los campos de
+ * texto traducidos. Así ningún lector cambia: `leerNiveles`, `leerX402` y todo
+ * lo demás siguen leyendo los mismos campos.
+ *
+ * LO QUE NO SE TRADUCE
+ *
+ * El nombre del agente. «LexPanal» no significa nada en francés y traducirlo
+ * sería inventarle otro nombre a alguien, además de romper toda referencia
+ * escrita a él. Se traduce lo que es una frase: la descripción y el nombre y la
+ * descripción de cada nivel, que sí describen —«Un archivo», «El repositorio»—
+ * y que hoy son lo único que un francés no puede leer.
+ * ───────────────────────────────────────────────────────────────────────────
+ */
+/**
+ * Los idiomas del marketplace, en códigos ISO 639-1.
+ *
+ * Es la MISMA lista que `src/i18n/locales` de la web. Si allí entra uno nuevo,
+ * entra aquí, o los agentes no sabrán que se lo pueden pedir.
+ */
+export declare const IDIOMAS: readonly ["ar", "bn", "en", "es", "fr", "hi", "pt", "ru", "ur", "zh"];
+export type Idioma = (typeof IDIOMAS)[number];
+/**
+ * `'fr-CA'` → `'fr'`, `'klingon'` → `null`.
+ *
+ * El navegador dice `es-419` y `zh-Hans`, no `es` y `zh`. Quedarse con la
+ * primera parte es lo que hace que un mexicano y un argentino vean lo mismo en
+ * vez de caer los dos al inglés.
+ */
+export declare function normalizarIdioma(v: unknown): Idioma | null;
+/**
+ * La URL de la ficha de un agente en un idioma.
+ *
+ * Sin idioma reconocible se pide la ficha de siempre, SIN parámetro: un agente
+ * viejo que no sepa de esto contesta igual, y uno nuevo no gasta una traducción
+ * en un código que no existe.
+ */
+export declare function fichaEnIdioma(botUrl: string, idioma: unknown): string;
+/**
+ * Cómo se llama cada idioma EN ese idioma.
+ *
+ * Para pedirle una traducción a un modelo, que entiende mucho mejor «français»
+ * que «fr». Y de paso es la lista que enseñaría un selector, si algún día hace
+ * falta uno aquí.
+ */
+export declare const NOMBRE_IDIOMA: Record<Idioma, string>;

package/dist/idiomas.js

@@ -0,0 +1,88 @@
+/**
+ * Panal — la ficha de un agente en el idioma de quien la lee.
+ *
+ * ───────────────────────────────────────────────────────────────────────────
+ * EL PROBLEMA
+ *
+ * El marketplace habla diez idiomas. Los AGENTES no: su nombre, su descripción
+ * y sus niveles son texto libre que escribió una persona en el suyo, y ese
+ * texto sale igual en las diez versiones del escaparate. Hoy en mainnet hay
+ * fichas que enseñan las dos cosas a la vez —la descripción en inglés y los
+ * niveles en español, en la misma tarjeta—, porque una la escribió el registro
+ * y los otros el código del bot.
+ *
+ * QUIÉN TRADUCE
+ *
+ * El propio agente. No hay un traductor de Panal en medio, por dos razones que
+ * no son de gusto:
+ *
+ *   - Un servicio central que traduzca todas las fichas es un servidor que hay
+ *     que pagar, mantener y del que pasa a depender el escaparate. Panal no
+ *     tiene ninguno: el catálogo se puede reconstruir leyendo la cadena.
+ *   - El agente YA es un modelo. Traducir cuatro frases suyas es la llamada más
+ *     barata que va a hacer en su vida, y la paga quien se beneficia.
+ *
+ * Se pide con `?lang=`, y lo que vuelve es la MISMA ficha con los campos de
+ * texto traducidos. Así ningún lector cambia: `leerNiveles`, `leerX402` y todo
+ * lo demás siguen leyendo los mismos campos.
+ *
+ * LO QUE NO SE TRADUCE
+ *
+ * El nombre del agente. «LexPanal» no significa nada en francés y traducirlo
+ * sería inventarle otro nombre a alguien, además de romper toda referencia
+ * escrita a él. Se traduce lo que es una frase: la descripción y el nombre y la
+ * descripción de cada nivel, que sí describen —«Un archivo», «El repositorio»—
+ * y que hoy son lo único que un francés no puede leer.
+ * ───────────────────────────────────────────────────────────────────────────
+ */
+/**
+ * Los idiomas del marketplace, en códigos ISO 639-1.
+ *
+ * Es la MISMA lista que `src/i18n/locales` de la web. Si allí entra uno nuevo,
+ * entra aquí, o los agentes no sabrán que se lo pueden pedir.
+ */
+export const IDIOMAS = ['ar', 'bn', 'en', 'es', 'fr', 'hi', 'pt', 'ru', 'ur', 'zh'];
+/**
+ * `'fr-CA'` → `'fr'`, `'klingon'` → `null`.
+ *
+ * El navegador dice `es-419` y `zh-Hans`, no `es` y `zh`. Quedarse con la
+ * primera parte es lo que hace que un mexicano y un argentino vean lo mismo en
+ * vez de caer los dos al inglés.
+ */
+export function normalizarIdioma(v) {
+    if (typeof v !== 'string')
+        return null;
+    const base = v.trim().toLowerCase().split(/[-_]/)[0];
+    return IDIOMAS.includes(base ?? '') ? base : null;
+}
+/**
+ * La URL de la ficha de un agente en un idioma.
+ *
+ * Sin idioma reconocible se pide la ficha de siempre, SIN parámetro: un agente
+ * viejo que no sepa de esto contesta igual, y uno nuevo no gasta una traducción
+ * en un código que no existe.
+ */
+export function fichaEnIdioma(botUrl, idioma) {
+    const base = `${botUrl.replace(/\/+$/, '')}/agent.json`;
+    const lang = normalizarIdioma(idioma);
+    return lang ? `${base}?lang=${lang}` : base;
+}
+/**
+ * Cómo se llama cada idioma EN ese idioma.
+ *
+ * Para pedirle una traducción a un modelo, que entiende mucho mejor «français»
+ * que «fr». Y de paso es la lista que enseñaría un selector, si algún día hace
+ * falta uno aquí.
+ */
+export const NOMBRE_IDIOMA = {
+    ar: 'العربية (Arabic)',
+    bn: 'বাংলা (Bengali)',
+    en: 'English',
+    es: 'español (Spanish)',
+    fr: 'français (French)',
+    hi: 'हिन्दी (Hindi)',
+    pt: 'português (Portuguese)',
+    ru: 'русский (Russian)',
+    ur: 'اردو (Urdu)',
+    zh: '中文 (Chinese, simplified)',
+};

package/dist/index.d.ts

@@ -23,7 +23,7 @@ export { PanalClient, createPanalClient } from './client.js';
 export type { PanalClientOptions, HireParams, HireResult } from './client.js';
 export { monad, monadTestnet, addressesFor, chainFor, MAINNET_ADDRESSES, TESTNET_ADDRESSES, NATIVE_CURRENCY, FEE_BPS, AUTO_RELEASE_SECONDS, DISPUTE_TIMEOUT_SECONDS, } from './chains.js';
 export type { PanalNetwork, PanalAddresses } from './chains.js';
-export { TaskStatus, TASK_STATUS_LABEL, formatAgentMetadata, normalizeAgentLink, parseAgentMetadata, AGENT_LINK_KEYS, } from './types.js';
+export { TaskStatus, TASK_STATUS_LABEL, formatAgentMetadata, normalizeAgentLink, parseAgentMetadata, AGENT_LINK_KEYS, MAX_LOGO_DATA, isEmbeddedLogo, } from './types.js';
 export type { Agent, AgentLinkKey, AgentLinks, AgentMetadata, Task } from './types.js';
 export { erc20Abi, escrowAbi, registryAbi } from './abis.js';
 export { X402_SCHEME, X402Error, payAndAsk, quoteAsk } from './x402.js';
@@ -40,3 +40,6 @@ export type { CallEnvelope } from './envelope.js';
 export type { UrlGuardOptions } from './net.js';
 export { leerDireccion, leerMaxBriefChars, leerNiveles, leerX402, nivelPara } from './agent-card.js';
 export type { AgentCard, FichaGetResult, FichaNivel, FichaPostBrief, FichaX402, Nivel } from './agent-card.js';
+export { componerNivel, esTokenDeNivel, leerNivelDeSegmento, leerNivelesDeMetadata, NIVELES_EDITABLES, precioAWei, weiAPrecio, } from './niveles.js';
+export { fichaEnIdioma, IDIOMAS, NOMBRE_IDIOMA, normalizarIdioma } from './idiomas.js';
+export type { Idioma } from './idiomas.js';

package/dist/index.js

@@ -21,7 +21,7 @@
  */
 export { PanalClient, createPanalClient } from './client.js';
 export { monad, monadTestnet, addressesFor, chainFor, MAINNET_ADDRESSES, TESTNET_ADDRESSES, NATIVE_CURRENCY, FEE_BPS, AUTO_RELEASE_SECONDS, DISPUTE_TIMEOUT_SECONDS, } from './chains.js';
-export { TaskStatus, TASK_STATUS_LABEL, formatAgentMetadata, normalizeAgentLink, parseAgentMetadata, AGENT_LINK_KEYS, } from './types.js';
+export { TaskStatus, TASK_STATUS_LABEL, formatAgentMetadata, normalizeAgentLink, parseAgentMetadata, AGENT_LINK_KEYS, MAX_LOGO_DATA, isEmbeddedLogo, } from './types.js';
 export { erc20Abi, escrowAbi, registryAbi } from './abis.js';
 // x402: pagar a otro agente por una consulta, sin escrow y sin humano.
 export { X402_SCHEME, X402Error, payAndAsk, quoteAsk } from './x402.js';
@@ -40,3 +40,9 @@ export { ENVELOPE_HEADERS, DEFAULT_DEPTH, MAX_DEPTH, BudgetExhausted, DepthExhau
 // La ficha de GET /agent.json: un solo formato, y lectores que perdonan el
 // antiguo. En agent-card.ts está por qué llegó a haber dos.
 export { leerDireccion, leerMaxBriefChars, leerNiveles, leerX402, nivelPara } from './agent-card.js';
+// Los niveles escritos en el metadataURI on-chain. Mismo tipo `Nivel` que los
+// de la ficha; en niveles.ts está por qué viven en los dos sitios.
+export { componerNivel, esTokenDeNivel, leerNivelDeSegmento, leerNivelesDeMetadata, NIVELES_EDITABLES, precioAWei, weiAPrecio, } from './niveles.js';
+// La ficha en el idioma de quien la lee. En idiomas.ts está por qué traduce el
+// propio agente y no un servicio de Panal.
+export { fichaEnIdioma, IDIOMAS, NOMBRE_IDIOMA, normalizarIdioma } from './idiomas.js';

package/dist/niveles.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Panal — los niveles de un agente dentro del `metadataURI` on-chain.
+ *
+ * ───────────────────────────────────────────────────────────────────────────
+ * POR QUÉ AQUÍ Y NO SOLO EN LA FICHA
+ *
+ * Los niveles nacieron en la ficha que sirve el bot (`tiers`, ver
+ * `agent-card.ts`), y allí siguen: es donde un agente declara los topes de
+ * caracteres que su modelo puede masticar. Pero vivir SOLO ahí tiene dos
+ * consecuencias que se notan:
+ *
+ *   - Para cambiar un precio hay que tocar el código del agente y reiniciarlo.
+ *     Quien no programa no puede tocar lo que cobra.
+ *   - Si el bot está caído, sus niveles no existen. El escaparate enseña un
+ *     precio suelto de un agente que en realidad vende tres cosas distintas.
+ *
+ * En el `metadataURI` los escribe el registro, los guarda la cadena y los lee
+ * cualquiera sin preguntarle a nadie. El precio —que es lo único que hay que
+ * bloquear de verdad— deja de depender de que un servidor conteste.
+ *
+ * EL FORMATO
+ *
+ *     nivel:<precio>|<nombre>|<descripción>|<brief>|<adjunto>|<adjuntos>
+ *
+ * Un segmento por nivel, entre los demás de la ficha:
+ *
+ *     Lint · Revisa código · solidity · bot:https://… · nivel:0.03|Un archivo|…
+ *
+ * El precio va en unidades enteras («0.03»), no en wei. En wei son diecisiete
+ * dígitos por nivel y esta cadena se escribe en la cadena de bloques: lo que
+ * ocupa se paga. Los tres topes son opcionales y los vacíos del final no se
+ * escriben, así que un nivel sin topes son tres campos y punto.
+ *
+ * POR QUÉ SE VALIDA TAN DURO
+ *
+ * La regla la fija `marca.ts` y es la misma: UN TOKEN SOLO CUENTA SI SU VALOR
+ * VALE. La descripción de un agente es texto libre y alguien va a escribir
+ * «nivel: depende del encargo» dentro de ella; si bastara con ver dos puntos,
+ * esa frase se convertiría en un nivel fantasma y además desaparecería de la
+ * descripción. Exigiendo un número decimal, una barra y un nombre no vacío, la
+ * frase se queda donde estaba.
+ * ───────────────────────────────────────────────────────────────────────────
+ */
+import type { Nivel } from './agent-card.js';
+/**
+ * Cuántos ofrece el formulario.
+ *
+ * Tres es lo que la gente entiende de un vistazo —pequeño, mediano, grande— y
+ * lo que ya publican los agentes que los usan. El LECTOR admite hasta ocho
+ * porque una ficha la escribe cualquiera y recortar lo que ya está escrito
+ * sería tirar un nivel que su dueño creía publicado.
+ */
+export declare const NIVELES_EDITABLES = 3;
+/**
+ * `'0.03'` → `30000000000000000n`.
+ *
+ * A mano y no con `parseUnits` porque este módulo no importa viem: lo lee el
+ * bot de cada agente, que depende de viem a propósito solo en su cliente. La
+ * cuenta es rellenar de ceros a la derecha, que es exactamente lo que hace
+ * `parseUnits` sin coma flotante por medio.
+ */
+export declare function precioAWei(precio: string): bigint | null;
+/**
+ * `30000000000000000n` → `'0.03'`.
+ *
+ * Sin ceros de relleno al final: `'0.030000000000000000'` es el mismo número
+ * y ocupa quince caracteres más en la cadena de bloques.
+ */
+export declare function weiAPrecio(wei: bigint): string;
+/**
+ * `nivel:0.03|Un archivo|Un fichero suelto` → el nivel, o `null` si no lo es.
+ *
+ * Devolver `null` es lo normal: por aquí pasan TODOS los segmentos de la
+ * ficha, incluida la descripción libre del agente.
+ */
+export declare function leerNivelDeSegmento(segmento: string): Nivel | null;
+/** true si este segmento es un nivel. Para que los lectores de ficha lo aparten. */
+export declare function esTokenDeNivel(segmento: string): boolean;
+/**
+ * Los niveles que un agente publica en la cadena, de menor a mayor precio.
+ *
+ * `[]` significa que no publica ninguno, y eso hay que tratarlo como se
+ * trataba antes de que esto existiera: el agente tiene UN precio, el del
+ * registro. Nadie debe fabricarle niveles a partir de él.
+ */
+export declare function leerNivelesDeMetadata(metadataURI: string | null | undefined): Nivel[];
+/**
+ * El nivel → su segmento, o `null` si no se puede escribir.
+ *
+ * `null` en vez de arreglarlo por su cuenta: un «·» dentro del nombre partiría
+ * la ficha en dos y un «|» correría los campos, así que la salida silenciosa
+ * sería un nivel que dice algo distinto de lo que su dueño escribió. Quien
+ * llama tiene que enseñar el error, no firmar una ficha que no reconoce.
+ */
+export declare function componerNivel(nivel: {
+    name: string;
+    description?: string | null;
+    precio: string;
+    maxBriefChars?: number | null;
+    maxAttachChars?: number | null;
+    maxAttachCharsTotal?: number | null;
+}): string | null;

package/dist/niveles.js

@@ -0,0 +1,210 @@
+/**
+ * Panal — los niveles de un agente dentro del `metadataURI` on-chain.
+ *
+ * ───────────────────────────────────────────────────────────────────────────
+ * POR QUÉ AQUÍ Y NO SOLO EN LA FICHA
+ *
+ * Los niveles nacieron en la ficha que sirve el bot (`tiers`, ver
+ * `agent-card.ts`), y allí siguen: es donde un agente declara los topes de
+ * caracteres que su modelo puede masticar. Pero vivir SOLO ahí tiene dos
+ * consecuencias que se notan:
+ *
+ *   - Para cambiar un precio hay que tocar el código del agente y reiniciarlo.
+ *     Quien no programa no puede tocar lo que cobra.
+ *   - Si el bot está caído, sus niveles no existen. El escaparate enseña un
+ *     precio suelto de un agente que en realidad vende tres cosas distintas.
+ *
+ * En el `metadataURI` los escribe el registro, los guarda la cadena y los lee
+ * cualquiera sin preguntarle a nadie. El precio —que es lo único que hay que
+ * bloquear de verdad— deja de depender de que un servidor conteste.
+ *
+ * EL FORMATO
+ *
+ *     nivel:<precio>|<nombre>|<descripción>|<brief>|<adjunto>|<adjuntos>
+ *
+ * Un segmento por nivel, entre los demás de la ficha:
+ *
+ *     Lint · Revisa código · solidity · bot:https://… · nivel:0.03|Un archivo|…
+ *
+ * El precio va en unidades enteras («0.03»), no en wei. En wei son diecisiete
+ * dígitos por nivel y esta cadena se escribe en la cadena de bloques: lo que
+ * ocupa se paga. Los tres topes son opcionales y los vacíos del final no se
+ * escriben, así que un nivel sin topes son tres campos y punto.
+ *
+ * POR QUÉ SE VALIDA TAN DURO
+ *
+ * La regla la fija `marca.ts` y es la misma: UN TOKEN SOLO CUENTA SI SU VALOR
+ * VALE. La descripción de un agente es texto libre y alguien va a escribir
+ * «nivel: depende del encargo» dentro de ella; si bastara con ver dos puntos,
+ * esa frase se convertiría en un nivel fantasma y además desaparecería de la
+ * descripción. Exigiendo un número decimal, una barra y un nombre no vacío, la
+ * frase se queda donde estaba.
+ * ───────────────────────────────────────────────────────────────────────────
+ */
+/**
+ * Decimales de las dos monedas del registro: MON nativo y $PANAL.
+ *
+ * Está fijo a propósito. `PanalRegistryV2` solo admite esas dos y las dos
+ * tienen dieciocho, así que el precio de un nivel se puede escribir en
+ * unidades enteras sin arrastrar de qué moneda se trata. El día que el
+ * registro admita un token con otros decimales, esto se rompe de la única
+ * forma aceptable: aquí, en un sitio, y no repartido por seis lectores.
+ */
+const DECIMALES = 18;
+/** Cuántos niveles se leen de una ficha ajena. El mismo tope que `leerNiveles`. */
+const MAX_NIVELES = 8;
+/**
+ * Cuántos ofrece el formulario.
+ *
+ * Tres es lo que la gente entiende de un vistazo —pequeño, mediano, grande— y
+ * lo que ya publican los agentes que los usan. El LECTOR admite hasta ocho
+ * porque una ficha la escribe cualquiera y recortar lo que ya está escrito
+ * sería tirar un nivel que su dueño creía publicado.
+ */
+export const NIVELES_EDITABLES = 3;
+/** Tope de cada texto. Los mismos que aplica `leerNiveles` a la ficha del bot. */
+const MAX_NOMBRE = 60;
+const MAX_DESCRIPCION = 200;
+/** Un decimal positivo con hasta dieciocho cifras detrás de la coma. */
+const PRECIO = /^\d{1,12}(\.\d{1,18})?$/;
+/**
+ * `'0.03'` → `30000000000000000n`.
+ *
+ * A mano y no con `parseUnits` porque este módulo no importa viem: lo lee el
+ * bot de cada agente, que depende de viem a propósito solo en su cliente. La
+ * cuenta es rellenar de ceros a la derecha, que es exactamente lo que hace
+ * `parseUnits` sin coma flotante por medio.
+ */
+export function precioAWei(precio) {
+    const s = precio.trim();
+    if (!PRECIO.test(s))
+        return null;
+    const [entera, decimal = ''] = s.split('.');
+    const wei = BigInt(entera + decimal.padEnd(DECIMALES, '0').slice(0, DECIMALES));
+    return wei > 0n ? wei : null;
+}
+/**
+ * `30000000000000000n` → `'0.03'`.
+ *
+ * Sin ceros de relleno al final: `'0.030000000000000000'` es el mismo número
+ * y ocupa quince caracteres más en la cadena de bloques.
+ */
+export function weiAPrecio(wei) {
+    const s = wei.toString().padStart(DECIMALES + 1, '0');
+    const entera = s.slice(0, -DECIMALES);
+    const decimal = s.slice(-DECIMALES).replace(/0+$/, '');
+    return decimal ? `${entera}.${decimal}` : entera;
+}
+/** Un entero positivo, o `null`. Misma regla que los topes de la ficha. */
+function tope(v) {
+    if (v === undefined)
+        return null;
+    const s = v.trim();
+    if (!/^\d{1,9}$/.test(s))
+        return null;
+    const n = Number(s);
+    return n > 0 ? n : null;
+}
+/** Texto de un desconocido: espacios colapsados y recortado, porque va a un escaparate. */
+function letrero(v, max) {
+    if (v === undefined)
+        return null;
+    const limpio = v.replace(/\s+/g, ' ').trim().slice(0, max);
+    return limpio || null;
+}
+/**
+ * `nivel:0.03|Un archivo|Un fichero suelto` → el nivel, o `null` si no lo es.
+ *
+ * Devolver `null` es lo normal: por aquí pasan TODOS los segmentos de la
+ * ficha, incluida la descripción libre del agente.
+ */
+export function leerNivelDeSegmento(segmento) {
+    const i = segmento.indexOf(':');
+    if (i <= 0)
+        return null;
+    if (segmento.slice(0, i).trim().toLowerCase() !== 'nivel')
+        return null;
+    const campos = segmento.slice(i + 1).split('|');
+    // Sin nombre no hay nivel: el cliente elige por el nombre, y un botón vacío
+    // con un precio al lado no es una oferta, es un acertijo.
+    if (campos.length < 2)
+        return null;
+    const wei = precioAWei(campos[0] ?? '');
+    if (wei === null)
+        return null;
+    const name = letrero(campos[1], MAX_NOMBRE);
+    if (!name)
+        return null;
+    return {
+        name,
+        description: letrero(campos[2], MAX_DESCRIPCION),
+        wei,
+        maxBriefChars: tope(campos[3]),
+        maxAttachChars: tope(campos[4]),
+        maxAttachCharsTotal: tope(campos[5]),
+    };
+}
+/** true si este segmento es un nivel. Para que los lectores de ficha lo aparten. */
+export function esTokenDeNivel(segmento) {
+    return leerNivelDeSegmento(segmento) !== null;
+}
+/**
+ * Los niveles que un agente publica en la cadena, de menor a mayor precio.
+ *
+ * `[]` significa que no publica ninguno, y eso hay que tratarlo como se
+ * trataba antes de que esto existiera: el agente tiene UN precio, el del
+ * registro. Nadie debe fabricarle niveles a partir de él.
+ */
+export function leerNivelesDeMetadata(metadataURI) {
+    if (!metadataURI)
+        return [];
+    const out = [];
+    for (const segmento of metadataURI.split('·')) {
+        if (out.length >= MAX_NIVELES)
+            break;
+        const nivel = leerNivelDeSegmento(segmento.trim());
+        // Un nivel mal escrito se cae de la lista en vez de tumbarla entera: un
+        // campo roto no puede dejar sin comprar los niveles buenos de al lado.
+        if (nivel)
+            out.push(nivel);
+    }
+    // De menor a mayor, que es como se enseñan y lo que `nivelPara` necesita
+    // para quedarse con el último que entra en lo pagado.
+    return out.sort((a, b) => (a.wei < b.wei ? -1 : a.wei > b.wei ? 1 : 0));
+}
+/**
+ * El nivel → su segmento, o `null` si no se puede escribir.
+ *
+ * `null` en vez de arreglarlo por su cuenta: un «·» dentro del nombre partiría
+ * la ficha en dos y un «|» correría los campos, así que la salida silenciosa
+ * sería un nivel que dice algo distinto de lo que su dueño escribió. Quien
+ * llama tiene que enseñar el error, no firmar una ficha que no reconoce.
+ */
+export function componerNivel(nivel) {
+    if (precioAWei(nivel.precio) === null)
+        return null;
+    const name = nivel.name.replace(/\s+/g, ' ').trim();
+    const description = (nivel.description ?? '').replace(/\s+/g, ' ').trim();
+    if (!name || name.length > MAX_NOMBRE)
+        return null;
+    if (description.length > MAX_DESCRIPCION)
+        return null;
+    if (/[·|]/.test(name) || /[·|]/.test(description))
+        return null;
+    const campos = [
+        nivel.precio.trim(),
+        name,
+        description,
+        entero(nivel.maxBriefChars),
+        entero(nivel.maxAttachChars),
+        entero(nivel.maxAttachCharsTotal),
+    ];
+    // Los vacíos del FINAL se van; los de en medio no pueden irse o el siguiente
+    // campo ocuparía el sitio del que falta.
+    while (campos.length > 2 && campos[campos.length - 1] === '')
+        campos.pop();
+    return `nivel:${campos.join('|')}`;
+}
+function entero(v) {
+    return typeof v === 'number' && Number.isInteger(v) && v > 0 ? String(v) : '';
+}

package/dist/types.d.ts

@@ -58,6 +58,19 @@ export declare const AGENT_LINK_KEYS: readonly ["logo", "web", "github", "x", "t
 export type AgentLinkKey = (typeof AGENT_LINK_KEYS)[number];
 /** Cadena vacía = el agente no lo publicó. */
 export type AgentLinks = Record<AgentLinkKey, string>;
+/**
+ * Tope del logo cuando la imagen viaja DENTRO de la ficha, en caracteres.
+ *
+ * El logo tiene dos formas: una URL https —la imagen vive en el dominio del
+ * agente— o la imagen misma en base64. La segunda existe porque la primera
+ * pide un sitio donde alojar un archivo, que es justo lo que no tiene quien se
+ * registra desde la web. La referencia sigue siendo `src/lib/marca.ts` del
+ * marketplace: aquí solo hay que LEER igual, o un logo incrustado saldría
+ * recortado a 120 caracteres y con eso no se pinta nada.
+ */
+export declare const MAX_LOGO_DATA = 5000;
+/** ¿Es una imagen incrustada válida en un token `logo:`? */
+export declare function isEmbeddedLogo(value: string): boolean;
 /**
  * Deja un valor de marca como se guarda, o vacío si no sirve.
  *

package/dist/types.js

@@ -7,6 +7,7 @@
  * así que registrar un agente con la forma equivocada era fácil y el error solo
  * se veía al mirar la ficha en el marketplace.
  */
+import { esTokenDeNivel } from './niveles.js';
 /** Estados de una tarea en el escrow, en el mismo orden que el enum de Solidity. */
 export var TaskStatus;
 (function (TaskStatus) {
@@ -26,6 +27,29 @@ export const TASK_STATUS_LABEL = {
 /** Las claves de marca que entiende el marketplace, en el orden en que se pintan. */
 export const AGENT_LINK_KEYS = ['logo', 'web', 'github', 'x', 'telegram'];
 const NO_LINKS = { logo: '', web: '', github: '', x: '', telegram: '' };
+/**
+ * Tope del logo cuando la imagen viaja DENTRO de la ficha, en caracteres.
+ *
+ * El logo tiene dos formas: una URL https —la imagen vive en el dominio del
+ * agente— o la imagen misma en base64. La segunda existe porque la primera
+ * pide un sitio donde alojar un archivo, que es justo lo que no tiene quien se
+ * registra desde la web. La referencia sigue siendo `src/lib/marca.ts` del
+ * marketplace: aquí solo hay que LEER igual, o un logo incrustado saldría
+ * recortado a 120 caracteres y con eso no se pinta nada.
+ */
+export const MAX_LOGO_DATA = 5000;
+/**
+ * `data:image/webp;base64,…`. SVG queda fuera a propósito: es un documento con
+ * `<script>` dentro, y esta cadena la pinta cualquiera, no solo un `<img>`.
+ */
+const EMBEDDED_LOGO = /^data:image\/(png|webp|jpeg|gif);base64,([A-Za-z0-9+/]+={0,2})$/;
+/** ¿Es una imagen incrustada válida en un token `logo:`? */
+export function isEmbeddedLogo(value) {
+    if (value.length > MAX_LOGO_DATA)
+        return false;
+    const b64 = EMBEDDED_LOGO.exec(value)?.[2];
+    return b64 !== undefined && b64.length >= 64 && b64.length % 4 === 0;
+}
 /**
  * Deja un valor de marca como se guarda, o vacío si no sirve.
  *
@@ -34,7 +58,12 @@ const NO_LINKS = { logo: '', web: '', github: '', x: '', telegram: '' };
  * `src/lib/marca.ts` del marketplace: si cambias una, cambia la otra.
  */
 export function normalizeAgentLink(key, raw) {
-    const value = raw.trim().slice(0, 120);
+    const whole = raw.trim();
+    // Antes de recortar: una imagen incrustada mide miles de caracteres y el
+    // recorte la dejaría en un `data:` a medias — ocupa, se guarda y no se ve.
+    if (key === 'logo' && whole.startsWith('data:'))
+        return isEmbeddedLogo(whole) ? whole : '';
+    const value = whole.slice(0, 120);
     if (!value)
         return '';
     // Un espacio o un `·` por dentro invalida en vez de borrarse: borrarlos
@@ -136,6 +165,11 @@ export function parseAgentMetadata(metadataURI) {
                 links[link[0]] = link[1];
             continue;
         }
+        // Los niveles tampoco son texto de la ficha: sin apartarlos, los tres
+        // `nivel:…` de un agente saldrían anunciados como skills suyas. Los lee
+        // `leerNivelesDeMetadata`; aquí solo hace falta reconocerlos.
+        if (esTokenDeNivel(seg))
+            continue;
         rest.push(seg);
     }
     // Los campos que falten quedan vacíos en vez de desplazar a los siguientes:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panal/sdk",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "SDK de Panal: contrata agentes de IA autonomos on-chain en Monad",
   "type": "module",
   "license": "MIT",
@@ -45,7 +45,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "tsx test/sdk.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",
+    "test": "tsx test/sdk.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",
     "test:nombres": "tsx test/nombres.test.ts"
   }
 }