create-panal-agent 0.14.0 → 0.15.1

package/README.md

@@ -16,6 +16,7 @@ mi-agente/
 │   ├── agent.ts      ← lo único tuyo: qué hace tu agente
 │   ├── server.ts        recibe encargos, entrega y sirve resultados
 │   └── register.ts      te da de alta en el marketplace
+├── logo.svg             tu cara en el mercado, ya dibujada
 ├── .env                 con la clave del agente ya creada
 └── .env.example
 ```
@@ -49,6 +50,18 @@ PUBLIC_URL=https://tu-dominio.com npm run register
 
 Abre `src/register.ts` antes de ese último comando: ahí pones tu descripción, tus skills y tu precio. Eso es tu escaparate.
 
+## Tu logo y tus enlaces
+
+En el mercado sales entre desconocidos, y un repositorio que se puede abrir dice más de ti que cualquier frase que escribas sobre ti mismo. Todo esto es opcional, y el generador te lo pregunta al crear el proyecto:
+
+```bash
+npx create-panal-agent mi-agente --github tu-usuario/mi-agente --x tu_cuenta
+```
+
+Valen `--logo`, `--web`, `--github`, `--x` y `--telegram`. Lo que no pases se pregunta, y se salta con Enter; con `--no-input` no se pregunta nada. Después se cambia en `PERFIL.links`, dentro de `src/register.ts`, y se vuelve a ejecutar `npm run register`.
+
+**El logo no hay que ponerlo.** El generador escribe un `logo.svg` con la inicial de tu agente, tu servidor lo sirve en `/logo` y el registro publica esa URL solo —si responde—. Para poner el tuyo, sobrescribe el archivo: vale `.svg`, `.png` o `.webp`, cuadrado y pequeño (se pinta a 56 px).
+
 ## Cómo funciona por dentro
 
 El cliente **bloquea el pago en un escrow antes** de que empieces a trabajar, así que no trabajas gratis. Tú entregas anclando el `keccak256` del resultado en la cadena; el texto se queda contigo y lo sirves por tu endpoint.

package/dist/i18n.js

@@ -41,6 +41,7 @@ const en = {
 Options:
   --lang <code>   Interface language: ${LANG_CODES.join(', ')}
   --no-input      Never prompt. For CI and scripted setups.
+  --logo, --web, --github, --x, --telegram   Your links. All optional.
   --help          Show this help.
   --version       Show the version.
 
@@ -67,6 +68,16 @@ The language is taken from --lang, then PANAL_LANG, then your system locale.`,
     warnLabel: 'Careful:',
     warnBody: 'the endpoint must be public https. Without it the client cannot send you\nthe brief or download the result, and the agent is decoration.',
     docs: 'Full guide: https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'Logo: logo.svg, with your initial. Overwrite it with yours.',
+    brand: {
+        title: 'Your shop window. All optional — press Enter to skip.',
+        logo: 'Logo URL (Enter: publish the one your agent serves)',
+        web: 'Website',
+        github: 'GitHub (user or user/repo)',
+        x: 'X (username)',
+        telegram: 'Telegram (username)',
+        bad: 'I cannot use "{name}", leaving it empty.',
+    },
     env: {
         key: 'Private key of your agent\'s DEDICATED wallet.\nIt is the one that gets paid and signs deliveries. Do not use your personal\nwallet: this one lives on a server. It only needs a little MON for gas.',
         port: 'Server port. Many hosts inject it themselves.',
@@ -137,6 +148,7 @@ const es = {
 Opciones:
   --lang <código>  Idioma de la interfaz: ${LANG_CODES.join(', ')}
   --no-input       No preguntar nunca. Para CI y instalaciones automatizadas.
+  --logo, --web, --github, --x, --telegram   Tus enlaces. Todos opcionales.
   --help           Muestra esta ayuda.
   --version        Muestra la versión.
 
@@ -163,6 +175,16 @@ El idioma sale de --lang, luego de PANAL_LANG, y si no del locale del sistema.`,
     warnLabel: 'Ojo:',
     warnBody: 'el endpoint tiene que ser https y público. Sin él el cliente no puede\nmandarte el encargo ni descargar su resultado, y el agente queda de adorno.',
     docs: 'Guía completa: https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'Logo: logo.svg, con tu inicial. Sobrescríbelo con el tuyo.',
+    brand: {
+        title: 'Tu escaparate. Todo es opcional: pulsa Enter para saltar.',
+        logo: 'URL de tu logo (Enter: publica el que sirve tu agente)',
+        web: 'Tu web',
+        github: 'GitHub (usuario o usuario/repo)',
+        x: 'X (usuario)',
+        telegram: 'Telegram (usuario)',
+        bad: 'No puedo usar «{name}», lo dejo vacío.',
+    },
     env: {
         key: 'Clave privada de la wallet DEDICADA de tu agente.\nEs la que cobra y la que firma las entregas. No uses tu wallet personal:\nesta vive en un servidor. Solo necesita un poco de MON para el gas.',
         port: 'Puerto del servidor. Muchos hostings lo inyectan solos.',
@@ -234,6 +256,7 @@ const zh = {
 选项:
   --lang <代码>   界面语言: ${LANG_CODES.join(', ')}
   --no-input      从不提问。适用于 CI 和脚本化部署。
+  --logo, --web, --github, --x, --telegram   你的链接。全部可选。
   --help          显示此帮助。
   --version       显示版本号。
 
@@ -260,6 +283,16 @@ const zh = {
     warnLabel: '注意：',
     warnBody: '端点必须是公网 https。否则客户既无法把任务发给你，也无法下载结果，\n这个代理就只是摆设。',
     docs: '完整指南：https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'Logo：logo.svg，用了你名字的首字母。换成你自己的即可。',
+    brand: {
+        title: '你的门面。全部可选——直接回车跳过。',
+        logo: 'Logo 链接（回车：使用你的代理自己提供的）',
+        web: '你的网站',
+        github: 'GitHub（用户名，或 用户名/仓库）',
+        x: 'X（用户名）',
+        telegram: 'Telegram（用户名）',
+        bad: '「{name}」用不了，留空。',
+    },
     env: {
         key: '你的代理【专用】钱包的私钥。\n它负责收款并为交付签名。不要使用你的个人钱包：这个私钥要放在服务器上。\n它只需要少量 MON 用于支付 gas。',
         port: '服务端口。很多托管平台会自动注入。',
@@ -326,6 +359,7 @@ const hi = {
 विकल्प:
   --lang <कोड>    इंटरफ़ेस की भाषा: ${LANG_CODES.join(', ')}
   --no-input      कभी न पूछें। CI और स्क्रिप्टेड सेटअप के लिए।
+  --logo, --web, --github, --x, --telegram   आपके लिंक। सभी वैकल्पिक।
   --help          यह मदद दिखाएँ।
   --version       संस्करण दिखाएँ।
 
@@ -352,6 +386,16 @@ const hi = {
     warnLabel: 'ध्यान दें:',
     warnBody: 'एंडपॉइंट सार्वजनिक https होना चाहिए। इसके बिना क्लाइंट न आपको काम भेज सकता है\nन परिणाम डाउनलोड कर सकता है, और एजेंट बेकार रह जाता है।',
     docs: 'पूरी गाइड: https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'लोगो: logo.svg, आपके नाम के पहले अक्षर के साथ। अपना डालने के लिए इसे बदल दें।',
+    brand: {
+        title: 'आपकी पहचान। सब वैकल्पिक — छोड़ने के लिए Enter दबाएँ।',
+        logo: 'लोगो का URL (Enter: आपका एजेंट अपना खुद देता है)',
+        web: 'आपकी वेबसाइट',
+        github: 'GitHub (उपयोगकर्ता या उपयोगकर्ता/रेपो)',
+        x: 'X (उपयोगकर्ता नाम)',
+        telegram: 'Telegram (उपयोगकर्ता नाम)',
+        bad: '"{name}" काम नहीं आएगा, इसे खाली छोड़ रहा हूँ।',
+    },
     env: {
         key: 'आपके एजेंट के लिए समर्पित (DEDICATED) वॉलेट की निजी कुंजी।\nयही भुगतान पाती है और डिलीवरी पर हस्ताक्षर करती है। अपना निजी वॉलेट न लगाएँ:\nयह कुंजी सर्वर पर रहती है। इसे गैस के लिए बस थोड़ा MON चाहिए।',
         port: 'सर्वर पोर्ट। कई होस्टिंग इसे खुद भेजते हैं।',
@@ -422,6 +466,7 @@ const ar = {
 الخيارات:
   --lang <رمز>    لغة الواجهة: ${LANG_CODES.join(', ')}
   --no-input      لا تسأل أبدًا. للتكامل المستمر والإعداد الآلي.
+  --logo, --web, --github, --x, --telegram   روابطك. كلها اختيارية.
   --help          إظهار هذه المساعدة.
   --version       إظهار الإصدار.
 
@@ -448,6 +493,16 @@ const ar = {
     warnLabel: 'انتبه:',
     warnBody: 'يجب أن تكون نقطة النهاية https وعامة. بدونها لا يستطيع العميل إرسال الطلب\nإليك ولا تنزيل النتيجة، ويبقى الوكيل بلا فائدة.',
     docs: 'الدليل الكامل: https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'الشعار: logo.svg بالحرف الأول من اسمك. استبدله بشعارك.',
+    brand: {
+        title: 'واجهتك. كل هذا اختياري — اضغط Enter للتخطي.',
+        logo: 'رابط شعارك (Enter: يُنشر الشعار الذي يقدّمه وكيلك)',
+        web: 'موقعك',
+        github: 'GitHub (المستخدم أو المستخدم/المستودع)',
+        x: 'X (اسم المستخدم)',
+        telegram: 'Telegram (اسم المستخدم)',
+        bad: 'لا يمكنني استخدام «{name}»، سأتركه فارغًا.',
+    },
     env: {
         key: 'المفتاح الخاص بمحفظة وكيلك المخصّصة.\nهي التي تتقاضى الأجر وتوقّع عمليات التسليم. لا تستخدم محفظتك الشخصية:\nهذا المفتاح يعيش على خادم. يكفيه قليل من MON لدفع الرسوم.',
         port: 'منفذ الخادم. كثير من الاستضافات تضبطه تلقائيًا.',
@@ -517,6 +572,7 @@ const fr = {
 Options:
   --lang <code>   Langue de l'interface : ${LANG_CODES.join(', ')}
   --no-input      Ne jamais poser de question. Pour la CI et les scripts.
+  --logo, --web, --github, --x, --telegram   Tes liens. Tous facultatifs.
   --help          Affiche cette aide.
   --version       Affiche la version.
 
@@ -543,6 +599,16 @@ La langue vient de --lang, puis de PANAL_LANG, puis de la locale du système.`,
     warnLabel: 'Attention :',
     warnBody: 'le point d\'entrée doit être en https public. Sans lui, le client ne peut ni\nvous envoyer la commande ni récupérer le résultat : l\'agent ne sert à rien.',
     docs: 'Guide complet : https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'Logo : logo.svg, avec ton initiale. Remplace-le par le tien.',
+    brand: {
+        title: 'Ta vitrine. Tout est facultatif — Entrée pour passer.',
+        logo: 'URL de ton logo (Entrée : celui que sert ton agent)',
+        web: 'Ton site',
+        github: 'GitHub (utilisateur ou utilisateur/dépôt)',
+        x: 'X (nom d\'utilisateur)',
+        telegram: 'Telegram (nom d\'utilisateur)',
+        bad: 'Je ne peux pas utiliser « {name} », je le laisse vide.',
+    },
     env: {
         key: 'Clé privée du portefeuille DÉDIÉ de votre agent.\nC\'est elle qui encaisse et qui signe les livraisons. N\'utilisez pas votre\nportefeuille personnel : celle-ci vit sur un serveur. Un peu de MON suffit.',
         port: 'Port du serveur. Beaucoup d\'hébergeurs l\'injectent eux-mêmes.',
@@ -616,6 +682,7 @@ const pt = {
 Opções:
   --lang <código>  Idioma da interface: ${LANG_CODES.join(', ')}
   --no-input       Nunca perguntar. Para CI e instalações automatizadas.
+  --logo, --web, --github, --x, --telegram   Os seus links. Todos opcionais.
   --help           Mostra esta ajuda.
   --version        Mostra a versão.
 
@@ -642,6 +709,16 @@ O idioma vem de --lang, depois de PANAL_LANG e, por fim, do locale do sistema.`,
     warnLabel: 'Atenção:',
     warnBody: 'o endpoint tem de ser https e público. Sem ele o cliente não consegue\nenviar-lhe o pedido nem descarregar o resultado, e o agente fica inútil.',
     docs: 'Guia completo: https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'Logótipo: logo.svg, com a sua inicial. Substitua-o pelo seu.',
+    brand: {
+        title: 'A sua montra. Tudo opcional — Enter para saltar.',
+        logo: 'URL do seu logótipo (Enter: publica o que o seu agente serve)',
+        web: 'O seu site',
+        github: 'GitHub (utilizador ou utilizador/repo)',
+        x: 'X (utilizador)',
+        telegram: 'Telegram (utilizador)',
+        bad: 'Não posso usar «{name}», deixo-o vazio.',
+    },
     env: {
         key: 'Chave privada da carteira DEDICADA do seu agente.\nÉ ela que recebe e que assina as entregas. Não use a sua carteira pessoal:\nesta vive num servidor. Só precisa de um pouco de MON para o gas.',
         port: 'Porta do servidor. Muitos alojamentos injetam-na sozinhos.',
@@ -713,6 +790,7 @@ const ru = {
 Опции:
   --lang <код>    Язык интерфейса: ${LANG_CODES.join(', ')}
   --no-input      Никогда не спрашивать. Для CI и автоматической установки.
+  --logo, --web, --github, --x, --telegram   Ваши ссылки. Все необязательные.
   --help          Показать эту справку.
   --version       Показать версию.
 
@@ -739,6 +817,16 @@ const ru = {
     warnLabel: 'Важно:',
     warnBody: 'эндпоинт должен быть публичным и по https. Без этого клиент не сможет ни\nотправить вам заказ, ни скачать результат, и агент останется декорацией.',
     docs: 'Полное руководство: https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'Логотип: logo.svg с первой буквой имени. Замените его своим.',
+    brand: {
+        title: 'Ваша витрина. Всё необязательно — Enter, чтобы пропустить.',
+        logo: 'Ссылка на логотип (Enter: возьмём тот, что отдаёт ваш агент)',
+        web: 'Ваш сайт',
+        github: 'GitHub (пользователь или пользователь/репозиторий)',
+        x: 'X (имя пользователя)',
+        telegram: 'Telegram (имя пользователя)',
+        bad: 'Не могу использовать «{name}», оставляю пустым.',
+    },
     env: {
         key: 'Приватный ключ ВЫДЕЛЕННОГО кошелька вашего агента.\nИменно он получает оплату и подписывает сдачу работы. Не используйте личный\nкошелёк: этот ключ живёт на сервере. Ему нужно немного MON только на газ.',
         port: 'Порт сервера. Многие хостинги подставляют его сами.',
@@ -811,6 +899,7 @@ const bn = {
 বিকল্প:
   --lang <কোড>    ইন্টারফেসের ভাষা: ${LANG_CODES.join(', ')}
   --no-input      কখনও প্রশ্ন করবে না। CI ও স্ক্রিপ্টেড সেটআপের জন্য।
+  --logo, --web, --github, --x, --telegram   আপনার লিংক। সবই ঐচ্ছিক।
   --help          এই সাহায্য দেখায়।
   --version       সংস্করণ দেখায়।
 
@@ -837,6 +926,16 @@ const bn = {
     warnLabel: 'খেয়াল রাখুন:',
     warnBody: 'এন্ডপয়েন্ট অবশ্যই সর্বজনীন https হতে হবে। নইলে ক্লায়েন্ট আপনাকে কাজ পাঠাতেও\nপারবে না, ফলাফল নামাতেও পারবে না — এজেন্ট অকেজো থেকে যাবে।',
     docs: 'সম্পূর্ণ গাইড: https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'লোগো: logo.svg, আপনার নামের প্রথম অক্ষর দিয়ে। নিজেরটা দিয়ে বদলে নিন।',
+    brand: {
+        title: 'আপনার সাইনবোর্ড। সবই ঐচ্ছিক — বাদ দিতে Enter চাপুন।',
+        logo: 'লোগোর URL (Enter: আপনার এজেন্ট নিজেরটাই দেবে)',
+        web: 'আপনার ওয়েবসাইট',
+        github: 'GitHub (ইউজার বা ইউজার/রেপো)',
+        x: 'X (ইউজারনেম)',
+        telegram: 'Telegram (ইউজারনেম)',
+        bad: '"{name}" ব্যবহার করা গেল না, খালি রাখছি।',
+    },
     env: {
         key: 'আপনার এজেন্টের নিবেদিত (DEDICATED) ওয়ালেটের প্রাইভেট কী।\nএটিই অর্থ গ্রহণ করে এবং ডেলিভারিতে স্বাক্ষর করে। ব্যক্তিগত ওয়ালেট ব্যবহার\nকরবেন না: এটি সার্ভারে থাকে। গ্যাসের জন্য সামান্য MON হলেই চলে।',
         port: 'সার্ভারের পোর্ট। অনেক হোস্টিং নিজেই এটি দেয়।',
@@ -906,6 +1005,7 @@ const ur = {
 اختیارات:
   --lang <کوڈ>    انٹرفیس کی زبان: ${LANG_CODES.join(', ')}
   --no-input      کبھی نہ پوچھیں۔ CI اور خودکار سیٹ اپ کے لیے۔
+  --logo, --web, --github, --x, --telegram   آپ کے لنکس۔ سب اختیاری۔
   --help          یہ مدد دکھائیں۔
   --version       ورژن دکھائیں۔
 
@@ -932,6 +1032,16 @@ const ur = {
     warnLabel: 'خیال رکھیں:',
     warnBody: 'اینڈ پوائنٹ کا عوامی https ہونا ضروری ہے۔ اس کے بغیر کلائنٹ نہ آپ کو کام بھیج\nسکتا ہے نہ نتیجہ اتار سکتا ہے، اور ایجنٹ بےکار رہ جاتا ہے۔',
     docs: 'مکمل رہنما: https://github.com/AgentHiv/Panal/tree/main/create-agent',
+    logoWritten: 'لوگو: logo.svg، آپ کے نام کے پہلے حرف کے ساتھ۔ اسے اپنے لوگو سے بدل دیں۔',
+    brand: {
+        title: 'آپ کی پہچان۔ سب اختیاری — چھوڑنے کے لیے Enter دبائیں۔',
+        logo: 'لوگو کا URL (Enter: آپ کا ایجنٹ اپنا خود دے گا)',
+        web: 'آپ کی ویب سائٹ',
+        github: 'GitHub (صارف یا صارف/ریپو)',
+        x: 'X (صارف نام)',
+        telegram: 'Telegram (صارف نام)',
+        bad: '«{name}» استعمال نہیں ہو سکتا، خالی چھوڑ رہا ہوں۔',
+    },
     env: {
         key: 'آپ کے ایجنٹ کے مخصوص (DEDICATED) والیٹ کی نجی کلید۔\nیہی ادائیگی وصول کرتی ہے اور ڈیلیوری پر دستخط کرتی ہے۔ اپنا ذاتی والیٹ نہ\nاستعمال کریں: یہ کلید سرور پر رہتی ہے۔ اسے گیس کے لیے تھوڑا سا MON چاہیے۔',
         port: 'سرور کا پورٹ۔ بہت سی ہوسٹنگ خود ہی دے دیتی ہیں۔',

package/dist/index.js

@@ -22,6 +22,7 @@ import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
 import { CATALOG, LANGS, fill, isLang, resolveLang } from './i18n.js';
+import { logoSvg } from './logo.js';
 const HERE = dirname(fileURLToPath(import.meta.url));
 /** La plantilla se empaqueta junto al binario (ver `files` del package.json). */
 const TEMPLATE = resolve(HERE, '..', 'template');
@@ -49,12 +50,41 @@ function fail(msg) {
     console.error(`\n${msg}\n`);
     process.exit(1);
 }
+/** Los enlaces del escaparate, en el mismo orden en que los pinta el mercado. */
+const ENLACES = ['logo', 'web', 'github', 'x', 'telegram'];
+const SIN_ENLACES = { logo: '', web: '', github: '', x: '', telegram: '' };
+/**
+ * Lo que se puede escribir dentro de la plantilla, y por qué es tan estrecho.
+ *
+ * Este valor acaba DENTRO de un literal de TypeScript, en `src/register.ts`.
+ * Una comilla, una barra invertida o un salto de línea no dan un enlace mal
+ * puesto: dan un archivo que no compila, o —peor— uno que compila haciendo otra
+ * cosa. El alfabeto de aquí es el de una URL y el de un nombre de usuario, y
+ * nada más.
+ *
+ * NO valida el enlace. De eso se encarga el SDK al registrar, con reglas por
+ * red (`usuario`, `usuario/repo`, `+invitación`…). Aquí solo se comprueba que
+ * se pueda escribir sin romper nada, y el tope de 120 es el mismo que aguanta
+ * la ficha on-chain.
+ */
+const ESCRIBIBLE = /^[A-Za-z0-9:/?#@!&()*+,;=._~%-]{1,120}$/;
+function limpiaEnlace(crudo) {
+    const valor = crudo.trim();
+    return ESCRIBIBLE.test(valor) ? valor : '';
+}
 /**
  * Se admite `--lang es` y `--lang=es`. No es capricho: la primera forma es la
  * que teclea una persona y la segunda la que escriben los scripts.
  */
 function parseArgs(argv) {
-    const args = { name: null, lang: null, noInput: false, help: false, version: false };
+    const args = {
+        name: null,
+        lang: null,
+        noInput: false,
+        help: false,
+        version: false,
+        links: { ...SIN_ENLACES },
+    };
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
         if (a === '--help' || a === '-h')
@@ -67,8 +97,17 @@ function parseArgs(argv) {
             args.lang = argv[++i] ?? '';
         else if (a.startsWith('--lang='))
             args.lang = a.slice('--lang='.length);
-        else if (!a.startsWith('-') && args.name === null)
-            args.name = a;
+        else {
+            // Los cinco enlaces, en las dos formas: `--x panal` y `--x=panal`.
+            const enlace = ENLACES.find((e) => a === `--${e}` || a.startsWith(`--${e}=`));
+            if (enlace) {
+                const crudo = a.includes('=') ? a.slice(a.indexOf('=') + 1) : (argv[++i] ?? '');
+                args.links[enlace] = limpiaEnlace(crudo);
+            }
+            else if (!a.startsWith('-') && args.name === null) {
+                args.name = a;
+            }
+        }
     }
     return args;
 }
@@ -108,8 +147,49 @@ async function askLang() {
         rl.close();
     }
 }
+/**
+ * Las preguntas del escaparate: el logo y los enlaces del creador.
+ *
+ * Existen por una razón concreta: en el mercado un agente sale entre
+ * desconocidos, y un repositorio que se puede abrir dice más de él que
+ * cualquier frase que escriba sobre sí mismo. Antes esto solo se podía poner
+ * editando `src/register.ts` a mano, y un campo al que hay que ir no lo rellena
+ * nadie.
+ *
+ * TODAS SE SALTAN CON ENTER, y no se preguntan siquiera sin terminal
+ * interactiva ni con `--no-input`: quien monta esto en un Dockerfile no puede
+ * contestar, y una pregunta ahí cuelga el proceso para siempre.
+ *
+ * Lo que llega por bandera no se vuelve a preguntar.
+ */
+async function askLinks(t, yaPuestos) {
+    const { createInterface } = await import('node:readline/promises');
+    const puestos = { ...yaPuestos };
+    console.log(`\n${c.bold(t.brand.title)}\n`);
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        for (const clave of ENLACES) {
+            if (puestos[clave])
+                continue;
+            const dicho = (await rl.question(`  ${t.brand[clave]}: `)).trim();
+            if (!dicho)
+                continue;
+            const limpio = limpiaEnlace(dicho);
+            // Se avisa y se sigue. Un enlace raro no puede costarle a nadie volver a
+            // empezar el alta: lo puede poner luego en `src/register.ts`.
+            if (!limpio)
+                console.log(c.yellow(`     ${fill(t.brand.bad, { name: dicho })}`));
+            else
+                puestos[clave] = limpio;
+        }
+    }
+    finally {
+        rl.close();
+    }
+    return puestos;
+}
 /** Copia la plantilla sustituyendo los marcadores. */
-function copyTemplate(dest, name, t) {
+function copyTemplate(dest, name, links, t) {
     cpSync(TEMPLATE, dest, { recursive: true });
     for (const [from, to] of Object.entries(RENAMES)) {
         const src = join(dest, from);
@@ -117,6 +197,16 @@ function copyTemplate(dest, name, t) {
             fail(fill(t.errTemplateMissing, { name: from }));
         renameSync(src, join(dest, to));
     }
+    // Un enlace vacío deja `logo: ''` en el perfil, que es exactamente lo que
+    // había antes de que se pudieran pasar: no rellenar nada no cambia nada.
+    const marcadores = {
+        __NAME__: name,
+        __LINK_LOGO__: links.logo,
+        __LINK_WEB__: links.web,
+        __LINK_GITHUB__: links.github,
+        __LINK_X__: links.x,
+        __LINK_TELEGRAM__: links.telegram,
+    };
     const walk = (dir) => {
         for (const entry of readdirSync(dir)) {
             const full = join(dir, entry);
@@ -125,7 +215,10 @@ function copyTemplate(dest, name, t) {
                 continue;
             }
             const before = readFileSync(full, 'utf8');
-            const after = before.replaceAll('__NAME__', name);
+            let after = before;
+            for (const [marcador, valor] of Object.entries(marcadores)) {
+                after = after.replaceAll(marcador, valor);
+            }
             if (after !== before)
                 writeFileSync(full, after, 'utf8');
         }
@@ -215,21 +308,31 @@ async function main() {
         fail(fill(t.errDirExists, { name }));
     if (!existsSync(TEMPLATE))
         fail(fill(t.errTemplateMissing, { name: TEMPLATE }));
-    mkdirSync(dest, { recursive: true });
-    copyTemplate(dest, name, t);
-    const envExample = writeEnvExample(dest, t);
+    // El escaparate se pregunta AQUÍ: después de validar el nombre y la carpeta,
+    // para no hacer cinco preguntas y fallar luego, y antes de copiar nada,
+    // porque los enlaces se escriben dentro de la plantilla al copiarla.
+    const links = interactivo ? await askLinks(t, args.links) : args.links;
     // Wallet dedicada, generada aquí. La alternativa —"crea una wallet y pega la
     // clave"— es donde la gente acaba pegando la de su MetaMask personal, que es
     // exactamente lo que no debe vivir en un servidor.
     const privateKey = generatePrivateKey();
     const address = privateKeyToAccount(privateKey).address;
+    mkdirSync(dest, { recursive: true });
+    copyTemplate(dest, name, links, t);
+    const envExample = writeEnvExample(dest, t);
     writeFileSync(join(dest, '.env'), envExample.replace('AGENT_PRIVATE_KEY=', `AGENT_PRIVATE_KEY=${privateKey}`), 'utf8');
+    // Su cara desde el primer minuto. El servidor de la plantilla ya sirve este
+    // archivo en `/logo`, y el registro publica esa URL solo si no has puesto
+    // otra: un agente recién generado deja de salir igual que todos los demás sin
+    // que haya que hacer nada.
+    writeFileSync(join(dest, 'logo.svg'), logoSvg(name, address), 'utf8');
     // El README del proyecto, en su idioma. Es donde vive lo que no cabe en la
     // pantalla de alta: cómo se cobra, qué hace cada archivo y qué rompe agentes.
     writeFileSync(join(dest, 'README.md'), fill(t.readme, { name, address }), 'utf8');
     console.log(`\n${c.green('✓')} ${c.bold(fill(t.created, { name }))}\n`);
     console.log(`  ${t.walletLabel} ${c.bold(address)}`);
-    console.log(c.dim(`  ${fill(t.walletNote, { name })}\n`));
+    console.log(c.dim(`  ${fill(t.walletNote, { name })}`));
+    console.log(c.dim(`  ${t.logoWritten}\n`));
     console.log(c.bold(`${t.stepsTitle}\n`));
     console.log(`  ${c.bold('1.')} ${t.s1Title}`);
     console.log(c.dim(`       ${fill(t.s1Install, { name })}`));

package/dist/logo.js

@@ -0,0 +1,76 @@
+/**
+ * El logo con el que nace un agente.
+ *
+ * Un agente recién generado salía en el mercado con el hexágono gris que se
+ * dibuja a partir de su wallet, igual que todos los demás. No es que quedara
+ * feo: es que en una lista de agentes indistinguibles nadie recuerda cuál era
+ * el suyo, y el sitio donde eso importa es justo el escaparate.
+ *
+ * Así que se escribe un `logo.svg` en el proyecto. No hace falta hacer nada
+ * más: el servidor de la plantilla ya lo sirve en `/logo` y el registro lo
+ * publica solo. Y es un archivo normal en la carpeta, así que cambiarlo por el
+ * de verdad es sobrescribirlo.
+ *
+ * POR QUÉ UNA LETRA Y NO EL HEXÁGONO GENERADO. El avatar que ya pinta el
+ * mercado sale de la dirección, y copiarlo aquí daría exactamente la misma
+ * imagen: un logo que no se distingue del hueco que rellena no es un logo. La
+ * inicial del nombre distingue de un vistazo y funciona en cualquier alfabeto,
+ * que es más de lo que se puede decir de un icono elegido por nosotros.
+ */
+/** La paleta de Panal, la misma que usa el avatar del mercado. */
+const FONDOS = ['#E29A2E', '#836EF9', '#6E7B4E', '#1B1814'];
+/** Sobre cualquiera de esos cuatro, este contraste vale. */
+const TINTA = '#F2EFFA';
+/** Hash estable (djb2), el mismo que el avatar del mercado. */
+function semilla(texto) {
+    let h = 5381;
+    for (let i = 0; i < texto.length; i++)
+        h = ((h << 5) + h + texto.charCodeAt(i)) >>> 0;
+    return h;
+}
+/** Un hexágono de lado plano centrado en 48,48. */
+function hexagono(r) {
+    const puntos = [];
+    for (let k = 0; k < 6; k++) {
+        const a = (Math.PI / 3) * k;
+        puntos.push(`${(48 + r * Math.cos(a)).toFixed(2)},${(48 + r * Math.sin(a)).toFixed(2)}`);
+    }
+    return puntos.join(' ');
+}
+/** `&`, `<` y `"` dentro de un nombre romperían el SVG. */
+function escapar(texto) {
+    return texto
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/**
+ * La inicial del nombre.
+ *
+ * Se coge el primer PUNTO DE CÓDIGO, no el primer `char`: un nombre que empiece
+ * por un emoji o por un ideograma fuera del plano básico son dos `char`, y
+ * quedarse con el primero produce media letra —un carácter de reemplazo— que ni
+ * siquiera se puede pintar.
+ */
+export function inicial(nombre) {
+    const primero = [...nombre.trim()][0] ?? '?';
+    return primero.toLocaleUpperCase();
+}
+/** El SVG del logo con el que arranca un agente, listo para escribir. */
+export function logoSvg(nombre, direccion) {
+    const h = semilla(direccion || nombre);
+    const fondo = FONDOS[h % FONDOS.length];
+    const letra = escapar(inicial(nombre));
+    return [
+        '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 96 96" width="96" height="96"',
+        ` role="img" aria-label="${escapar(nombre)}">`,
+        `<title>${escapar(nombre)}</title>`,
+        `<polygon points="${hexagono(46)}" fill="${fondo}"/>`,
+        `<text x="48" y="49" text-anchor="middle" dominant-baseline="central"`,
+        ` font-family="system-ui, -apple-system, Segoe UI, Roboto, sans-serif"`,
+        ` font-size="44" font-weight="700" fill="${TINTA}">${letra}</text>`,
+        '</svg>',
+        '',
+    ].join('\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-panal-agent",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "Crea un agente de IA para Panal, funcionando y cobrando on-chain, en cinco minutos",
   "type": "module",
   "license": "MIT",
@@ -42,6 +42,6 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "tsx test/i18n.test.ts && tsx test/memoria.test.ts && tsx test/reintento.test.ts && tsx test/zip.test.ts && tsx test/adjuntos.test.ts && tsx test/subcontrata.test.ts && tsx test/salida.test.ts && tsx test/vigilante.test.ts && tsx test/scaffold.test.ts"
+    "test": "tsx test/i18n.test.ts && tsx test/logo.test.ts && tsx test/memoria.test.ts && tsx test/reintento.test.ts && tsx test/zip.test.ts && tsx test/adjuntos.test.ts && tsx test/subcontrata.test.ts && tsx test/salida.test.ts && tsx test/vigilante.test.ts && tsx test/scaffold.test.ts"
   }
 }

package/template/_package.json

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

package/template/src/register.ts

@@ -51,13 +51,19 @@ const PERFIL = {
   links: {
     // El logo sale en tu tarjeta, en el mercado y en la app. Https, cuadrado y
     // pequeño: se pinta a 56 px, no hace falta más.
-    logo: '',
-    web: '',
+    //
+    // DÉJALO VACÍO Y NO TIENES QUE HACER NADA: tu agente sirve el `logo.svg`
+    // que hay en esta carpeta, y al registrarte se comprueba que responde y se
+    // publica esa URL. El generador te escribió uno con la inicial de tu
+    // nombre; para poner el tuyo, sobrescribe el archivo (vale .svg, .png o
+    // .webp) y vuelve a ejecutar `npm run register`.
+    logo: '__LINK_LOGO__',
+    web: '__LINK_WEB__',
     // Tu perfil o el repositorio del agente: valen `usuario` y `usuario/repo`.
-    github: '',
+    github: '__LINK_GITHUB__',
     // Solo el usuario; también se traga el enlace entero si lo pegas.
-    x: '',
-    telegram: '',
+    x: '__LINK_X__',
+    telegram: '__LINK_TELEGRAM__',
   },
 };
 
@@ -172,6 +178,36 @@ async function compruebaEndpoint(botUrl: string, yo: string): Promise<string | n
   return null;
 }
 
+/**
+ * Tu logo, si no lo has puesto a mano pero tu agente sirve uno.
+ *
+ * La plantilla te deja un `logo.svg` en la carpeta y el servidor lo publica en
+ * `/logo`. Que exista el archivo no basta para escribirlo en la cadena: lo que
+ * se guarda es una URL, y una URL que no responde es un hueco en la tarjeta que
+ * cuesta otra transacción arreglar. Así que se pide de verdad antes de creerlo.
+ *
+ * NUNCA lanza ni bloquea el registro. Un logo es un extra; quedarse sin
+ * registrar por una imagen sería absurdo.
+ */
+async function logoQueSirves(botUrl: string): Promise<string> {
+  let url: string;
+  try {
+    url = new URL('/logo', botUrl).toString();
+  } catch {
+    return '';
+  }
+  try {
+    const res = await fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(8_000) });
+    const tipo = res.headers.get('content-type') ?? '';
+    // `image/` y no `200` a secas: un servidor delante que devuelva la página
+    // de error en HTML con estado 200 dejaría escrito en la cadena un logo que
+    // no es una imagen, y en la tarjeta un hueco sin explicación.
+    return res.ok && tipo.startsWith('image/') ? url : '';
+  } catch {
+    return '';
+  }
+}
+
 async function main(): Promise<void> {
   const key = process.env.AGENT_PRIVATE_KEY?.trim();
   if (!key || !/^0x[0-9a-fA-F]{64}$/.test(key)) {
@@ -215,23 +251,36 @@ async function main(): Promise<void> {
     process.exit(1);
   }
 
-  console.log(`\nPerfil:  ${formatAgentMetadata(PERFIL)}`);
-  console.log(`Precio:  ${formatEther(PRECIO)} ${MONEDA === NATIVE_CURRENCY ? 'MON' : '$PANAL'} por tarea\n`);
-
   // ¿Ya estabas? Registrarse dos veces revierte, así que se actualiza.
   const existente = await panal.getAgent(account.address).catch(() => null);
   const yaRegistrado = existente !== null && existente.registeredAt > 0n;
 
+  // Tu logo, si no lo pusiste a mano.
+  //
+  // Primero se mira si tu agente sirve uno; si no responde se conserva el que
+  // ya tuvieras publicado. Eso segundo importa más de lo que parece: sin ello,
+  // un corte de red de dos segundos durante un `npm run register` te borraría
+  // el logo de la ficha, y no lo dice nadie —la orden termina bien— hasta que
+  // alguien mira el mercado y ve el hexágono otra vez.
+  const puesto = PERFIL.links.logo.trim();
+  const servido = puesto ? '' : await logoQueSirves(PERFIL.botUrl);
+  const logo = puesto || servido || existente?.metadata.links.logo || '';
+  const perfil = { ...PERFIL, links: { ...PERFIL.links, logo } };
+  if (!puesto && logo) console.log(`Logo:    ${logo}${servido ? '' : ' (el que ya tenías: tu /logo no responde)'}`);
+
+  console.log(`\nPerfil:  ${formatAgentMetadata(perfil)}`);
+  console.log(`Precio:  ${formatEther(PRECIO)} ${MONEDA === NATIVE_CURRENCY ? 'MON' : '$PANAL'} por tarea\n`);
+
   if (yaRegistrado) {
     console.log('Ya estabas registrado: actualizo el perfil y el precio.');
-    await panal.updateMetadata(PERFIL);
+    await panal.updateMetadata(perfil);
     await panal.updatePrice(PRECIO, MONEDA);
     if (!existente.active) {
       await panal.setActive(true);
       console.log('Y te vuelvo a poner activo.');
     }
   } else {
-    await panal.registerAgent({ metadata: PERFIL, pricePerTask: PRECIO, currency: MONEDA });
+    await panal.registerAgent({ metadata: perfil, pricePerTask: PRECIO, currency: MONEDA });
     console.log('Registrado.');
   }
 

package/template/src/server.ts

@@ -23,7 +23,8 @@
 import 'dotenv/config';
 import { createServer, type IncomingMessage, type ServerResponse } from 'node:http';
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import {
   MAX_FILE_BYTES,
   appendFilesManifest,
@@ -103,6 +104,21 @@ if (NIVELES.length > 0 && NIVELES_OK.length !== NIVELES.length) {
 /** El nivel más barato: por debajo de eso, un agente con niveles no trabaja. */
 const NIVEL_MINIMO = NIVELES_OK[0] ?? null;
 
+// Se dicen al arrancar. Antes sólo salían dentro del bloque de subcontratación
+// —que no se imprime si no hay presupuesto—, así que un agente con niveles y
+// sin subcontratar arrancaba sin decir una palabra de lo que vende, y la única
+// forma de saber si habían entrado era pedirle la tarjeta.
+if (NIVELES_OK.length > 0) {
+  console.log(`Niveles (${NIVELES_OK.length}):`);
+  for (const n of NIVELES_OK) {
+    const topes = [
+      n.maxBriefChars === null ? null : `encargo ${n.maxBriefChars}`,
+      n.maxAttachCharsTotal === null ? null : `adjuntos ${n.maxAttachCharsTotal}`,
+    ].filter(Boolean);
+    console.log(`  ${n.name ?? '(sin nombre)'} · ${n.wei} · ${topes.length ? topes.join(', ') : 'topes de siempre'}`);
+  }
+}
+
 // Un nivel que se gasta subcontratando lo mismo que cobra trabaja gratis, y si
 // se pasa, trabaja pagando. No se corrige solo —es una decisión del autor— pero
 // no puede quedarse callado.
@@ -814,6 +830,60 @@ $('#enviar').onclick = async function(){
 };
 </script></body></html>`;
 
+/**
+ * Las rutas por las que se pide tu logo y los archivos donde se busca.
+ *
+ * El orden importa: si tienes un `logo.png` y un `logo.svg`, gana el SVG, que
+ * es el que escribe el generador y el que escala a cualquier tamaño.
+ */
+const RUTA_LOGO = /^\/logo(\.(svg|png|webp|jpe?g|gif))?$/;
+
+const LOGOS: [string, string][] = [
+  ['logo.svg', 'image/svg+xml; charset=utf-8'],
+  ['logo.png', 'image/png'],
+  ['logo.webp', 'image/webp'],
+  ['logo.jpg', 'image/jpeg'],
+  ['logo.jpeg', 'image/jpeg'],
+  ['logo.gif', 'image/gif'],
+];
+
+/**
+ * La carpeta de tu proyecto: este archivo vive en `src/`, así que se sube uno.
+ *
+ * Se calcula desde el módulo y no desde el directorio de trabajo porque no son
+ * lo mismo cuando alguien arranca el agente sin pasar por `npm start`: un
+ * `systemd` sin `WorkingDirectory=`, o un Docker con otro `WORKDIR`. Y ese caso
+ * NO se cae con estruendo —la clave puede venir de una variable de entorno de
+ * verdad en vez del `.env`— así que el agente trabaja igual y lo único que pasa
+ * es que su logo devuelve 404 y no llega a publicarse. En silencio.
+ */
+const RAIZ = join(dirname(fileURLToPath(import.meta.url)), '..');
+
+/**
+ * El primer logo que exista, o null si no publicas ninguno.
+ *
+ * Se mira primero junto al proyecto y después en el directorio de trabajo. El
+ * respaldo se queda a propósito: si alguien coloca ahí su logo —que es lo que
+ * hacía falta hasta ahora— sigue funcionando igual.
+ *
+ * Se lee en cada petición y no se cachea en memoria a propósito: cambiar de
+ * logo es dejar caer un archivo, y tener que reiniciar el agente —cortando los
+ * encargos en curso— para cambiar una imagen sería un precio absurdo. Los
+ * clientes ya lo cachean una hora por la cabecera.
+ */
+function buscaLogo(): { bytes: Buffer; tipo: string } | null {
+  for (const carpeta of [RAIZ, '.']) {
+    for (const [archivo, tipo] of LOGOS) {
+      try {
+        return { bytes: readFileSync(join(carpeta, archivo)), tipo };
+      } catch {
+        // No está: se prueba el siguiente formato.
+      }
+    }
+  }
+  return null;
+}
+
 function json(res: ServerResponse, status: number, body: unknown): void {
   res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' });
   res.end(JSON.stringify(body));
@@ -1034,6 +1104,44 @@ const server = createServer((req, res) => {
       return;
     }
 
+    // ---- Tu logo, si lo pones ------------------------------------------------
+    //
+    // Un archivo `logo.svg` —o `logo.png`, o `logo.webp`— junto al package.json
+    // y ya. El generador te deja uno escrito con la inicial de tu agente, para
+    // que no salgas sin cara desde el primer minuto: sobrescríbelo con el tuyo
+    // y no hay nada más que tocar.
+    //
+    // El registro guarda la URL, así que la imagen tiene que vivir en algún
+    // sitio; y el sitio natural es el mismo dominio que ya sirves, porque es el
+    // que la cadena ya dice que es tuyo.
+    //
+    // RESPONDE A `/logo` Y A CUALQUIER EXTENSIÓN, y sirve el archivo que de
+    // verdad tengas, sea cual sea la que te pidan. Suena descuidado y no lo es:
+    // los agentes que ya están registrados publicaron `…/logo.svg` y esa URL
+    // está escrita en la cadena, así que cambiar de formato no puede obligarles
+    // a pagar otra transacción. Lo que decide cómo se pinta una imagen es el
+    // `content-type`, no la extensión de la URL.
+    //
+    // Se sirve con CORS abierto a propósito: es una imagen pública que va a
+    // pintarse en escaparates ajenos, y sin la cabecera un `<canvas>` que la
+    // toque para hacer una miniatura se queda a oscuras.
+    if (RUTA_LOGO.test(url.pathname) && (req.method === 'GET' || req.method === 'HEAD')) {
+      const logo = buscaLogo();
+      if (!logo) {
+        json(res, 404, { error: 'este agente no publica logo' });
+        return;
+      }
+      res.writeHead(200, {
+        'content-type': logo.tipo,
+        'content-length': logo.bytes.byteLength,
+        'cache-control': 'public, max-age=3600',
+        'access-control-allow-origin': '*',
+        'x-content-type-options': 'nosniff',
+      });
+      res.end(req.method === 'HEAD' ? undefined : logo.bytes);
+      return;
+    }
+
     // Tarjeta de presentación: quién eres y qué sabes hacer.
     //
     // Si cobras por llamada hay que ANUNCIARLO aquí. Durante meses el bot de