@panal/sdk 0.14.0 → 0.15.0

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';

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';

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

@@ -26,6 +26,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 +57,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

package/package.json

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