create-panal-agent 0.13.1 → 0.14.0

package/dist/i18n.js

@@ -74,7 +74,7 @@ The language is taken from --lang, then PANAL_LANG, then your system locale.`,
         rpc: 'Your own RPC, if the public one falls short (it caps at ~15 calls/s).',
         data: 'Where to store delivered results.',
         x402: 'Charge per call (optional). Leave it empty and your agent only takes escrow jobs.\nThe price is per request, in an EIP-2612 token — it cannot be MON, the scheme needs `permit`.',
-        subcontrata: "Subcontracting (optional, off by default). Your agent can pay another one for what it cannot do itself (see ctx.consultar in agent.ts). Without a number here it never delegates.\nIt is in the x402 currency, NOT a cut of what you charge per task: a task is paid in MON and a question in $PANAL, and converting one into the other by eye would be inventing the budget. Put it BELOW what you charge per question (X402_PRICE): at or above it, every job where you delegate leaves you nothing and you still pay the gas — and that punishes exactly what you want your agent to do, because the better it recognises what it does not know, the more often it works for free. A third of your price is a sane start.",
+        subcontrata: "Subcontracting (optional, off by default). Your agent can pay another one for what it cannot do itself (see ctx.consultar in agent.ts). Without a number here it never delegates.\nIt is in the x402 currency, NOT a cut of what you charge per task: a task is paid in MON and a question in $PANAL, and converting one into the other by eye would be inventing the budget. Put it BELOW what you charge per question (X402_PRICE): at or above it, every job where you delegate leaves you nothing and you still pay the gas — and that punishes exactly what you want your agent to do, because the better it recognises what it does not know, the more often it works for free. A third of your price is a sane start. The number alone is not enough: you also need the SUBCONTRATA_SKILLS list in agent.ts, which says WHAT it may buy. Empty — as it ships — it never delegates, because the marketplace search generalises when it finds nobody, and a code agent asking for \"python video encoding\" would end up searching \"video\" and paying an agent that makes videos.",
         vigilante: "The watchman. Every 60 s it reviews your open tasks and recovers what got stuck: a delivery that was never anchored, work that died halfway, or a job that was paid for and never arrived.\nVIGILANTE=off turns it off. PUBLIC_URL is your https endpoint, used in the lost-job warning.",
         memoria: "Conversation memory (x402 only). Without it every paid call is independent: the client asks, you answer, and next time you do not know what it was about -- that is a search box with an invoice, not a chat.\nMEMORIA_TURNOS=0 turns it off. Both caps exist because the history goes INTO the prompt, and you pay for the prompt while the client pays a fixed price per message.",
         seguridad: "Hardening. LIMITE_POR_MINUTO caps requests per IP (0 disables it); every unauthenticated request costs one RPC call, so without a cap a curl loop leaves your agent unable to deliver.\nTRAS_PROXY=1 if a reverse proxy sits in front (Caddy, nginx) — the usual case, since your endpoint must be https. Without it every request arrives with the proxy's IP, so the cap above stops being per client and becomes a single global one shared by the indexer, browsers and your clients; once it fills, your agent answers 429 to everyone, and a client who cannot send you their brief waits out the deadline with their payment already locked. With no proxy, leave it off: trusting that header without one lets anyone invent an IP per request. AUTH_ESTRICTA=1 rejects download signatures with no expiry (the old format).",
@@ -170,7 +170,7 @@ El idioma sale de --lang, luego de PANAL_LANG, y si no del locale del sistema.`,
         rpc: 'RPC propio, si el público se te queda corto (limita a ~15 llamadas/s).',
         data: 'Dónde guardar los resultados entregados.',
         x402: 'Cobro por llamada (opcional). Déjalo vacío y tu agente solo acepta encargos del escrow.\nEl precio es por petición, en un token EIP-2612: no puede ser MON, el esquema necesita `permit`.',
-        subcontrata: "Subcontratar (opcional, apagado por defecto). Tu agente puede pagar a otro por lo que no sepa hacer (ver ctx.consultar en agent.ts). Sin un numero aqui, no delega nunca.\nVa en la moneda del x402 y NO se deduce de lo que cobras por tarea: una tarea se cobra en MON y una consulta en $PANAL, y convertir una en otra a ojo seria inventarse el presupuesto. Ponlo POR DEBAJO de lo que cobras por consulta (X402_PRICE): igual o por encima, cada encargo en el que delegues no te deja nada y encima pones el gas — y eso castiga justo lo que quieres que haga, porque cuanto mejor reconozca lo que no sabe, más veces trabaja gratis. Un tercio de tu precio es un buen punto de partida.",
+        subcontrata: "Subcontratar (opcional, apagado por defecto). Tu agente puede pagar a otro por lo que no sepa hacer (ver ctx.consultar en agent.ts). Sin un numero aqui, no delega nunca.\nVa en la moneda del x402 y NO se deduce de lo que cobras por tarea: una tarea se cobra en MON y una consulta en $PANAL, y convertir una en otra a ojo seria inventarse el presupuesto. Ponlo POR DEBAJO de lo que cobras por consulta (X402_PRICE): igual o por encima, cada encargo en el que delegues no te deja nada y encima pones el gas — y eso castiga justo lo que quieres que haga, porque cuanto mejor reconozca lo que no sabe, más veces trabaja gratis. Un tercio de tu precio es un buen punto de partida. Con el número no basta: hace falta además la lista SUBCONTRATA_SKILLS en agent.ts, que dice QUÉ puede comprar. Vacía —como viene— no delega nunca, porque el buscador del mercado generaliza cuando no encuentra a nadie, y un agente de código que pida \"python video encoding\" acabaría buscando \"video\" y pagándole a uno que hace vídeos.",
         vigilante: "El vigilante. Cada 60 s repasa tus tareas abiertas y recupera lo que se quedo colgado: una entrega que no llego a anclarse, un trabajo que murio a medias, o un encargo pagado que nunca llego.\nVIGILANTE=off lo apaga. PUBLIC_URL es tu endpoint https, para el aviso de encargo perdido.",
         memoria: "Memoria de la conversación (sólo x402). Sin ella cada llamada cobrada es independiente: el cliente pregunta, contestas, y a la siguiente no sabes de qué se hablaba — eso es un buscador con factura, no un chat.\nMEMORIA_TURNOS=0 la apaga. Los dos topes existen porque el historial entra EN el prompt, y el prompt lo pagas tú mientras el cliente paga un precio fijo por mensaje.",
         seguridad: "Endurecimiento. LIMITE_POR_MINUTO acota las peticiones por IP (0 lo desactiva); cada petición sin autenticar cuesta una llamada al RPC, así que sin tope un bucle de curl deja a tu agente sin poder entregar.\nTRAS_PROXY=1 si tienes un proxy delante (Caddy, nginx), que es lo normal porque tu endpoint tiene que ser https. Sin esto todas las peticiones llegan con la IP del proxy, así que el tope de arriba deja de ser por cliente y pasa a ser uno global que comparten el indexador, los navegadores y tus clientes; cuando se llena, tu agente responde 429 a todo el mundo, y un cliente que no puede mandarte su brief se queda esperando al plazo con el pago ya bloqueado. Sin proxy, déjalo apagado: fiarse de esa cabecera sin proxy permite inventarse una IP por petición. AUTH_ESTRICTA=1 rechaza las firmas de descarga sin caducidad (el formato antiguo).",
@@ -267,7 +267,7 @@ const zh = {
         rpc: '你自己的 RPC，当公共节点不够用时（其上限约为每秒 15 次调用）。',
         data: '交付结果的存放位置。',
         x402: '按次收费（可选）。留空则你的代理只接受托管订单。\n价格按每次请求计算，使用支持 EIP-2612 的代币——不能是 MON，该方案依赖 `permit`。',
-        subcontrata: "转包（可选，默认关闭）。你的代理可以为自己做不了的事付钱给另一个代理（见 agent.ts 的 ctx.consultar）。这里没有数字就永远不会转包。\n它使用 x402 的币种，不是按任务收入的比例：任务用 MON 结算，提问用 $PANAL，凭感觉换算等于凭空编造预算。 把它设得低于你每次提问的收费（X402_PRICE）：等于或高于该值时，每一笔你转包出去的活都赚不到钱，还要自付 gas——而这恰恰惩罚了你希望它做的事，因为它越善于识别自己不懂的部分，就越经常白干。取你价格的三分之一是个合理的起点。",
+        subcontrata: "转包（可选，默认关闭）。你的代理可以为自己做不了的事付钱给另一个代理（见 agent.ts 的 ctx.consultar）。这里没有数字就永远不会转包。\n它使用 x402 的币种，不是按任务收入的比例：任务用 MON 结算，提问用 $PANAL，凭感觉换算等于凭空编造预算。 把它设得低于你每次提问的收费（X402_PRICE）：等于或高于该值时，每一笔你转包出去的活都赚不到钱，还要自付 gas——而这恰恰惩罚了你希望它做的事，因为它越善于识别自己不懂的部分，就越经常白干。取你价格的三分之一是个合理的起点。 光有数字还不够：还需要 agent.ts 里的 SUBCONTRATA_SKILLS 列表，它规定了可以买什么。默认为空，也就永远不会转包；因为市场搜索在找不到人时会自动泛化，一个请求 \"python video encoding\" 的代码代理最后会搜索 \"video\"，把钱付给做视频的代理。",
         vigilante: "守望者。每 60 秒检查一次你未完成的任务，并挽回卡住的部分：没有上链的交付、中途死掉的工作，或已付款却从未送达的委托。\nVIGILANTE=off 可关闭。PUBLIC_URL 是你的 https 端点，用于丢失委托的提醒。",
         memoria: "对话记忆（仅限 x402）。没有它，每次付费调用都是独立的：客户提问，你回答，下一次你不知道之前在谈什么——那是带账单的搜索框，不是聊天。\nMEMORIA_TURNOS=0 可关闭。两个上限的存在是因为历史会进入提示词，而提示词由你付费，客户只付固定的每条消息价格。",
         seguridad: "加固。LIMITE_POR_MINUTO 限制每个 IP 的请求数（0 表示关闭）；每个未认证请求都要消耗一次 RPC 调用，没有上限时一个 curl 循环就能让你的代理无法交付。\nTRAS_PROXY=1 前面有反向代理时使用（Caddy、nginx）——这是常态，因为你的端点必须是 https。不设置时所有请求都带着代理的 IP，上面的上限就不再是每个客户端的，而变成由索引器、浏览器和你的客户共用的全局上限；一旦填满，你的代理会对所有人返回 429，而无法发送任务书的客户只能带着已锁定的付款等到期限。没有代理时请保持关闭：无代理却信任该请求头，任何人都能为每个请求伪造 IP。 AUTH_ESTRICTA=1 拒绝没有有效期的下载签名（旧格式）。",
@@ -359,7 +359,7 @@ const hi = {
         rpc: 'अपना RPC, अगर सार्वजनिक कम पड़े (इसकी सीमा ~15 कॉल/सेकंड है)।',
         data: 'दिए गए परिणाम कहाँ सहेजें।',
         x402: 'प्रति कॉल शुल्क (वैकल्पिक)। खाली छोड़ें तो आपका एजेंट केवल एस्क्रो वाले काम लेगा।\nकीमत प्रति अनुरोध है, EIP-2612 टोकन में — MON नहीं चल सकता, इस योजना को `permit` चाहिए।',
-        subcontrata: "सबकॉन्ट्रैक्टिंग (वैकल्पिक, डिफ़ॉल्ट रूप से बंद)। आपका एजेंट जो खुद नहीं कर सकता, उसके लिए दूसरे को भुगतान कर सकता है (agent.ts में ctx.consultar देखें)। यहाँ संख्या के बिना वह कभी नहीं सौंपता।\nयह x402 की मुद्रा में है, प्रति कार्य आय का हिस्सा नहीं: कार्य MON में और प्रश्न $PANAL में चुकाया जाता है। इसे अपने प्रति-प्रश्न शुल्क (X402_PRICE) से कम रखें: बराबर या अधिक होने पर, जिस भी काम में आप दूसरे को सौंपेंगे उसमें कुछ नहीं बचेगा और गैस भी आपकी जेब से जाएगी — और यह ठीक उसी व्यवहार को दंडित करता है जो आप चाहते हैं, क्योंकि आपका एजेंट जितना बेहतर पहचानेगा कि उसे क्या नहीं आता, उतनी ही बार वह मुफ़्त काम करेगा। अपने दाम का एक तिहाई एक समझदार शुरुआत है।",
+        subcontrata: "सबकॉन्ट्रैक्टिंग (वैकल्पिक, डिफ़ॉल्ट रूप से बंद)। आपका एजेंट जो खुद नहीं कर सकता, उसके लिए दूसरे को भुगतान कर सकता है (agent.ts में ctx.consultar देखें)। यहाँ संख्या के बिना वह कभी नहीं सौंपता।\nयह x402 की मुद्रा में है, प्रति कार्य आय का हिस्सा नहीं: कार्य MON में और प्रश्न $PANAL में चुकाया जाता है। इसे अपने प्रति-प्रश्न शुल्क (X402_PRICE) से कम रखें: बराबर या अधिक होने पर, जिस भी काम में आप दूसरे को सौंपेंगे उसमें कुछ नहीं बचेगा और गैस भी आपकी जेब से जाएगी — और यह ठीक उसी व्यवहार को दंडित करता है जो आप चाहते हैं, क्योंकि आपका एजेंट जितना बेहतर पहचानेगा कि उसे क्या नहीं आता, उतनी ही बार वह मुफ़्त काम करेगा। अपने दाम का एक तिहाई एक समझदार शुरुआत है। सिर्फ़ संख्या काफ़ी नहीं: agent.ts में SUBCONTRATA_SKILLS सूची भी चाहिए, जो बताती है कि वह क्या खरीद सकता है। खाली — जैसा यह आता है — तो वह कभी नहीं सौंपता, क्योंकि कोई न मिलने पर बाज़ार की खोज सामान्यीकरण कर देती है, और \"python video encoding\" माँगने वाला कोड एजेंट अंत में \"video\" खोजकर वीडियो बनाने वाले को भुगतान कर देगा।",
         vigilante: "प्रहरी। हर 60 सेकंड में आपके खुले कार्यों की जाँच करता है और जो अटक गया उसे वापस लाता है: वह डिलीवरी जो चेन पर दर्ज नहीं हुई, अधूरा रह गया काम, या भुगतान किया गया आदेश जो कभी नहीं पहुँचा।\nVIGILANTE=off इसे बंद करता है। PUBLIC_URL आपका https एंडपॉइंट है।",
         memoria: "बातचीत की स्मृति (केवल x402)। इसके बिना हर सशुल्क कॉल स्वतंत्र होती है: ग्राहक पूछता है, आप उत्तर देते हैं, और अगली बार आपको पता नहीं होता कि बात किस बारे में थी — वह चैट नहीं, बिल वाला सर्च बॉक्स है।\nMEMORIA_TURNOS=0 इसे बंद कर देता है। दोनों सीमाएँ इसलिए हैं कि इतिहास प्रॉम्प्ट में जाता है, और प्रॉम्प्ट का भुगतान आप करते हैं जबकि ग्राहक प्रति संदेश निश्चित मूल्य देता है।",
         seguridad: "सुरक्षा सख्ती। LIMITE_POR_MINUTO प्रति IP अनुरोध सीमित करता है (0 से बंद); हर बिना प्रमाणित अनुरोध एक RPC कॉल खर्च करता है, इसलिए बिना सीमा के एक curl लूप आपके एजेंट को डिलीवर करने से रोक सकता है।\nTRAS_PROXY=1 अगर आगे रिवर्स प्रॉक्सी हो (Caddy, nginx) — यही सामान्य है, क्योंकि आपका एंडपॉइंट https होना चाहिए। इसके बिना हर अनुरोध प्रॉक्सी के IP के साथ आता है, इसलिए ऊपर की सीमा प्रति-क्लाइंट नहीं रहती और एक वैश्विक सीमा बन जाती है जिसे इंडेक्सर, ब्राउज़र और आपके क्लाइंट साझा करते हैं; भर जाने पर आपका एजेंट सबको 429 देता है, और जो क्लाइंट अपना ब्रीफ़ नहीं भेज पाता वह भुगतान लॉक होने के बावजूद समय-सीमा तक इंतज़ार करता है। प्रॉक्सी न हो तो बंद रखें: बिना प्रॉक्सी उस हेडर पर भरोसा करने से कोई भी हर अनुरोध में मनमाना IP भेज सकता है। AUTH_ESTRICTA=1 बिना समय-सीमा वाले डाउनलोड हस्ताक्षर अस्वीकार करता है।",
@@ -455,7 +455,7 @@ const ar = {
         rpc: 'عقدة RPC خاصة بك، إن لم تكفِ العامة (حدّها نحو 15 طلبًا في الثانية).',
         data: 'مكان حفظ النتائج المُسلَّمة.',
         x402: 'التحصيل لكل استدعاء (اختياري). اتركه فارغًا فيقبل وكيلك مهام الضمان فقط.\nالسعر لكل طلب، بعملة تدعم EIP-2612 — لا يصلح MON، فالمخطط يحتاج `permit`.',
-        subcontrata: "التعاقد من الباطن (اختياري، معطل افتراضيا). يمكن لوكيلك ان يدفع لوكيل اخر مقابل ما لا يجيده (انظر ctx.consultar في agent.ts). بدون رقم هنا لن يفوض ابدا.\nيكون بعملة x402، وليس نسبة مما تتقاضاه عن المهمة: المهمة تدفع بـ MON والسؤال بـ $PANAL. اجعله أقل من سعر السؤال لديك (X402_PRICE): فعند التساوي أو الزيادة، كل مهمة تُسنِد فيها جزءًا إلى غيرك لا تُبقي لك شيئًا وتدفع الغاز من جيبك — وهذا يعاقب تحديدًا ما تريده منه، لأنه كلما أحسن إدراك ما يجهله عمل مجانًا أكثر. ثلث سعرك بداية معقولة.",
+        subcontrata: "التعاقد من الباطن (اختياري، معطل افتراضيا). يمكن لوكيلك ان يدفع لوكيل اخر مقابل ما لا يجيده (انظر ctx.consultar في agent.ts). بدون رقم هنا لن يفوض ابدا.\nيكون بعملة x402، وليس نسبة مما تتقاضاه عن المهمة: المهمة تدفع بـ MON والسؤال بـ $PANAL. اجعله أقل من سعر السؤال لديك (X402_PRICE): فعند التساوي أو الزيادة، كل مهمة تُسنِد فيها جزءًا إلى غيرك لا تُبقي لك شيئًا وتدفع الغاز من جيبك — وهذا يعاقب تحديدًا ما تريده منه، لأنه كلما أحسن إدراك ما يجهله عمل مجانًا أكثر. ثلث سعرك بداية معقولة. الرقم وحده لا يكفي: تحتاج أيضًا إلى قائمة SUBCONTRATA_SKILLS في agent.ts، التي تحدد ما الذي يُسمح بشرائه. وهي فارغة كما تأتي، فلا يفوّض أبدًا؛ لأن بحث السوق يعمّم عندما لا يجد أحدًا، فوكيل برمجة يطلب \"python video encoding\" ينتهي به الأمر باحثًا عن \"video\" ودافعًا لوكيل يصنع الفيديو.",
         vigilante: "الحارس. كل 60 ثانية يراجع مهامك المفتوحة ويستعيد ما تعطل: تسليم لم يثبت على السلسلة، او عمل مات في منتصفه، او طلب مدفوع لم يصل قط.\nVIGILANTE=off يوقفه. PUBLIC_URL هو نقطة الوصول https لديك.",
         memoria: "ذاكرة المحادثة (في x402 فقط). بدونها تكون كل مكالمة مدفوعة مستقلة: يسأل العميل، تجيب، وفي المرة التالية لا تعرف عمّا كان الحديث — هذا مربع بحث بفاتورة، لا محادثة.\nالقيمة MEMORIA_TURNOS=0 تُعطّلها. الحدّان موجودان لأن السجل يدخل في التوجيه، والتوجيه تدفعه أنت بينما يدفع العميل سعرًا ثابتًا لكل رسالة.",
         seguridad: "تقوية. LIMITE_POR_MINUTO يحد الطلبات لكل IP (0 يعطله)؛ كل طلب غير موثق يكلف استدعاء RPC، فبدون حد يكفي حلقة curl لتترك وكيلك عاجزا عن التسليم.\nTRAS_PROXY=1 إذا كان أمامه بروكسي عكسي (Caddy أو nginx) — وهو الوضع المعتاد لأن نقطة النهاية يجب أن تكون https. بدونه تصل كل الطلبات بعنوان IP الخاص بالبروكسي، فيتوقف الحد أعلاه عن كونه لكل عميل ويصبح حدًا عامًا واحدًا يتقاسمه المفهرس والمتصفحات وعملاؤك؛ وعند امتلائه يرد وكيلك بـ 429 على الجميع، ويظل العميل الذي تعذر عليه إرسال مهمته ينتظر انتهاء المهلة ودفعته محجوزة بالفعل. بلا بروكسي اتركه معطلًا: الوثوق بهذه الترويسة دون بروكسي يتيح لأي شخص اختلاق عنوان IP لكل طلب. AUTH_ESTRICTA=1 يرفض تواقيع التنزيل بلا انتهاء صلاحية.",
@@ -550,7 +550,7 @@ La langue vient de --lang, puis de PANAL_LANG, puis de la locale du système.`,
         rpc: 'Votre propre RPC, si le public ne suffit pas (limité à ~15 appels/s).',
         data: 'Où stocker les résultats livrés.',
         x402: "Facturation à l'appel (facultatif). Laissez vide et votre agent ne prend que des missions sous entiercement.\nLe prix est par requête, dans un jeton EIP-2612 : pas de MON, le schéma exige `permit`.",
-        subcontrata: "Sous-traitance (optionnelle, desactivee par defaut). Votre agent peut payer un autre pour ce qu il ne sait pas faire (voir ctx.consultar dans agent.ts). Sans un nombre ici, il ne delegue jamais.\nC est dans la devise x402, PAS une part de ce que vous facturez par tache : une tache se paie en MON et une question en $PANAL. Mettez-le EN DESSOUS de ce que vous facturez par question (X402_PRICE) : à égalité ou au-dessus, chaque travail où vous déléguez ne vous laisse rien et vous payez encore le gaz — et cela pénalise précisément ce que vous attendez de lui, car mieux il reconnaît ce qu'il ignore, plus souvent il travaille gratuitement. Un tiers de votre prix est un bon départ.",
+        subcontrata: "Sous-traitance (optionnelle, desactivee par defaut). Votre agent peut payer un autre pour ce qu il ne sait pas faire (voir ctx.consultar dans agent.ts). Sans un nombre ici, il ne delegue jamais.\nC est dans la devise x402, PAS une part de ce que vous facturez par tache : une tache se paie en MON et une question en $PANAL. Mettez-le EN DESSOUS de ce que vous facturez par question (X402_PRICE) : à égalité ou au-dessus, chaque travail où vous déléguez ne vous laisse rien et vous payez encore le gaz — et cela pénalise précisément ce que vous attendez de lui, car mieux il reconnaît ce qu'il ignore, plus souvent il travaille gratuitement. Un tiers de votre prix est un bon départ. Le nombre ne suffit pas : il faut aussi la liste SUBCONTRATA_SKILLS dans agent.ts, qui dit CE QU'il peut acheter. Vide — comme elle arrive — il ne délègue jamais, car la recherche du marché généralise quand elle ne trouve personne, et un agent de code demandant \"python video encoding\" finirait par chercher \"video\" et payer un agent qui fait des vidéos.",
         vigilante: "La sentinelle. Toutes les 60 s, elle passe en revue vos taches ouvertes et recupere ce qui est reste bloque : une livraison jamais ancree, un travail mort a mi-chemin, ou une commande payee qui n est jamais arrivee.\nVIGILANTE=off la desactive. PUBLIC_URL est votre endpoint https.",
         memoria: "Mémoire de la conversation (x402 uniquement). Sans elle, chaque appel payé est indépendant : le client demande, vous répondez, et la fois suivante vous ignorez de quoi il s'agissait — c'est un moteur de recherche avec facture, pas une conversation.\nMEMORIA_TURNOS=0 la désactive. Les deux plafonds existent parce que l'historique entre DANS le prompt, et le prompt c'est vous qui le payez pendant que le client paie un prix fixe par message.",
         seguridad: "Durcissement. LIMITE_POR_MINUTO limite les requêtes par IP (0 le désactive) ; chaque requête non authentifiée coûte un appel RPC, donc sans plafond une boucle curl empêche votre agent de livrer.\nTRAS_PROXY=1 si un proxy inverse se trouve devant (Caddy, nginx) — le cas habituel, puisque votre endpoint doit être en https. Sans cela, toutes les requêtes arrivent avec l'IP du proxy : la limite ci-dessus cesse d'être par client et devient une limite globale partagée par l'indexeur, les navigateurs et vos clients ; une fois pleine, votre agent répond 429 à tout le monde, et un client qui ne peut pas vous envoyer sa commande attend l'échéance avec son paiement déjà bloqué. Sans proxy, laissez-le désactivé : faire confiance à cet en-tête sans proxy permet d'inventer une IP par requête. AUTH_ESTRICTA=1 rejette les signatures de téléchargement sans expiration.",
@@ -649,7 +649,7 @@ O idioma vem de --lang, depois de PANAL_LANG e, por fim, do locale do sistema.`,
         rpc: 'RPC próprio, se o público não chegar (limita a ~15 chamadas/s).',
         data: 'Onde guardar os resultados entregues.',
         x402: 'Cobrança por chamada (opcional). Deixe vazio e o seu agente só aceita trabalhos do escrow.\nO preço é por pedido, num token EIP-2612: não pode ser MON, o esquema precisa de `permit`.',
-        subcontrata: "Subcontratar (opcional, desligado por omissao). O seu agente pode pagar a outro pelo que nao sabe fazer (ver ctx.consultar em agent.ts). Sem um numero aqui, nunca delega.\nVai na moeda do x402 e NAO e uma fatia do que cobra por tarefa: uma tarefa paga-se em MON e uma pergunta em $PANAL. Põe-no ABAIXO do que cobras por pergunta (X402_PRICE): igual ou acima, cada trabalho em que delegues não te deixa nada e ainda pagas o gás — e isso penaliza exactamente o que queres que ele faça, porque quanto melhor reconhecer o que não sabe, mais vezes trabalha de graça. Um terço do teu preço é um começo sensato.",
+        subcontrata: "Subcontratar (opcional, desligado por omissao). O seu agente pode pagar a outro pelo que nao sabe fazer (ver ctx.consultar em agent.ts). Sem um numero aqui, nunca delega.\nVai na moeda do x402 e NAO e uma fatia do que cobra por tarefa: uma tarefa paga-se em MON e uma pergunta em $PANAL. Põe-no ABAIXO do que cobras por pergunta (X402_PRICE): igual ou acima, cada trabalho em que delegues não te deixa nada e ainda pagas o gás — e isso penaliza exactamente o que queres que ele faça, porque quanto melhor reconhecer o que não sabe, mais vezes trabalha de graça. Um terço do teu preço é um começo sensato. O número não chega: é preciso também a lista SUBCONTRATA_SKILLS em agent.ts, que diz O QUE pode comprar. Vazia — como vem — nunca delega, porque a busca do mercado generaliza quando não encontra ninguém, e um agente de código que peça \"python video encoding\" acabaria a procurar \"video\" e a pagar a um que faz vídeos.",
         vigilante: "O vigia. A cada 60 s reve as suas tarefas abertas e recupera o que ficou preso: uma entrega que nunca foi ancorada, trabalho que morreu a meio, ou uma encomenda paga que nunca chegou.\nVIGILANTE=off desliga-o. PUBLIC_URL e o seu endpoint https.",
         memoria: "Memória da conversa (só x402). Sem ela cada chamada paga é independente: o cliente pergunta, respondes, e da próxima vez não sabes do que se falava — isso é uma caixa de pesquisa com fatura, não um chat.\nMEMORIA_TURNOS=0 desliga-a. Os dois limites existem porque o histórico entra NO prompt, e o prompt pagas tu enquanto o cliente paga um preço fixo por mensagem.",
         seguridad: "Endurecimento. LIMITE_POR_MINUTO limita os pedidos por IP (0 desativa); cada pedido não autenticado custa uma chamada RPC, por isso sem limite um ciclo de curl deixa o seu agente sem poder entregar.\nTRAS_PROXY=1 se houver um proxy reverso à frente (Caddy, nginx) — o normal, já que o teu endpoint tem de ser https. Sem isso todos os pedidos chegam com o IP do proxy, portanto o limite acima deixa de ser por cliente e passa a ser um único limite global partilhado pelo indexador, pelos navegadores e pelos teus clientes; quando enche, o teu agente responde 429 a toda a gente, e um cliente que não consegue enviar-te o pedido fica à espera do prazo com o pagamento já bloqueado. Sem proxy, deixa-o desligado: confiar nesse cabeçalho sem proxy permite inventar um IP por pedido. AUTH_ESTRICTA=1 rejeita assinaturas de descarga sem validade.",
@@ -746,7 +746,7 @@ const ru = {
         rpc: 'Свой RPC, если публичного не хватает (лимит ~15 запросов/с).',
         data: 'Где хранить сданные результаты.',
         x402: 'Плата за вызов (необязательно). Оставьте пустым — агент будет брать только заказы через эскроу.\nЦена за один запрос, в токене с EIP-2612: MON не подходит, схеме нужен `permit`.',
-        subcontrata: "Субподряд (необязательно, по умолчанию выключен). Ваш агент может заплатить другому за то, чего не умеет сам (см. ctx.consultar в agent.ts). Без числа здесь он никогда не делегирует.\nУказывается в валюте x402, а НЕ долей от оплаты за задачу: задача оплачивается в MON, а вопрос в $PANAL. Поставьте НИЖЕ того, что берёте за вопрос (X402_PRICE): при равенстве или выше каждая работа, где вы делегируете, не приносит ничего, а газ вы платите сами — и это наказывает ровно то поведение, которого вы добиваетесь: чем лучше агент понимает, чего не знает, тем чаще работает даром. Треть вашей цены — разумное начало.",
+        subcontrata: "Субподряд (необязательно, по умолчанию выключен). Ваш агент может заплатить другому за то, чего не умеет сам (см. ctx.consultar в agent.ts). Без числа здесь он никогда не делегирует.\nУказывается в валюте x402, а НЕ долей от оплаты за задачу: задача оплачивается в MON, а вопрос в $PANAL. Поставьте НИЖЕ того, что берёте за вопрос (X402_PRICE): при равенстве или выше каждая работа, где вы делегируете, не приносит ничего, а газ вы платите сами — и это наказывает ровно то поведение, которого вы добиваетесь: чем лучше агент понимает, чего не знает, тем чаще работает даром. Треть вашей цены — разумное начало. Одного числа мало: нужен ещё список SUBCONTRATA_SKILLS в agent.ts, который говорит, ЧТО можно покупать. Пустой — а таким он и поставляется — и агент никогда не делегирует, потому что поиск по рынку обобщает запрос, если никого не нашёл: агент по коду, попросивший \"python video encoding\", в итоге станет искать \"video\" и заплатит тому, кто делает видео.",
         vigilante: "Сторож. Каждые 60 с проверяет ваши открытые задачи и вытаскивает то, что застряло: доставку, которая не попала в блокчейн, работу, оборвавшуюся на середине, или оплаченный заказ, который так и не пришел.\nVIGILANTE=off выключает его. PUBLIC_URL ваш https-эндпоинт.",
         memoria: "Память разговора (только x402). Без неё каждый оплаченный вызов независим: клиент спрашивает, вы отвечаете, а в следующий раз вы не знаете, о чём шла речь — это поисковая строка со счётом, а не чат.\nMEMORIA_TURNOS=0 отключает её. Оба предела существуют потому, что история попадает В промпт, а промпт оплачиваете вы, тогда как клиент платит фиксированную цену за сообщение.",
         seguridad: "Усиление защиты. LIMITE_POR_MINUTO ограничивает запросы с одного IP (0 отключает); каждый неаутентифицированный запрос стоит одного вызова RPC, поэтому без лимита цикл curl лишает агента возможности сдавать работу.\nTRAS_PROXY=1 если впереди стоит обратный прокси (Caddy, nginx) — обычный случай, ведь ваш эндпоинт должен быть https. Без этого все запросы приходят с IP прокси, поэтому лимит выше перестаёт быть на клиента и становится единым глобальным, который делят индексатор, браузеры и ваши клиенты; когда он заполняется, ваш агент отвечает 429 всем, а клиент, не сумевший отправить задание, ждёт истечения срока с уже заблокированной оплатой. Без прокси оставьте выключенным: доверять этому заголовку без прокси — значит позволить подделывать IP в каждом запросе. AUTH_ESTRICTA=1 отклоняет подписи скачивания без срока действия.",
@@ -844,7 +844,7 @@ const bn = {
         rpc: 'নিজস্ব RPC, যদি সর্বজনীনটি যথেষ্ট না হয় (সীমা প্রায় ১৫ কল/সেকেন্ড)।',
         data: 'সরবরাহ করা ফলাফল কোথায় রাখা হবে।',
         x402: 'প্রতি কলে চার্জ (ঐচ্ছিক)। ফাঁকা রাখলে আপনার এজেন্ট কেবল এসক্রো কাজ নেবে।\nদাম প্রতি অনুরোধে, EIP-2612 টোকেনে — MON চলবে না, স্কিমটির `permit` দরকার।',
-        subcontrata: "সাবকন্ট্রাক্টিং (ঐচ্ছিক, ডিফল্টে বন্ধ)। আপনার এজেন্ট যা নিজে পারে না, তার জন্য অন্যকে অর্থ দিতে পারে (agent.ts-এ ctx.consultar দেখুন)। এখানে সংখ্যা না থাকলে সে কখনও দায়িত্ব দেয় না।\nএটি x402-এর মুদ্রায়, কাজপ্রতি আয়ের অংশ নয়: কাজের দাম MON-এ আর প্রশ্নের দাম $PANAL-এ। এটি আপনার প্রতি-প্রশ্ন মূল্যের (X402_PRICE) চেয়ে কম রাখুন: সমান বা বেশি হলে, যে কাজেই আপনি অন্যকে দেবেন তাতে কিছুই থাকবে না, গ্যাসও আপনার — আর এতে ঠিক সেই আচরণই শাস্তি পায় যা আপনি চান, কারণ এজেন্ট যত ভালোভাবে বুঝবে সে কী জানে না, তত বেশিবার সে বিনামূল্যে কাজ করবে। আপনার দামের এক-তৃতীয়াংশ একটি যুক্তিসঙ্গত শুরু।",
+        subcontrata: "সাবকন্ট্রাক্টিং (ঐচ্ছিক, ডিফল্টে বন্ধ)। আপনার এজেন্ট যা নিজে পারে না, তার জন্য অন্যকে অর্থ দিতে পারে (agent.ts-এ ctx.consultar দেখুন)। এখানে সংখ্যা না থাকলে সে কখনও দায়িত্ব দেয় না।\nএটি x402-এর মুদ্রায়, কাজপ্রতি আয়ের অংশ নয়: কাজের দাম MON-এ আর প্রশ্নের দাম $PANAL-এ। এটি আপনার প্রতি-প্রশ্ন মূল্যের (X402_PRICE) চেয়ে কম রাখুন: সমান বা বেশি হলে, যে কাজেই আপনি অন্যকে দেবেন তাতে কিছুই থাকবে না, গ্যাসও আপনার — আর এতে ঠিক সেই আচরণই শাস্তি পায় যা আপনি চান, কারণ এজেন্ট যত ভালোভাবে বুঝবে সে কী জানে না, তত বেশিবার সে বিনামূল্যে কাজ করবে। আপনার দামের এক-তৃতীয়াংশ একটি যুক্তিসঙ্গত শুরু। শুধু সংখ্যাই যথেষ্ট নয়: agent.ts-এ SUBCONTRATA_SKILLS তালিকাও লাগে, যা বলে দেয় সে কী কিনতে পারবে। খালি — যেমনটা আসে — হলে সে কখনও দায়িত্ব দেয় না, কারণ কাউকে না পেলে বাজারের খোঁজ সাধারণীকরণ করে, আর \"python video encoding\" চাওয়া কোড এজেন্ট শেষে \"video\" খুঁজে ভিডিও বানায় এমন কাউকে টাকা দিয়ে বসবে।",
         vigilante: "প্রহরী। প্রতি ৬০ সেকেন্ডে আপনার খোলা কাজগুলি দেখে এবং আটকে যাওয়া জিনিস উদ্ধার করে: চেইনে না ওঠা ডেলিভারি, মাঝপথে মরে যাওয়া কাজ, বা টাকা দেওয়া হয়েছে অথচ কখনও পৌঁছায়নি এমন আদেশ।\nVIGILANTE=off এটি বন্ধ করে। PUBLIC_URL আপনার https এন্ডপয়েন্ট।",
         memoria: "কথোপকথনের স্মৃতি (কেবল x402)। এটি ছাড়া প্রতিটি অর্থপ্রদত্ত কল স্বতন্ত্র: ক্লায়েন্ট জিজ্ঞাসা করে, আপনি উত্তর দেন, আর পরেরবার আপনি জানেন না কী নিয়ে কথা হচ্ছিল — সেটা চ্যাট নয়, বিলসহ সার্চ বক্স।\nMEMORIA_TURNOS=0 এটি বন্ধ করে। দুটি সীমা আছে কারণ ইতিহাস প্রম্পটে ঢোকে, আর প্রম্পটের খরচ আপনি দেন যখন ক্লায়েন্ট বার্তাপ্রতি নির্দিষ্ট দাম দেয়।",
         seguridad: "কঠোরকরণ। LIMITE_POR_MINUTO প্রতি IP অনুরোধ সীমিত করে (0 দিলে বন্ধ); প্রতিটি অননুমোদিত অনুরোধে একটি RPC কল খরচ হয়, তাই সীমা ছাড়া একটি curl লুপ আপনার এজেন্টকে ডেলিভারি করতে অক্ষম করে দেয়।\nTRAS_PROXY=1 যদি সামনে রিভার্স প্রক্সি থাকে (Caddy, nginx) — এটিই স্বাভাবিক, কারণ আপনার এন্ডপয়েন্ট https হতেই হবে। এটি ছাড়া প্রতিটি অনুরোধ প্রক্সির IP নিয়ে আসে, ফলে উপরের সীমা আর প্রতি-ক্লায়েন্ট থাকে না, বরং একটি বৈশ্বিক সীমা হয়ে যায় যা ইনডেক্সার, ব্রাউজার ও আপনার ক্লায়েন্টরা ভাগ করে; ভরে গেলে আপনার এজেন্ট সবাইকে 429 দেয়, আর যে ক্লায়েন্ট তার কাজের বিবরণ পাঠাতে পারে না সে অর্থ আটকে থাকা অবস্থায় সময়সীমা পর্যন্ত অপেক্ষা করে। প্রক্সি না থাকলে বন্ধ রাখুন: প্রক্সি ছাড়া ওই হেডারে ভরসা করলে যে কেউ প্রতি অনুরোধে IP বানিয়ে দিতে পারে। AUTH_ESTRICTA=1 মেয়াদহীন ডাউনলোড স্বাক্ষর প্রত্যাখ্যান করে।",
@@ -939,7 +939,7 @@ const ur = {
         rpc: 'اپنا RPC، اگر عوامی کم پڑ جائے (حد تقریباً 15 کالز فی سیکنڈ)۔',
         data: 'فراہم کردہ نتائج کہاں محفوظ ہوں۔',
         x402: 'فی کال وصولی (اختیاری)۔ خالی چھوڑ دیں تو آپ کا ایجنٹ صرف ایسکرو کے کام لے گا۔\nقیمت فی درخواست ہے، EIP-2612 ٹوکن میں — MON نہیں چل سکتا، اس اسکیم کو `permit` چاہیے۔',
-        subcontrata: "سب کنٹریکٹنگ (اختیاری، بذریعہ ڈیفالٹ بند)۔ آپ کا ایجنٹ جو خود نہیں کر سکتا اس کے لیے دوسرے کو ادائیگی کر سکتا ہے (agent.ts میں ctx.consultar دیکھیں)۔ یہاں نمبر کے بغیر وہ کبھی نہیں سونپتا۔\nیہ x402 کی کرنسی میں ہے، فی ٹاسک آمدنی کا حصہ نہیں: ٹاسک MON میں اور سوال $PANAL میں ادا ہوتا ہے۔ اسے اپنی فی سوال قیمت (X402_PRICE) سے کم رکھیں: برابر یا زیادہ ہونے پر، جس کام میں بھی آپ کسی اور کو دیں گے اس میں کچھ نہیں بچے گا اور گیس بھی آپ کی جیب سے جائے گی — اور یہ بالکل اسی رویّے کو سزا دیتا ہے جو آپ چاہتے ہیں، کیونکہ آپ کا ایجنٹ جتنا بہتر پہچانے گا کہ اسے کیا نہیں آتا، اتنی ہی زیادہ بار وہ مفت کام کرے گا۔ اپنی قیمت کا ایک تہائی معقول آغاز ہے۔",
+        subcontrata: "سب کنٹریکٹنگ (اختیاری، بذریعہ ڈیفالٹ بند)۔ آپ کا ایجنٹ جو خود نہیں کر سکتا اس کے لیے دوسرے کو ادائیگی کر سکتا ہے (agent.ts میں ctx.consultar دیکھیں)۔ یہاں نمبر کے بغیر وہ کبھی نہیں سونپتا۔\nیہ x402 کی کرنسی میں ہے، فی ٹاسک آمدنی کا حصہ نہیں: ٹاسک MON میں اور سوال $PANAL میں ادا ہوتا ہے۔ اسے اپنی فی سوال قیمت (X402_PRICE) سے کم رکھیں: برابر یا زیادہ ہونے پر، جس کام میں بھی آپ کسی اور کو دیں گے اس میں کچھ نہیں بچے گا اور گیس بھی آپ کی جیب سے جائے گی — اور یہ بالکل اسی رویّے کو سزا دیتا ہے جو آپ چاہتے ہیں، کیونکہ آپ کا ایجنٹ جتنا بہتر پہچانے گا کہ اسے کیا نہیں آتا، اتنی ہی زیادہ بار وہ مفت کام کرے گا۔ اپنی قیمت کا ایک تہائی معقول آغاز ہے۔ صرف عدد کافی نہیں: agent.ts میں SUBCONTRATA_SKILLS کی فہرست بھی چاہیے، جو بتاتی ہے کہ وہ کیا خرید سکتا ہے۔ خالی — جیسا کہ یہ آتا ہے — تو وہ کبھی کام نہیں سونپتا، کیونکہ کوئی نہ ملنے پر مارکیٹ کی تلاش عام کر دیتی ہے، اور \"python video encoding\" مانگنے والا کوڈ ایجنٹ آخر میں \"video\" ڈھونڈ کر ویڈیو بنانے والے کو ادائیگی کر بیٹھے گا۔",
         vigilante: "نگہبان۔ ہر 60 سیکنڈ میں آپ کے کھلے کام دیکھتا ہے اور جو اٹکا ہے اسے بچاتا ہے: وہ ڈیلیوری جو چین پر درج نہ ہوئی، وہ کام جو بیچ میں مر گیا، یا ادا شدہ آرڈر جو کبھی نہ پہنچا۔\nVIGILANTE=off اسے بند کرتا ہے۔ PUBLIC_URL آپ کا https اینڈ پوائنٹ ہے۔",
         memoria: "گفتگو کی یادداشت (صرف x402)۔ اس کے بغیر ہر ادا شدہ کال الگ ہوتی ہے: کلائنٹ پوچھتا ہے، آپ جواب دیتے ہیں، اور اگلی بار آپ کو معلوم نہیں ہوتا کہ بات کس بارے میں تھی — یہ چیٹ نہیں، بل والا سرچ باکس ہے۔\nMEMORIA_TURNOS=0 اسے بند کر دیتا ہے۔ دونوں حدیں اس لیے ہیں کہ تاریخ پرامپٹ میں جاتی ہے، اور پرامپٹ کا خرچ آپ اٹھاتے ہیں جبکہ کلائنٹ فی پیغام مقررہ قیمت دیتا ہے۔",
         seguridad: "سختی۔ LIMITE_POR_MINUTO فی IP درخواستیں محدود کرتا ہے (0 سے بند)؛ ہر غیر تصدیق شدہ درخواست ایک RPC کال خرچ کرتی ہے، اس لیے حد کے بغیر ایک curl لوپ آپ کے ایجنٹ کو ڈیلیور کرنے سے روک سکتا ہے۔\nTRAS_PROXY=1 اگر آگے ریورس پراکسی ہو (Caddy، nginx) — یہی معمول ہے، کیونکہ آپ کا اینڈ پوائنٹ https ہونا چاہیے۔ اس کے بغیر ہر درخواست پراکسی کے IP کے ساتھ آتی ہے، چنانچہ اوپر والی حد فی کلائنٹ نہیں رہتی بلکہ ایک عالمی حد بن جاتی ہے جسے انڈیکسر، براؤزر اور آپ کے کلائنٹ مل کر استعمال کرتے ہیں؛ بھر جانے پر آپ کا ایجنٹ سب کو 429 دیتا ہے، اور جو کلائنٹ اپنی ہدایت نہیں بھیج پاتا وہ ادائیگی مقفل ہونے کے باوجود مہلت تک انتظار کرتا ہے۔ پراکسی نہ ہو تو بند رکھیں: پراکسی کے بغیر اس ہیڈر پر بھروسہ کرنے سے کوئی بھی ہر درخواست میں IP گھڑ سکتا ہے۔ AUTH_ESTRICTA=1 بغیر میعاد والے ڈاؤن لوڈ دستخط مسترد کرتا ہے۔",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-panal-agent",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "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/salida.test.ts && tsx test/vigilante.test.ts && tsx test/scaffold.test.ts"
+    "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"
   }
 }

package/template/_package.json

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

package/template/src/adjuntos.ts

@@ -47,9 +47,22 @@ export interface AdjuntosLeidos {
 }
 
 /** Tope de caracteres que aporta UN adjunto. El encargo lo paga el agente. */
-const MAX_CHARS_POR_ADJUNTO = 8_000;
+export const MAX_CHARS_POR_ADJUNTO = 8_000;
 /** Y el de todos juntos, porque cinco archivos al tope son demasiado. */
-const MAX_CHARS_TOTAL = 24_000;
+export const MAX_CHARS_TOTAL = 24_000;
+
+/**
+ * Cuánto texto se deja entrar, si el nivel pagado da para más.
+ *
+ * Los topes de arriba son los de siempre y siguen siendo el valor por defecto.
+ * Un agente que venda un nivel «resúmeme este libro» necesita subirlos para
+ * ese encargo y sólo para ese: recortar un libro a 8 000 caracteres y cobrarlo
+ * igual es exactamente lo que no puede pasar.
+ */
+export interface TopesTexto {
+  porAdjunto?: number;
+  total?: number;
+}
 /** Archivos que se miran dentro de un ZIP. */
 const MAX_DENTRO_DEL_ZIP = 40;
 
@@ -263,15 +276,23 @@ function acotar(texto: string, tope: number): string {
  * Es `async` porque leer un PDF lo es. Los agentes ya trabajaban en `async`,
  * así que lo único que cambia para quien llama es un `await`.
  */
-export async function leerAdjuntos(adjuntos: AdjuntoRecibido[]): Promise<AdjuntosLeidos> {
+export async function leerAdjuntos(
+  adjuntos: AdjuntoRecibido[],
+  topes: TopesTexto = {},
+): Promise<AdjuntosLeidos> {
   const partes: string[] = [];
   const imagenes: ImagenAdjunta[] = [];
   let gastado = 0;
 
+  // Nunca por debajo del de siempre: un nivel mal declarado puede subir esto,
+  // no bajarlo por sorpresa a quien ya contaba con los 8 000 de toda la vida.
+  const porAdjunto = Math.max(topes.porAdjunto ?? 0, MAX_CHARS_POR_ADJUNTO);
+  const total = Math.max(topes.total ?? 0, MAX_CHARS_TOTAL);
+
   const anadir = (cabecera: string, cuerpo: string): void => {
-    const queda = MAX_CHARS_TOTAL - gastado;
+    const queda = total - gastado;
     if (queda <= 200) return;
-    const trozo = acotar(cuerpo, Math.min(MAX_CHARS_POR_ADJUNTO, queda));
+    const trozo = acotar(cuerpo, Math.min(porAdjunto, queda));
     gastado += trozo.length;
     partes.push(`--- ${cabecera} ---\n${trozo}\n--- fin ---`);
   };

package/template/src/agent.ts

@@ -13,7 +13,7 @@
 
 import { llmChat, resolverLlm, type CallEnvelope, type LlmConfig } from '@panal/sdk';
 import { leerAdjuntos, type AdjuntoRecibido, type AdjuntosLeidos } from './adjuntos.js';
-import { comoArchivo, formatoPedido } from './salida.js';
+import { comoArchivo, formatoPedido, nombreDelTema } from './salida.js';
 import { historialComoTexto, type Turno } from './memoria.js';
 
 /**
@@ -37,6 +37,18 @@ export interface TaskContext {
   /** Fecha límite de entrega, en segundos epoch. Cero en una llamada x402. */
   deadline: bigint;
 
+  /**
+   * QUÉ NIVEL COMPRÓ, si es que ofreces niveles.
+   *
+   * `null` es lo normal y significa que este agente no los ofrece: entonces
+   * todo funciona como siempre y no hay nada que mirar aquí.
+   *
+   * Lo decide `amount`, que está en la cadena, y NUNCA el texto del encargo:
+   * el brief lo escribe el cliente y podría proclamarse del nivel más caro.
+   * El motor ya lo ha resuelto por ti antes de llamarte.
+   */
+  nivel: NivelPropio | null;
+
   /**
    * LO QUE EL CLIENTE TE ADJUNTÓ: una foto, un PDF que revisar, un CSV.
    *
@@ -107,6 +119,110 @@ export interface TaskContext {
   historial: Turno[];
 }
 
+/**
+ * Un nivel de servicio: cuánto cobras y cuánto aceptas a cambio.
+ *
+ * Los topes van EN CARACTERES porque es lo que el cliente puede contar antes
+ * de pagar y cualquiera puede recontar después: el encargo se ancla en la
+ * cadena y el tamaño de cada adjunto viaja dentro de su manifiesto. Un nivel
+ * que prometiera «más esfuerzo» no habría manera de comprobarlo.
+ */
+export interface NivelPropio {
+  /** Cómo se llama en el escaparate. */
+  name: string;
+  /** Una línea de qué compra. */
+  description?: string;
+  /** Lo que tiene que bloquear en el escrow. `parseEther('0.3')` para MON. */
+  wei: bigint;
+  /** Tope del encargo en este nivel. Sin él, el de siempre. */
+  maxBriefChars?: number;
+  /** Cuánto texto aporta CADA adjunto en este nivel. */
+  maxAttachChars?: number;
+  /** Y todos juntos. */
+  maxAttachCharsTotal?: number;
+  /**
+   * Cuánto puede gastar tu agente SUBCONTRATANDO en este nivel.
+   *
+   * Sin esto, el de `SUBCONTRATA_MAX` del .env para todos los niveles por
+   * igual, que es lo que había antes. Ponerlo aquí es lo que permite que el
+   * nivel caro pueda comprar ayuda y el barato no.
+   *
+   * Que sea MENOR que `wei`, y con holgura: es dinero que sale de lo que te
+   * pagaron por este encargo. El motor avisa al arrancar si no lo es.
+   */
+  subcontrata?: bigint;
+}
+
+/**
+ * LOS NIVELES QUE VENDES. Vacío = no vendes niveles, que es lo normal.
+ *
+ * El registro guarda UN precio por agente, así que si quieres cobrar distinto
+ * por trabajos de distinto tamaño, es aquí. Y el primero debería costar lo
+ * mismo que tu `pricePerTask` registrado: es el que compra quien te contrata
+ * sin elegir nada, desde un cliente antiguo o desde una integración.
+ *
+ * En cuanto declaras uno, el motor deja de aceptar encargos por debajo del más
+ * barato. Eso es un cambio de comportamiento y es a propósito: los niveles no
+ * significan nada si se puede pagar el pequeño y mandar el grande.
+ *
+ * Ejemplo, para un agente que también resume libros (`parseEther` sale de
+ * viem, que ya es dependencia: `import { parseEther } from 'viem';`):
+ *
+ *     export const NIVELES: NivelPropio[] = [
+ *       { name: 'Encargo', wei: parseEther('0.1'), maxBriefChars: 32_000 },
+ *       {
+ *         name: 'Libro',
+ *         description: 'Hasta unas 300 páginas, en el encargo o adjuntas.',
+ *         wei: parseEther('0.3'),
+ *         maxBriefChars: 320_000,
+ *         maxAttachChars: 280_000,
+ *         maxAttachCharsTotal: 320_000,
+ *       },
+ *     ];
+ */
+export const NIVELES: NivelPropio[] = [];
+
+/**
+ * LAS ÚNICAS SKILLS QUE TU AGENTE PUEDE COMPRARLE A OTRO. Vacío = ninguna.
+ *
+ * Vacío es el valor por defecto y significa que NO SUBCONTRATA, aunque tenga
+ * presupuesto. Hacen falta las dos cosas: dinero y permiso.
+ *
+ * Existe porque quien elige la skill es un modelo, y el buscador generaliza
+ * cuando no encuentra a nadie: recorta por la izquierda, así que
+ * "python video encoding" acaba buscando "video". Un agente de código puede
+ * así pagarle a uno de vídeo, y lo malo es que el resultado PARECE correcto —
+ * pagó, le contestaron, entregó y ancló. Nadie ve un error; sólo la entrega
+ * es peor y el dinero se fue.
+ *
+ * La lista se comprueba en tres sitios, a propósito: se le dice al modelo qué
+ * puede pedir, se comprueba lo que contesta, y el SDK descarta cualquier
+ * variante que no esté aquí ANTES de cotizar. Un intento prohibido no cuesta
+ * ni una petición.
+ *
+ *     export const SUBCONTRATA_SKILLS = ['translation', 'legal'];
+ *
+ * Escríbelas como se venden en el mercado: una o dos palabras.
+ */
+export const SUBCONTRATA_SKILLS: string[] = [];
+
+/**
+ * ¿Puede este agente comprar esta skill?
+ *
+ * Va aparte y exportada porque es la regla que decide si sale dinero, y una
+ * regla así tiene que poder probarse sin levantar un agente. Compara sin
+ * distinguir mayúsculas ni espacios de más: la lista la escribe una persona y
+ * la skill la escribe un modelo.
+ *
+ * Con la lista vacía devuelve `false` para todo. Vacío es NO DELEGA, nunca
+ * «todo permitido»: la diferencia entre las dos lecturas se mide en dinero.
+ */
+export function skillPermitida(skill: string, permitidas: string[]): boolean {
+  const limpia = skill.trim().replace(/\s+/g, ' ').toLowerCase();
+  if (!limpia) return false;
+  return permitidas.some((p) => p.trim().replace(/\s+/g, ' ').toLowerCase() === limpia);
+}
+
 /** Un archivo que entregas junto al texto. */
 export interface TaskFile {
   /** Cómo se va a llamar. Sin rutas: `informe.pdf`, no `salida/informe.pdf`. */
@@ -178,7 +294,10 @@ export async function handleTask(brief: string, ctx: TaskContext): Promise<TaskR
 
   // Se abre TODO lo que mandó el cliente: imágenes para que las mire el
   // modelo, y el texto de los PDF, Word, Excel y carpetas que vengan dentro.
-  const leido = await leerAdjuntos(ctx.adjuntos);
+  const leido = await leerAdjuntos(ctx.adjuntos, {
+    ...(ctx.nivel?.maxAttachChars === undefined ? {} : { porAdjunto: ctx.nivel.maxAttachChars }),
+    ...(ctx.nivel?.maxAttachCharsTotal === undefined ? {} : { total: ctx.nivel.maxAttachCharsTotal }),
+  });
   if (ctx.adjuntos.length > 0) {
     console.log(
       `[agente] ${etiqueta(ctx)} ${ctx.adjuntos.length} adjunto(s), ${leido.imagenes.length} para el modelo: ` +
@@ -199,7 +318,7 @@ export async function handleTask(brief: string, ctx: TaskContext): Promise<TaskR
     const problema = revisar(brief, texto);
     if (!problema) {
       console.log(`[agente] ${etiqueta(ctx)} resuelta: ${texto.length} caracteres`);
-      return conArchivoSiLoPidio(brief, texto, ctx);
+      return await conArchivoSiLoPidio(brief, texto, ctx);
     }
     console.error(`[agente] ${etiqueta(ctx)} intento ${intento}: ${problema}`);
     // A la segunda se entrega igual. Tu revisión puede equivocarse, y un falso
@@ -207,7 +326,7 @@ export async function handleTask(brief: string, ctx: TaskContext): Promise<TaskR
     // entregar algo imperfecto y que él decida, que dejarlo sin nada.
     if (intento === 2) {
       console.error(`[agente] ${etiqueta(ctx)} se entrega pese a: ${problema}`);
-      return conArchivoSiLoPidio(brief, texto, ctx);
+      return await conArchivoSiLoPidio(brief, texto, ctx);
     }
     queja = problema;
   }
@@ -233,10 +352,11 @@ async function pedirAyudaSiHaceFalta(
   ctx: TaskContext,
   cfg: LlmConfig,
 ): Promise<string | null> {
-  // Sin presupuesto no hay nada que decidir, y así se ahorra la llamada.
-  if (ctx.presupuesto <= 0n) return null;
+  // Sin presupuesto o sin permiso no hay nada que decidir, y así se ahorra la
+  // llamada al modelo. Las dos condiciones hacen falta.
+  if (ctx.presupuesto <= 0n || SUBCONTRATA_SKILLS.length === 0) return null;
 
-  const decision = await decidirDelegacion(brief, cfg);
+  const decision = await decidirDelegacion(brief, cfg, SUBCONTRATA_SKILLS);
   if (!decision) return null;
 
   try {
@@ -280,6 +400,7 @@ function extraerJson(crudo: string): unknown {
 async function decidirDelegacion(
   brief: string,
   cfg: LlmConfig,
+  permitidas: string[],
 ): Promise<{ skill: string; pregunta: string } | null> {
   try {
     const crudo = await llmChat(
@@ -293,7 +414,12 @@ async function decidirDelegacion(
           '{"delegate": false} if you can do the job yourself. This is the right answer almost always.\n' +
           '{"delegate": true, "skill": "…", "question": "…"} ONLY if the job clearly needs expertise ' +
           'outside your own, and a specialist answer would measurably improve the result.\n' +
-          '"skill" is one or two words to search a marketplace by (e.g. "translation", "legal", "json").\n' +
+          // Se le da la lista CERRADA en vez de dejarle inventar. Un modelo al
+          // que se le pide "one or two words" contesta lo que le parece, y
+          // luego el buscador generaliza esa invención hasta encontrar a
+          // cualquiera. Aquí sólo puede elegir de lo que su autor permitió.
+          `"skill" MUST be copied EXACTLY from this list, and nothing else is allowed: ${permitidas.join(', ')}.\n` +
+          'If none of those fits the job, answer {"delegate": false}.\n' +
           '"question" is the self-contained question for that specialist: it will be sent on its own, ' +
           'so it must make sense without the rest of the job.\n' +
           'Paying costs real money. If in doubt, do not delegate.',
@@ -305,6 +431,12 @@ async function decidirDelegacion(
     const skill = parsed.skill?.trim();
     const pregunta = parsed.question?.trim();
     if (!skill || !pregunta) return null;
+    // Y se comprueba lo que contestó. Un modelo puede ignorar la lista, y de
+    // hecho lo hace: pedirle que elija de un menú no es lo mismo que obligarle.
+    if (!skillPermitida(skill, permitidas)) {
+      console.error(`[agente] el modelo pidió subcontratar "${skill}", que no está permitida. Trabaja solo.`);
+      return null;
+    }
     return { skill, pregunta };
   } catch {
     // Decidir mal no puede tumbar el encargo: ante la duda, se trabaja solo.
@@ -372,10 +504,10 @@ function revisar(brief: string, resultado: string): string | null {
  * lo ancla en la cadena, así que el cliente puede demostrar que el archivo que
  * se baja es exactamente el que le entregaste.
  */
-function conArchivoSiLoPidio(brief: string, texto: string, ctx: TaskContext): TaskResult {
+async function conArchivoSiLoPidio(brief: string, texto: string, ctx: TaskContext): Promise<TaskResult> {
   const formato = formatoPedido(brief);
   if (!formato) return texto;
-  const archivo = comoArchivo(formato, 'entrega', `Panal - entrega ${etiqueta(ctx)}`, texto);
+  const archivo = comoArchivo(formato, await nombreDelTema(brief, 'entrega'), `Panal - entrega ${etiqueta(ctx)}`, texto);
   const bytes = typeof archivo.data === 'string' ? archivo.data.length : archivo.data.byteLength;
   console.log(`[agente] ${etiqueta(ctx)} ${archivo.name} de ${bytes} bytes adjunto`);
   // El TEXTO se sigue entregando: es lo que se ancla en la cadena. El archivo

package/template/src/register.ts

@@ -38,6 +38,27 @@ const PERFIL = {
   // vacía NO la sustituye `??`. Con `??` el botUrl acababa siendo '' y la
   // comprobación de "no has puesto tu URL" no saltaba nunca.
   botUrl: process.env.PUBLIC_URL?.trim() || 'https://cambia-esto.example.com',
+
+  // TU CARA, si quieres tenerla. Todo esto es opcional y va vacío por defecto:
+  // un agente sin logo no vale menos, es lo que hay hoy en todo el mercado.
+  //
+  // Lo que compra ponerlo es que el cliente pueda MIRARTE antes de pagarte. En
+  // el mercado sales entre desconocidos, y un repositorio que se puede abrir
+  // dice más de ti que cualquier descripción que escribas de ti mismo.
+  //
+  // Se guarda en tu ficha del registro, así que cambiarlo cuesta una
+  // transacción: `npm run register` otra vez y ya.
+  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: '',
+    // Tu perfil o el repositorio del agente: valen `usuario` y `usuario/repo`.
+    github: '',
+    // Solo el usuario; también se traga el enlace entero si lo pegas.
+    x: '',
+    telegram: '',
+  },
 };
 
 /** Lo que cobras por tarea. */

package/template/src/salida.ts

@@ -15,6 +15,7 @@
  * peso y confusión.
  */
 
+import { llmChat, resolverLlm, stripFilesManifest } from '@panal/sdk';
 import { textoAPdf } from './pdf.js';
 import { escribirZip } from './zip.js';
 
@@ -36,7 +37,20 @@ export interface ArchivoDeSalida {
  * Devuelve `null` cuando no pide nada, que es el caso normal.
  */
 export function formatoPedido(brief: string): Formato | null {
-  const t = brief.toLowerCase();
+  // El manifiesto de adjuntos NO es lo que pidio el cliente: es contabilidad
+  // del protocolo, y va pegada al FINAL del brief. Sin quitarla, sus lineas
+  // `name:` y `mime:` son las ultimas menciones de un formato que hay en el
+  // texto, y esta funcion se queda justamente con la ultima.
+  //
+  // El efecto es que el adjunto elige el formato de SALIDA. Comprobado en un
+  // encargo real de mainnet (#67): el cliente pidio JSON, adjunto un `.txt`, y
+  // el manifiesto —`name: pedidos n.txt`, `mime: text/plain`— gano al «devuelve
+  // solo el JSON» que estaba escrito antes. Se entrego un .txt.
+  //
+  // No es raro ni un caso de laboratorio: casi todo adjunto lleva en el nombre
+  // una extension que aqui es un formato. Adjuntar un PDF hacia que la entrega
+  // fuera un PDF, se pidiera lo que se pidiera.
+  const t = stripFilesManifest(brief).toLowerCase();
   const mencion: { formato: Formato; en: number }[] = [];
 
   for (const [formato, patron] of PATRONES) {
@@ -334,6 +348,159 @@ export function comoTabla(texto: string): string | null {
   ].join('\n');
 }
 
+/* ── cómo se llama el archivo ────────────────────────────────────────────── */
+
+/**
+ * Los reservados de Windows y los separadores de ruta.
+ *
+ * NO se tocan las letras: un nombre en chino, en árabe o con tildes es un
+ * nombre perfectamente válido, y quitárselos sería justo lo contrario de lo
+ * que hace falta aquí.
+ */
+const PROHIBIDOS = /[/\\:*?"<>|]/g;
+
+/** Cuántos caracteres como mucho. Un nombre no es un resumen. */
+const MAX_NOMBRE = 60;
+
+/** ¿Es un carácter imprimible? Los de control no valen en un nombre. */
+function imprimible(c: string): boolean {
+  const p = c.codePointAt(0) ?? 0;
+  return p >= 0x20 && p !== 0x7f;
+}
+
+/**
+ * Un título cualquiera, convertido en nombre de archivo.
+ *
+ * Se exporta para poder probarlo sin gastar una llamada al modelo.
+ */
+export function comoNombre(crudo: string): string {
+  const linea = crudo.split(/\r?\n/).find((l) => l.trim()) ?? '';
+  const limpio = [...linea]
+    .filter(imprimible)
+    .join('')
+    .trim()
+    // El modelo devuelve el título entrecomillado más veces de las que parece.
+    .replace(/^["'`«“]+|["'`»”]+$/g, '')
+    // Y a veces le pone extensión, que aquí la pone `comoArchivo`.
+    .replace(/\.(pdf|docx?|xlsx?|md|txt|csv|json|zip)$/i, '')
+    .replace(PROHIBIDOS, ' ')
+    .replace(/\s+/g, '-')
+    .replace(/-{2,}/g, '-')
+    .replace(/^[-.]+|[-.]+$/g, '')
+    .toLowerCase();
+  // Por code points y no con `.slice`: cortar por unidades UTF-16 parte por la
+  // mitad un carácter fuera del plano básico.
+  return [...limpio].slice(0, MAX_NOMBRE).join('').replace(/[-.]+$/, '');
+}
+
+/**
+ * La cabecera `content-disposition` de un archivo que se descarga.
+ *
+ * DOS FORMAS DEL NOMBRE, Y LAS DOS HACEN FALTA (RFC 6266). Una cabecera HTTP
+ * solo admite latin-1, y desde que el nombre del archivo lo escribe el modelo
+ * en el idioma del cliente, un entregable puede llamarse
+ * `两个整数相除.pdf`. Interpolarlo tal cual en `filename="…"` no da un nombre
+ * feo: Node LANZA `ERR_INVALID_CHAR` al escribir la cabecera y la descarga
+ * responde 500. El archivo estaba entregado, pagado y anclado en la cadena, y
+ * el cliente no podía bajárselo.
+ *
+ *   filename=   una versión en ASCII, para quien no entienda lo otro
+ *   filename*=  el nombre de verdad, en UTF-8 percent-encoded
+ *
+ * Los navegadores prefieren `filename*` cuando está, así que el nombre bueno
+ * es el que se ve. Y las comillas se van del ASCII a propósito: una comilla
+ * dentro de `filename="…"` parte la cabecera por la mitad.
+ */
+export function comoAdjunto(nombre: string): string {
+  const ascii =
+    [...nombre]
+      .map((c) => {
+        const p = c.codePointAt(0) ?? 0;
+        return p >= 0x20 && p < 0x7f && c !== '"' && c !== '\\' ? c : '_';
+      })
+      .join('')
+      .replace(/_{2,}/g, '_')
+      .replace(/^[_.]+|[_.]+$/g, '') || 'archivo';
+  return `attachment; filename="${ascii}"; filename*=UTF-8''${encodeURIComponent(nombre)}`;
+}
+
+/**
+ * Lo que se le pide al modelo. Corto a propósito: es un nombre, no un resumen.
+ *
+ * Las dos reglas que de verdad cambian el resultado son las dos últimas. Sin
+ * la del SUJETO, el modelo nombra la acción —«escribir-casos-de-prueba»— y
+ * todos los archivos de un mismo agente vuelven a llamarse igual, que es el
+ * problema que esto viene a arreglar. Y sin la del IDIOMA contesta en inglés
+ * aunque el encargo venga en otro, porque el inglés es su idioma por defecto.
+ */
+const PIDE_UN_NOMBRE =
+  'You name files. Given a client request, reply with ONLY a file name for the deliverable.\n' +
+  'Two to five words. No extension, no quotes, no path, no explanation, no punctuation at the ends.\n' +
+  'Name the SUBJECT the work is about, never the action asked for: for "write the test cases for a ' +
+  'function that divides two integers" answer "division de dos enteros", not "escribir casos de prueba".\n' +
+  'Write it in the SAME language the client wrote in, in their own script. Do not translate it to English.';
+
+/**
+ * El nombre del archivo que se entrega, sacado del TEMA del encargo.
+ *
+ * ANTES TODOS SE LLAMABAN IGUAL. Cada agente tenía un nombre fijo —
+ * `casos-de-prueba.pdf`, `revision.pdf`, `traducciones.pdf`—, así que un
+ * cliente que encargara tres cosas al mismo agente acababa con tres archivos
+ * del mismo nombre en su carpeta de descargas, pisándose unos a otros o
+ * quedando como «casos-de-prueba (2).pdf». Y estaba en castellano para todo el
+ * mundo, cuando el contenido va en el idioma del cliente desde hace tiempo.
+ *
+ * EL TEMA SALE DEL ENCARGO, no de la entrega. La entrega es texto plano sin
+ * título —el prompt prohíbe los encabezados a propósito—, así que su primera
+ * línea es el primer caso de prueba, no de qué va la cosa. El encargo, en
+ * cambio, lo escribió el cliente: dice el tema y está en su idioma.
+ *
+ * NUNCA LANZA Y NUNCA DEVUELVE VACÍO. Si el modelo no contesta, tarda o
+ * devuelve algo que no sirve, se usa el nombre de siempre. Nombrar un archivo
+ * no puede impedir entregarlo: el pago ya está bloqueado.
+ */
+export async function nombreDelTema(brief: string, deReserva: string): Promise<string> {
+  try {
+    const cfg = resolverLlm(process.env);
+    const respuesta = await llmChat(
+      // NO SE TOCA NI LA TEMPERATURA NI EL TOPE DE TOKENS, y las dos cosas se
+      // aprendieron probando contra el modelo de verdad.
+      //
+      // Aquí ponía `temperature: 0` —lo natural para pedir algo determinista— y
+      // el modelo lo rechazaba con un 400: hay modelos que solo aceptan 1. Y
+      // ponía `maxTokens: 32` —es un nombre, no un texto— y la respuesta volvía
+      // con `choices` vacío, porque un modelo que razona antes de contestar se
+      // gasta ese presupuesto pensando y no le queda para escribir.
+      //
+      // Los dos fallos son INVISIBLES: se cae al nombre de siempre, que es
+      // exactamente lo que había antes, así que la función habría quedado
+      // muerta sin que nadie lo notara. Se hereda lo que el operador ya tiene
+      // configurado, que es lo que funciona en el resto de sus llamadas.
+      //
+      // Lo único propio es el reloj: un timeout más corto que el del trabajo y
+      // un solo reintento, porque esto va DESPUÉS de tener la entrega hecha y
+      // no puede retrasarla.
+      { ...cfg, timeoutMs: 20_000, maxRetries: 1 },
+      // El encargo entero no hace falta: el tema está al principio, y mandarlo
+      // completo puede ser mandar un contrato de treinta páginas para sacar
+      // cuatro palabras.
+      // Sin el manifiesto, por lo mismo que en `formatoPedido`: son 1.500
+      // caracteres de presupuesto y un hash de 64 ocupa sitio sin decir nada
+      // del tema. Con adjuntos cortos llegaba a colarse entero.
+      { system: PIDE_UN_NOMBRE, user: stripFilesManifest(brief).trim().slice(0, 1_500) },
+    );
+    const nombre = comoNombre(respuesta);
+    if (nombre) return nombre;
+    console.warn(`[salida] el modelo no dio un nombre usable; el archivo va como «${deReserva}»`);
+  } catch (err) {
+    console.warn(
+      `[salida] no se pudo nombrar el archivo (${err instanceof Error ? err.message.split('\n')[0] : err}); ` +
+        `va como «${deReserva}»`,
+    );
+  }
+  return deReserva;
+}
+
 /**
  * El archivo listo para adjuntar a la entrega.
  *

package/template/src/server.ts

@@ -30,10 +30,12 @@ import {
   assertCanServe,
   buildQuote,
   createPanalClient,
+  leerNiveles,
   LoopDetected,
   MAINNET_ADDRESSES,
   monad,
   matchAttachment,
+  nivelPara,
   parseAttachmentsManifest,
   parseEnvelope,
   parsePaymentHeader,
@@ -45,20 +47,21 @@ import {
   type AttachedFile,
   type CallEnvelope,
   type DeliveredFile,
+  type FichaNivel,
+  type Nivel,
   type PermitDomain,
 } from '@panal/sdk';
+import { comoAdjunto } from './salida.js';
 import { privateKeyToAccount } from 'viem/accounts';
 import { isAddress, keccak256, parseEther, toBytes, verifyMessage } from 'viem';
 import type { Address } from 'viem';
-import { handleTask } from './agent.js';
-import type { AdjuntoRecibido, TaskContext, TaskFile, TaskResult } from './agent.js';
+import { handleTask, NIVELES, SUBCONTRATA_SKILLS } from './agent.js';
+import type { AdjuntoRecibido, NivelPropio, TaskContext, TaskFile, TaskResult } from './agent.js';
 import { arrancarVigilante } from './vigilante.js';
 import { historialParaElModelo, recordarTurno, type Turno } from './memoria.js';
 
 const PORT = Number(process.env.PORT ?? 8787);
 const DATA_DIR = process.env.DATA_DIR ?? './data';
-/** Tope del cuerpo de una petición: sin esto, cualquiera te tumba el proceso. */
-const MAX_BODY = 256 * 1024;
 
 /**
  * Tope del encargo, en CARACTERES, y anunciado en `/agent.json`.
@@ -75,6 +78,80 @@ const MAX_BODY = 256 * 1024;
  */
 const MAX_BRIEF_CHARS = 32_000;
 
+// ---------------------------------------------------------------------------
+// Niveles: el mismo trabajo en varios tamaños.
+//
+// Los declara el agente en `agent.ts` y son OPCIONALES. Sin ninguno, todo lo
+// de aquí abajo se queda en los valores de siempre y este bloque no hace nada.
+//
+// Se pasan por `leerNiveles`, que es EL MISMO lector que usarán la web y la
+// app al leer la ficha. Así un agente no puede publicar un nivel que sus
+// propios clientes van a descartar: si aquí no sobrevive, no se anuncia.
+// ---------------------------------------------------------------------------
+
+const NIVELES_OK = leerNiveles({
+  tiers: NIVELES.map((n) => ({ ...n, amountWei: n.wei.toString() })),
+});
+
+if (NIVELES.length > 0 && NIVELES_OK.length !== NIVELES.length) {
+  console.error(
+    `[panal] ${NIVELES.length - NIVELES_OK.length} nivel(es) de agent.ts están mal escritos y no se van a anunciar. ` +
+      'Cada uno necesita un `wei` positivo.',
+  );
+}
+
+/** El nivel más barato: por debajo de eso, un agente con niveles no trabaja. */
+const NIVEL_MINIMO = NIVELES_OK[0] ?? null;
+
+// 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.
+for (const n of NIVELES) {
+  if (n.subcontrata !== undefined && n.subcontrata >= n.wei) {
+    console.error(
+      `[panal] el nivel "${n.name}" cobra ${n.wei} y puede gastar ${n.subcontrata} subcontratando: ` +
+        'no te queda nada por el trabajo.',
+    );
+  }
+}
+
+
+/** El tope de encargo del nivel mayor, o el de siempre si no hay niveles. */
+const TOPE_BRIEF_MAYOR = Math.max(MAX_BRIEF_CHARS, ...NIVELES_OK.map((n) => n.maxBriefChars ?? 0));
+
+/**
+ * Tope del cuerpo de una petición: sin esto, cualquiera te tumba el proceso.
+ *
+ * Sale del nivel MAYOR y no de un número redondo, porque prometer 320 000
+ * caracteres y cortar el cuerpo a 256 KB es prometer algo que no se cumple.
+ * El ×4 es el peor caso de UTF-8 —un carácter puede ocupar cuatro bytes— y
+ * los 32 KB de propina cubren el resto del JSON: la firma, la dirección y el
+ * manifiesto de adjuntos que viaja dentro del encargo.
+ */
+const MAX_BODY = Math.max(256 * 1024, TOPE_BRIEF_MAYOR * 4 + 32 * 1024);
+
+/** Un nivel ya validado, en la forma con la que se anuncia y se devuelve. */
+function comoFicha(n: Nivel): FichaNivel {
+  return {
+    ...(n.name === null ? {} : { name: n.name }),
+    ...(n.description === null ? {} : { description: n.description }),
+    amountWei: n.wei.toString(),
+    ...(n.maxBriefChars === null ? {} : { maxBriefChars: n.maxBriefChars }),
+    ...(n.maxAttachChars === null ? {} : { maxAttachChars: n.maxAttachChars }),
+    ...(n.maxAttachCharsTotal === null ? {} : { maxAttachCharsTotal: n.maxAttachCharsTotal }),
+  };
+}
+
+/** Qué nivel compró quien bloqueó esto. `null` si el agente no vende niveles. */
+function nivelDe(pagado: bigint): NivelPropio | null {
+  if (NIVELES_OK.length === 0) return null;
+  const leido = nivelPara(NIVELES_OK, pagado);
+  if (!leido) return null;
+  // Se devuelve el declarado en `agent.ts`, no el normalizado: es el que tiene
+  // los tipos que el autor del agente espera encontrar en `ctx.nivel`.
+  return NIVELES.find((n) => n.wei === leido.wei) ?? null;
+}
+
 const key = process.env.AGENT_PRIVATE_KEY?.trim();
 if (!key || !/^0x[0-9a-fA-F]{64}$/.test(key)) {
   console.error('Falta AGENT_PRIVATE_KEY (0x + 64 hex) en el .env. Copia .env.example y rellénalo.');
@@ -158,7 +235,21 @@ const SUBCONTRATA_SALTOS = (() => {
 })();
 
 if (SUBCONTRATA_MAX > 0n) {
-  console.log(`Subcontratación activa: hasta ${process.env.SUBCONTRATA_MAX} ${X402_SYMBOL} por encargo`);
+  // Se dice el estado REAL, no sólo el del dinero. Antes bastaba con tener
+  // presupuesto; ahora hacen falta las dos cosas, y un log que dijera "activa"
+  // con la lista vacía haría perder la tarde a quien se pregunte por qué su
+  // agente nunca delega.
+  if (SUBCONTRATA_SKILLS.length > 0) {
+    console.log(
+      `Subcontratación activa: hasta ${process.env.SUBCONTRATA_MAX} ${X402_SYMBOL} por encargo, ` +
+        `y sólo en: ${SUBCONTRATA_SKILLS.join(', ')}`,
+    );
+  } else {
+    console.log(
+      `Subcontratación con presupuesto (${process.env.SUBCONTRATA_MAX} ${X402_SYMBOL}) pero SIN skills ` +
+        'permitidas: no va a delegar. Rellena SUBCONTRATA_SKILLS en agent.ts.',
+    );
+  }
 
   // Lo que te pagan por una consulta es el techo de lo que puedes gastarte en
   // ella. Con SUBCONTRATA_MAX igual o mayor que X402_PRICE, un encargo en el
@@ -508,18 +599,40 @@ function contexto(
   },
   sobre: CallEnvelope | null,
 ): TaskContext {
+  // Se resuelve aquí y no en cada llamador para que no haya dos maneras de
+  // decidirlo. En x402 es SIEMPRE null: no hay escrow, y el importe de una
+  // llamada suelta no compra un nivel de encargo.
+  const nivel = base.taskId === null ? null : nivelDe(base.amount);
+
+  // El presupuesto del nivel comprado, y si el nivel no dice nada, el del
+  // .env. Así el nivel caro puede comprar ayuda y el barato no, sin que un
+  // agente sin niveles note ningún cambio.
+  const presupuesto = nivel?.subcontrata ?? SUBCONTRATA_MAX;
+
   return {
     ...base,
+    nivel,
     envelope: sobre,
-    presupuesto: SUBCONTRATA_MAX,
+    presupuesto,
     consultar: async (skill: string, pregunta: string) => {
-      if (SUBCONTRATA_MAX <= 0n) {
+      if (presupuesto <= 0n) {
         throw new Error(
-          'Este agente no tiene presupuesto para subcontratar: pon SUBCONTRATA_MAX en el .env si quieres que delegue.',
+          nivel
+            ? `El nivel "${nivel.name}" no tiene presupuesto para subcontratar: ponle \`subcontrata\` en agent.ts.`
+            : 'Este agente no tiene presupuesto para subcontratar: pon SUBCONTRATA_MAX en el .env si quieres que delegue.',
+        );
+      }
+      // Dinero Y permiso. Sin lista no se compra nada, aunque haya dinero: el
+      // buscador generaliza cuando no encuentra a nadie, y sin lista esa
+      // generalización no tiene dónde parar.
+      if (SUBCONTRATA_SKILLS.length === 0) {
+        throw new Error(
+          'Este agente no tiene ninguna skill permitida: rellena SUBCONTRATA_SKILLS en agent.ts si quieres que delegue.',
         );
       }
       const res = await panal.ask(skill, pregunta, {
-        maxSpend: SUBCONTRATA_MAX,
+        maxSpend: presupuesto,
+        skillsPermitidas: SUBCONTRATA_SKILLS,
         depth: SUBCONTRATA_SALTOS,
         // El sobre recibido, si lo hay. Sin él se abre una cadena nueva.
         envelope: sobre,
@@ -709,10 +822,10 @@ function json(res: ServerResponse, status: number, body: unknown): void {
 /**
  * El cuerpo en crudo, con su propio tope.
  *
- * Va aparte de `readBody` a propósito: los 256 KB de MAX_BODY protegen las
- * rutas de texto y tienen que seguir siendo pequeños. Una foto no cabe ahí, y
- * subirle el tope a todas las rutas para que quepa sería abrir la puerta que
- * ese límite cierra.
+ * Va aparte de `readBody` a propósito: MAX_BODY protege las rutas de texto y
+ * está calculado para caberles justo —lo que hoy pida el nivel mayor y ni un
+ * byte más—. Una foto no entra ahí, y subirle el tope a todas las rutas para
+ * que quepa sería abrir la puerta que ese límite cierra.
  */
 async function readBodyBytes(req: IncomingMessage, max: number): Promise<Buffer> {
   const chunks: Buffer[] = [];
@@ -955,6 +1068,13 @@ const server = createServer((req, res) => {
             path: '/brief/:taskId',
             signMessage: 'Panal brief #<taskId>  (EIP-191, firmado por el cliente de la tarea)',
             body: `{"brief": string (máx. ${MAX_BRIEF_CHARS} chars), "address": "0x…", "signature": "0x…"}`,
+            // OJO: aquí va el tope BÁSICO, nunca el del nivel mayor.
+            //
+            // Un cliente antiguo no sabe elegir nivel, así que va a bloquear el
+            // precio del registro y comprar el básico. Anunciarle el tope del
+            // nivel grande le haría mandar un libro pagando lo pequeño, y
+            // enterarse con el dinero ya bloqueado. Quien sepa leer `tiers`
+            // verá los demás.
             maxBriefChars: MAX_BRIEF_CHARS,
           },
           postAttachment: {
@@ -973,6 +1093,9 @@ const server = createServer((req, res) => {
           },
           ...(x402 ? { x402Ask: x402 } : {}),
         },
+        // Los niveles, sólo si este agente vende alguno. Ausente significa que
+        // no los ofrece, y quien lee NO debe inventárselos a partir del precio.
+        ...(NIVELES_OK.length > 0 ? { tiers: NIVELES_OK.map(comoFicha) } : {}),
         // ALIAS ANTIGUO, en la raíz. Aquí es donde esta plantilla lo publicaba
         // antes, y hay clientes ahí fuera que solo miran este sitio. Se sirve
         // por compatibilidad y desaparecerá; lo que se lee es `endpoints`.
@@ -1140,13 +1263,15 @@ const server = createServer((req, res) => {
         json(res, 400, { error: 'faltan taskId, brief o signature' });
         return;
       }
-      // El tope que anuncia /agent.json, aplicado. Se dice el número en la
-      // respuesta: el cliente ya pagó, y saber cuánto recortar es la
-      // diferencia entre reenviarlo y perder el encargo.
-      if (body.brief.length > MAX_BRIEF_CHARS) {
+      // Primera guarda, y a propósito contra el tope MAYOR: aquí todavía no
+      // se sabe qué nivel se pagó —eso está en la cadena y cuesta un eth_call—
+      // y un texto que no cabe en el nivel más caro no cabe en ninguno. Lo que
+      // sí se puede decidir sin preguntarle a nadie, se decide sin preguntar.
+      if (body.brief.length > TOPE_BRIEF_MAYOR) {
         json(res, 400, {
-          error: `el encargo son ${body.brief.length} caracteres y el tope es ${MAX_BRIEF_CHARS}`,
-          maxBriefChars: MAX_BRIEF_CHARS,
+          error: `el encargo son ${body.brief.length} caracteres y el tope es ${TOPE_BRIEF_MAYOR}`,
+          maxBriefChars: TOPE_BRIEF_MAYOR,
+          ...(NIVELES_OK.length > 0 ? { tiers: NIVELES_OK.map(comoFicha) } : {}),
         });
         return;
       }
@@ -1193,6 +1318,34 @@ const server = createServer((req, res) => {
         json(res, 401, { error: 'la firma no es del cliente de esta tarea' });
         return;
       }
+
+      // El tope DEL NIVEL QUE PAGÓ. Se mira ahora y no arriba porque hasta
+      // aquí no se sabía el importe, y el importe es lo único que dice qué
+      // nivel compró: el brief lo escribe el cliente y podría proclamarse del
+      // más caro.
+      //
+      // Se dice el número y se dicen los niveles: el cliente ya tiene el pago
+      // bloqueado, y saber si le sobra texto o le falta nivel es la diferencia
+      // entre arreglarlo y esperar al plazo para recuperar el dinero.
+      const nivel = nivelDe(task.amount);
+      if (NIVEL_MINIMO && task.amount < NIVEL_MINIMO.wei) {
+        json(res, 400, {
+          error: `esta tarea bloqueó ${task.amount} y el nivel más barato cuesta ${NIVEL_MINIMO.wei}`,
+          tiers: NIVELES_OK.map(comoFicha),
+        });
+        return;
+      }
+      const topeDelNivel = nivel?.maxBriefChars ?? MAX_BRIEF_CHARS;
+      if (body.brief.length > topeDelNivel) {
+        json(res, 400, {
+          error:
+            `el encargo son ${body.brief.length} caracteres y el nivel que pagaste ` +
+            `(${nivel?.name ?? 'el básico'}) llega a ${topeDelNivel}`,
+          maxBriefChars: topeDelNivel,
+          ...(NIVELES_OK.length > 0 ? { tiers: NIVELES_OK.map(comoFicha) } : {}),
+        });
+        return;
+      }
       // Y que el texto sea EL que se encargó. Para esto existe el taskHash: sin
       // esta comprobación, un cliente podría pagar por una cosa on-chain y
       // pedirte otra por HTTP, y en una disputa el árbitro no tendría con qué
@@ -1419,7 +1572,7 @@ const server = createServer((req, res) => {
         'content-length': bytes.byteLength,
         // `attachment` a propósito: lo que hay dentro lo eligió el agente, y no
         // se le deja que el navegador del cliente lo ejecute como una página.
-        'content-disposition': `attachment; filename="${nombre}"`,
+        'content-disposition': comoAdjunto(nombre),
         'x-content-type-options': 'nosniff',
       });
       res.end(bytes);