create-panal-agent 0.11.0 → 0.12.0

package/dist/i18n.js

@@ -76,6 +76,7 @@ The language is taken from --lang, then PANAL_LANG, then your system locale.`,
         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.",
         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).",
     },
     readme: `# {name}
@@ -171,6 +172,7 @@ El idioma sale de --lang, luego de PANAL_LANG, y si no del locale del sistema.`,
         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.",
         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).",
     },
     readme: `# {name}
@@ -267,6 +269,7 @@ const zh = {
         x402: '按次收费（可选）。留空则你的代理只接受托管订单。\n价格按每次请求计算，使用支持 EIP-2612 的代币——不能是 MON，该方案依赖 `permit`。',
         subcontrata: "转包（可选，默认关闭）。你的代理可以为自己做不了的事付钱给另一个代理（见 agent.ts 的 ctx.consultar）。这里没有数字就永远不会转包。\n它使用 x402 的币种，不是按任务收入的比例：任务用 MON 结算，提问用 $PANAL，凭感觉换算等于凭空编造预算。 把它设得低于你每次提问的收费（X402_PRICE）：等于或高于该值时，每一笔你转包出去的活都赚不到钱，还要自付 gas——而这恰恰惩罚了你希望它做的事，因为它越善于识别自己不懂的部分，就越经常白干。取你价格的三分之一是个合理的起点。",
         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 拒绝没有有效期的下载签名（旧格式）。",
     },
     readme: `# {name}
@@ -358,6 +361,7 @@ const hi = {
         x402: 'प्रति कॉल शुल्क (वैकल्पिक)। खाली छोड़ें तो आपका एजेंट केवल एस्क्रो वाले काम लेगा।\nकीमत प्रति अनुरोध है, EIP-2612 टोकन में — MON नहीं चल सकता, इस योजना को `permit` चाहिए।',
         subcontrata: "सबकॉन्ट्रैक्टिंग (वैकल्पिक, डिफ़ॉल्ट रूप से बंद)। आपका एजेंट जो खुद नहीं कर सकता, उसके लिए दूसरे को भुगतान कर सकता है (agent.ts में ctx.consultar देखें)। यहाँ संख्या के बिना वह कभी नहीं सौंपता।\nयह x402 की मुद्रा में है, प्रति कार्य आय का हिस्सा नहीं: कार्य MON में और प्रश्न $PANAL में चुकाया जाता है। इसे अपने प्रति-प्रश्न शुल्क (X402_PRICE) से कम रखें: बराबर या अधिक होने पर, जिस भी काम में आप दूसरे को सौंपेंगे उसमें कुछ नहीं बचेगा और गैस भी आपकी जेब से जाएगी — और यह ठीक उसी व्यवहार को दंडित करता है जो आप चाहते हैं, क्योंकि आपका एजेंट जितना बेहतर पहचानेगा कि उसे क्या नहीं आता, उतनी ही बार वह मुफ़्त काम करेगा। अपने दाम का एक तिहाई एक समझदार शुरुआत है।",
         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 बिना समय-सीमा वाले डाउनलोड हस्ताक्षर अस्वीकार करता है।",
     },
     readme: `# {name}
@@ -453,6 +457,7 @@ const ar = {
         x402: 'التحصيل لكل استدعاء (اختياري). اتركه فارغًا فيقبل وكيلك مهام الضمان فقط.\nالسعر لكل طلب، بعملة تدعم EIP-2612 — لا يصلح MON، فالمخطط يحتاج `permit`.',
         subcontrata: "التعاقد من الباطن (اختياري، معطل افتراضيا). يمكن لوكيلك ان يدفع لوكيل اخر مقابل ما لا يجيده (انظر ctx.consultar في agent.ts). بدون رقم هنا لن يفوض ابدا.\nيكون بعملة x402، وليس نسبة مما تتقاضاه عن المهمة: المهمة تدفع بـ MON والسؤال بـ $PANAL. اجعله أقل من سعر السؤال لديك (X402_PRICE): فعند التساوي أو الزيادة، كل مهمة تُسنِد فيها جزءًا إلى غيرك لا تُبقي لك شيئًا وتدفع الغاز من جيبك — وهذا يعاقب تحديدًا ما تريده منه، لأنه كلما أحسن إدراك ما يجهله عمل مجانًا أكثر. ثلث سعرك بداية معقولة.",
         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 يرفض تواقيع التنزيل بلا انتهاء صلاحية.",
     },
     readme: `# {name}
@@ -547,6 +552,7 @@ La langue vient de --lang, puis de PANAL_LANG, puis de la locale du système.`,
         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.",
         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.",
     },
     readme: `# {name}
@@ -645,6 +651,7 @@ O idioma vem de --lang, depois de PANAL_LANG e, por fim, do locale do sistema.`,
         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.",
         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.",
     },
     readme: `# {name}
@@ -741,6 +748,7 @@ const ru = {
         x402: 'Плата за вызов (необязательно). Оставьте пустым — агент будет брать только заказы через эскроу.\nЦена за один запрос, в токене с EIP-2612: MON не подходит, схеме нужен `permit`.',
         subcontrata: "Субподряд (необязательно, по умолчанию выключен). Ваш агент может заплатить другому за то, чего не умеет сам (см. ctx.consultar в agent.ts). Без числа здесь он никогда не делегирует.\nУказывается в валюте x402, а НЕ долей от оплаты за задачу: задача оплачивается в MON, а вопрос в $PANAL. Поставьте НИЖЕ того, что берёте за вопрос (X402_PRICE): при равенстве или выше каждая работа, где вы делегируете, не приносит ничего, а газ вы платите сами — и это наказывает ровно то поведение, которого вы добиваетесь: чем лучше агент понимает, чего не знает, тем чаще работает даром. Треть вашей цены — разумное начало.",
         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 отклоняет подписи скачивания без срока действия.",
     },
     readme: `# {name}
@@ -838,6 +846,7 @@ const bn = {
         x402: 'প্রতি কলে চার্জ (ঐচ্ছিক)। ফাঁকা রাখলে আপনার এজেন্ট কেবল এসক্রো কাজ নেবে।\nদাম প্রতি অনুরোধে, EIP-2612 টোকেনে — MON চলবে না, স্কিমটির `permit` দরকার।',
         subcontrata: "সাবকন্ট্রাক্টিং (ঐচ্ছিক, ডিফল্টে বন্ধ)। আপনার এজেন্ট যা নিজে পারে না, তার জন্য অন্যকে অর্থ দিতে পারে (agent.ts-এ ctx.consultar দেখুন)। এখানে সংখ্যা না থাকলে সে কখনও দায়িত্ব দেয় না।\nএটি x402-এর মুদ্রায়, কাজপ্রতি আয়ের অংশ নয়: কাজের দাম MON-এ আর প্রশ্নের দাম $PANAL-এ। এটি আপনার প্রতি-প্রশ্ন মূল্যের (X402_PRICE) চেয়ে কম রাখুন: সমান বা বেশি হলে, যে কাজেই আপনি অন্যকে দেবেন তাতে কিছুই থাকবে না, গ্যাসও আপনার — আর এতে ঠিক সেই আচরণই শাস্তি পায় যা আপনি চান, কারণ এজেন্ট যত ভালোভাবে বুঝবে সে কী জানে না, তত বেশিবার সে বিনামূল্যে কাজ করবে। আপনার দামের এক-তৃতীয়াংশ একটি যুক্তিসঙ্গত শুরু।",
         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 মেয়াদহীন ডাউনলোড স্বাক্ষর প্রত্যাখ্যান করে।",
     },
     readme: `# {name}
@@ -932,6 +941,7 @@ const ur = {
         x402: 'فی کال وصولی (اختیاری)۔ خالی چھوڑ دیں تو آپ کا ایجنٹ صرف ایسکرو کے کام لے گا۔\nقیمت فی درخواست ہے، EIP-2612 ٹوکن میں — MON نہیں چل سکتا، اس اسکیم کو `permit` چاہیے۔',
         subcontrata: "سب کنٹریکٹنگ (اختیاری، بذریعہ ڈیفالٹ بند)۔ آپ کا ایجنٹ جو خود نہیں کر سکتا اس کے لیے دوسرے کو ادائیگی کر سکتا ہے (agent.ts میں ctx.consultar دیکھیں)۔ یہاں نمبر کے بغیر وہ کبھی نہیں سونپتا۔\nیہ x402 کی کرنسی میں ہے، فی ٹاسک آمدنی کا حصہ نہیں: ٹاسک MON میں اور سوال $PANAL میں ادا ہوتا ہے۔ اسے اپنی فی سوال قیمت (X402_PRICE) سے کم رکھیں: برابر یا زیادہ ہونے پر، جس کام میں بھی آپ کسی اور کو دیں گے اس میں کچھ نہیں بچے گا اور گیس بھی آپ کی جیب سے جائے گی — اور یہ بالکل اسی رویّے کو سزا دیتا ہے جو آپ چاہتے ہیں، کیونکہ آپ کا ایجنٹ جتنا بہتر پہچانے گا کہ اسے کیا نہیں آتا، اتنی ہی زیادہ بار وہ مفت کام کرے گا۔ اپنی قیمت کا ایک تہائی معقول آغاز ہے۔",
         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 بغیر میعاد والے ڈاؤن لوڈ دستخط مسترد کرتا ہے۔",
     },
     readme: `# {name}

package/dist/index.js

@@ -176,6 +176,10 @@ function writeEnvExample(dest, t) {
         'VIGILANTE_SEGUNDOS=60',
         'PUBLIC_URL=',
         '',
+        bloque(t.env.memoria),
+        'MEMORIA_TURNOS=6',
+        'MEMORIA_CHARS=4000',
+        '',
         bloque(t.env.seguridad),
         'LIMITE_POR_MINUTO=60',
         '# TRAS_PROXY=1',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-panal-agent",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Crea un agente de IA para Panal, funcionando y cobrando on-chain, en cinco minutos",
   "type": "module",
   "license": "MIT",
@@ -40,6 +40,6 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "tsx test/i18n.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/scaffold.test.ts"
   }
 }

package/template/_package.json

@@ -10,7 +10,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@panal/sdk": "^0.12.0",
+    "@panal/sdk": "^0.13.0",
     "dotenv": "^17.0.0",
     "tsx": "^4.19.0",
     "viem": "^2.21.0"

package/template/src/agent.ts

@@ -13,6 +13,7 @@
 
 import { esImagenSoportada, llmChat, resolverLlm, type CallEnvelope, type LlmConfig } from '@panal/sdk';
 import { textoAPdf } from './pdf.js';
+import { historialComoTexto, type Turno } from './memoria.js';
 
 /** Un archivo que el CLIENTE te mandó con el encargo. */
 export interface AdjuntoRecibido {
@@ -85,6 +86,23 @@ export interface TaskContext {
    * `consultar` ya lo respeta por su cuenta.
    */
   envelope: CallEnvelope | null;
+
+  /**
+   * LO QUE YA SE HABLÓ CON ESTA PERSONA.
+   *
+   * Sólo en llamadas x402, que son las que forman una conversación. En un
+   * encargo del escrow va vacío: un encargo tiene principio y fin, y
+   * arrastrarle memoria sería confundir dos cosas distintas.
+   *
+   * Quién es "esta persona" lo dice el PAGO, no una cabecera: firmó un permiso
+   * y el cobro se ejecutó en la cadena, así que nadie puede continuar la
+   * conversación de otro sin haber pagado como él.
+   *
+   * Va acotado por turnos y por caracteres (`MEMORIA_TURNOS`, `MEMORIA_CHARS`)
+   * porque entra en el prompt, y el prompt lo pagas TÚ mientras el cliente
+   * paga un precio fijo por mensaje.
+   */
+  historial: Turno[];
 }
 
 /** Un archivo que entregas junto al texto. */
@@ -177,7 +195,7 @@ export async function handleTask(brief: string, ctx: TaskContext): Promise<TaskR
   // que entregues queda anclado en la cadena y ya no se puede rectificar.
   let queja: string | null = null;
   for (let intento = 1; intento <= 2; intento++) {
-    const texto = await pedirAlModelo(brief, cfg, queja, ayuda, imagenes, ctx.adjuntos);
+    const texto = await pedirAlModelo(brief, cfg, queja, ayuda, imagenes, ctx.adjuntos, ctx.historial);
     const problema = revisar(brief, texto);
     if (!problema) {
       console.log(`[agente] ${etiqueta(ctx)} resuelta: ${texto.length} caracteres`);
@@ -368,12 +386,23 @@ async function pedirAlModelo(
   ayuda: string | null,
   imagenes: { mime: string; bytes: Uint8Array }[],
   adjuntos: AdjuntoRecibido[],
+  historial: Turno[],
 ): Promise<string> {
   // Todo va en un solo turno de usuario, con cada parte etiquetada. Los tres
   // dialectos aceptan varios turnos, pero cada uno los cuenta a su manera, y
   // lo que aquí importa no es de quién es cada mensaje: es que el modelo no
   // confunda el material de apoyo con el encargo.
-  const partes = [brief];
+  const partes: string[] = [];
+
+  // Lo hablado antes va PRIMERO y marcado como tal. Sin la etiqueta, el modelo
+  // confunde una pregunta vieja con la de ahora y contesta a la equivocada;
+  // con ella entiende que es contexto y que lo último es lo que se le pide.
+  const antes = historialComoTexto(historial);
+  if (antes) {
+    partes.push(`Conversación anterior con este cliente, para que sepas de qué habláis:\n\n${antes}`);
+  }
+
+  partes.push(historial.length > 0 ? `Ahora te pide:\n${brief}` : brief);
 
   // Los adjuntos que el modelo NO puede mirar. Se nombran para que sepa que
   // existen: sin esto contesta como si el cliente no hubiera mandado nada, y

package/template/src/memoria.ts

@@ -0,0 +1,136 @@
+/**
+ * La memoria de una conversación.
+ *
+ * Sin esto, cada llamada x402 es independiente: el cliente pregunta algo, tu
+ * agente contesta, y a la siguiente no sabe de qué se hablaba. Eso no es un
+ * chat, es un buscador que pasa factura — y quien lo usa lo nota al segundo
+ * mensaje, cuando tiene que repetir el contexto entero.
+ *
+ * QUIÉN HABLA LO DICE EL PAGO. La conversación se guarda por la dirección del
+ * pagador, y esa dirección no la afirma nadie: firmó un permiso y el cobro se
+ * ejecutó en la cadena. Nadie puede leer ni continuar la conversación de otro
+ * sin haber pagado como él, así que no hace falta ninguna autenticación
+ * aparte. Es la propiedad más útil de cobrar por llamada.
+ *
+ * SOLO EN x402, NO EN EL ESCROW. Un encargo del escrow es un trabajo con
+ * principio y fin: se paga, se entrega una vez y se aprueba. Arrastrarle
+ * memoria sería confundir dos cosas distintas.
+ *
+ * LO QUE CUESTA, porque conviene tenerlo delante: el historial va dentro del
+ * prompt, y el prompt lo pagas TÚ mientras el cliente paga un precio fijo por
+ * mensaje. Una conversación larga es cada vez más cara de contestar por lo
+ * mismo. De ahí los dos topes de abajo, y de ahí que se puedan bajar.
+ */
+
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** Un intercambio ya cerrado: lo que preguntaron y lo que contestaste. */
+export interface Turno {
+  pregunta: string;
+  respuesta: string;
+  /** Epoch en milisegundos. */
+  cuando: number;
+}
+
+/**
+ * Cuántos turnos se recuerdan. `MEMORIA_TURNOS=0` apaga la memoria.
+ *
+ * Seis es un número corto a propósito: cubre una conversación normal y deja
+ * el coste acotado. Súbelo si tu agente necesita hilos largos y te sale a
+ * cuenta; bájalo a cero si lo tuyo son preguntas sueltas.
+ */
+const TURNOS = (() => {
+  const n = Number(process.env.MEMORIA_TURNOS?.trim() || '6');
+  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : 6;
+})();
+
+/**
+ * Tope de caracteres del historial que entra en el prompt.
+ *
+ * El tope de turnos por sí solo no acota nada: seis turnos pueden ser seis
+ * líneas o seis pantallas de código pegado.
+ */
+const MAX_CHARS = (() => {
+  const n = Number(process.env.MEMORIA_CHARS?.trim() || '4000');
+  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 4000;
+})();
+
+/** Cuántos turnos se guardan en disco, que es más de lo que se manda. */
+const GUARDADOS = 60;
+
+/**
+ * El archivo de una conversación.
+ *
+ * El nombre sale de la dirección, y aunque venga ya validada como tal se
+ * limpia igual: es lo que decide una ruta en disco, y una comprobación de más
+ * en un sitio así no cuesta nada.
+ */
+function archivo(dataDir: string, quien: string): string {
+  const limpio = quien.toLowerCase().replace(/[^a-z0-9x]/g, '');
+  return join(dataDir, 'chats', `${limpio}.json`);
+}
+
+/** Todo lo que se recuerda de esa persona, de lo más viejo a lo más nuevo. */
+export function leerConversacion(dataDir: string, quien: string): Turno[] {
+  try {
+    const turnos = JSON.parse(readFileSync(archivo(dataDir, quien), 'utf8')) as Turno[];
+    return Array.isArray(turnos) ? turnos : [];
+  } catch {
+    // Sin archivo, o con un archivo ilegible: se empieza de cero. Una memoria
+    // rota no puede impedir contestar a alguien que acaba de pagar.
+    return [];
+  }
+}
+
+/**
+ * Guarda un intercambio.
+ *
+ * Se llama DESPUÉS de contestar, con las dos mitades: un turno con pregunta y
+ * sin respuesta ensucia la memoria de la siguiente vez, y es justo lo que
+ * pasaría si se guardara antes de trabajar y el modelo fallara.
+ */
+export function recordarTurno(dataDir: string, quien: string, turno: Turno): void {
+  if (TURNOS === 0) return;
+  try {
+    const previos = leerConversacion(dataDir, quien);
+    mkdirSync(join(dataDir, 'chats'), { recursive: true });
+    writeFileSync(archivo(dataDir, quien), JSON.stringify([...previos, turno].slice(-GUARDADOS)), 'utf8');
+  } catch (err) {
+    // Perder la memoria no puede tumbar una respuesta ya cobrada.
+    console.error(`[memoria] no se pudo guardar el turno: ${err instanceof Error ? err.message : err}`);
+  }
+}
+
+/**
+ * El historial que se le pasa al modelo, ya acotado.
+ *
+ * Se recorta desde el final: lo reciente es lo que da contexto, y lo viejo es
+ * lo primero que sobra. Devuelve vacío con la memoria apagada.
+ */
+export function historialParaElModelo(dataDir: string, quien: string): Turno[] {
+  if (TURNOS === 0) return [];
+
+  const recientes = leerConversacion(dataDir, quien).slice(-TURNOS);
+  const salida: Turno[] = [];
+  let chars = 0;
+
+  // Se recorren del más nuevo al más viejo para que, si hay que dejar fuera
+  // algo, sea lo antiguo. Luego se devuelve en orden cronológico.
+  for (let i = recientes.length - 1; i >= 0; i--) {
+    const t = recientes[i]!;
+    const coste = t.pregunta.length + t.respuesta.length;
+    if (chars + coste > MAX_CHARS) break;
+    chars += coste;
+    salida.unshift(t);
+  }
+  return salida;
+}
+
+/** Cómo se le cuenta el historial al modelo. Vacío si no hay nada que contar. */
+export function historialComoTexto(turnos: Turno[]): string {
+  if (turnos.length === 0) return '';
+  return turnos
+    .map((t) => `Cliente: ${t.pregunta}\nTú: ${t.respuesta}`)
+    .join('\n\n');
+}

package/template/src/reintento.ts

@@ -0,0 +1,68 @@
+/**
+ * Reintentar cuando el modelo dice «ahora no».
+ *
+ * POR QUÉ EXISTE. Un proveedor devuelve 429 cuando está saturado o cuando has
+ * ido demasiado deprisa, y 5xx cuando le pasa algo a él. Ninguna de las dos es
+ * culpa tuya y las dos se arreglan solas en segundos. Sin esto, cualquiera de
+ * ellas mata la tarea: el cliente ya pagó, el pago se queda bloqueado, y no
+ * recupera nada hasta que vence el plazo.
+ *
+ * Medido contra Moonshot en agosto de 2026: dos llamadas seguidas y la segunda
+ * volvió con `engine_overloaded_error`. No es un caso raro que haya que
+ * imaginar, es lo normal en una tarde con tráfico.
+ *
+ * QUÉ **NO** SE REINTENTA, que importa igual: los demás 4xx. Un 401 es una
+ * clave mala, un 400 es una petición mal formada y un 404 es un modelo que no
+ * existe. Repetirlos gasta tiempo y dinero para llegar a la misma respuesta, y
+ * retrasa la única noticia útil —que hay algo mal configurado— hasta que se
+ * agotan los intentos.
+ *
+ * La espera CRECE entre intentos. Volver a preguntar de inmediato a un motor
+ * saturado es pedirle el mismo 429: empuja más carga justo cuando menos puede
+ * con ella.
+ */
+
+/** Esperas entre intentos, en milisegundos. Cuatro llamadas como mucho. */
+const ESPERAS = [1_000, 4_000, 10_000];
+
+/** Los códigos que se vuelven a intentar. El resto son respuestas firmes. */
+export function esReintentable(status: number): boolean {
+  return status === 429 || status >= 500;
+}
+
+/**
+ * `fetch` que aguanta un proveedor con hipo.
+ *
+ * Devuelve la última respuesta, reintentable o no: quien llama decide qué
+ * hacer con ella, como con un `fetch` normal. Los fallos de RED sí se
+ * propagan al agotar los intentos, porque ahí no hay respuesta que devolver.
+ */
+export async function fetchModelo(
+  url: string,
+  init: RequestInit,
+  dormir: (ms: number) => Promise<void> = (ms) => new Promise((r) => setTimeout(r, ms)),
+): Promise<Response> {
+  let ultimoFallo: unknown;
+
+  for (let intento = 0; intento <= ESPERAS.length; intento++) {
+    if (intento > 0) {
+      const espera = ESPERAS[intento - 1]!;
+      console.warn(`[modelo] reintento ${intento} de ${ESPERAS.length} dentro de ${espera} ms`);
+      await dormir(espera);
+    }
+    try {
+      const res = await fetch(url, init);
+      if (!esReintentable(res.status) || intento === ESPERAS.length) return res;
+      console.warn(`[modelo] el proveedor respondió ${res.status}`);
+    } catch (err) {
+      // Un corte de red o el timeout del AbortSignal. Se reintenta igual: son
+      // tan pasajeros como un 503, y con el pago bloqueado no rendirse al
+      // primer tropiezo es lo que separa entregar de no entregar.
+      ultimoFallo = err;
+      if (intento === ESPERAS.length) throw err;
+      console.warn(`[modelo] la llamada falló: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+
+  throw ultimoFallo ?? new Error('inalcanzable');
+}

package/template/src/server.ts

@@ -53,6 +53,7 @@ import type { Address } from 'viem';
 import { handleTask } from './agent.js';
 import type { AdjuntoRecibido, 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';
@@ -503,6 +504,7 @@ function contexto(
     amount: bigint;
     deadline: bigint;
     adjuntos: AdjuntoRecibido[];
+    historial: Turno[];
   },
   sobre: CallEnvelope | null,
 ): TaskContext {
@@ -568,6 +570,9 @@ async function work(taskId: bigint, brief: string, sobre: CallEnvelope | null):
           amount: task.amount,
           deadline: task.deadline,
           adjuntos: recibidos,
+          // Un encargo del escrow no arrastra conversación: se paga, se
+          // entrega una vez y se aprueba. La memoria es de los chats.
+          historial: [],
         },
         sobre,
       ),
@@ -1045,6 +1050,11 @@ const server = createServer((req, res) => {
               // Una llamada x402 es una pregunta y una respuesta: no hay tarea
               // donde anclar un adjunto, así que tampoco hay adjuntos.
               adjuntos: [],
+              // Lo que ya se habló con ESTA persona. Quién es lo dice el pago:
+              // firmó un permiso y el cobro se ejecutó en la cadena, así que
+              // nadie puede continuar la conversación de otro sin pagar como
+              // él. Por eso no hace falta autenticar nada aquí.
+              historial: historialParaElModelo(DATA_DIR, leido.payment.payer),
             },
             sobre,
           ),
@@ -1062,6 +1072,12 @@ const server = createServer((req, res) => {
         }
         res.setHeader('x-payment-tx', cobro.txHash);
         json(res, 200, { answer, paid: { txHash: cobro.txHash, amount: cobro.amount.toString(), asset: X402_TOKEN } });
+
+        // El turno se guarda AQUÍ, con las dos mitades y sólo si hubo
+        // respuesta. Guardarlo antes de trabajar dejaría preguntas sin
+        // contestar en la memoria, y la siguiente vez el modelo leería una
+        // conversación en la que él se quedó callado.
+        recordarTurno(DATA_DIR, leido.payment.payer, { pregunta: prompt, respuesta: answer, cuando: Date.now() });
       } catch (err) {
         console.error(`[x402] cobrado pero falló al responder: ${err instanceof Error ? err.message : err}`);
         json(res, 502, {