Repository navigation
Releases: Hsoofi82/NovaAgent
Release list
ƝØVΛ 0.961 — Astro Architecture
ƝØVΛ 0.961 — Astro Architecture
Nova has entered a new architectural phase.
This release is not just a collection of new features. Large parts of the system were redesigned around a more reliable, deterministic and agent-oriented architecture, with stronger task planning, routing, execution control, verification, memory handling, delivery reliability and product surfaces.
🚀 What's New
🧠 Agent Intelligence & Task Orchestration
- Added deterministic task planning with
agentPlan - Introduced explicit plan → execute → verify → recover flow
- Added task-state tracking and artifact ledger
- Added deliverable quality scoring based on completeness, design system, size and intent matching
- Improved routing between conversation, research, media, web apps, games and document workflows
- Added forced-tool routing and rebuild-once contracts for generated applications
- Reduced duplicate tool calls and unnecessary model work
- Improved multi-step and multi-deliverable task handling
⚡ Performance & Reliability
- Major reduction of unnecessary model/tool calls
- Improved parallel execution for independent operations
- Stronger timeout and cancellation handling
- Better partial-failure preservation
- Improved delivery-failure classification and recovery
- More reliable progress state and task lifecycle handling
- Reduced unnecessary D1/KV activity
- Improved session and runtime state management
- Added stronger safeguards against stale or invalid task state
🧩 New Application Architecture
Nova is no longer centered around a single monolithic behavior path.
The runtime is now split into dedicated layers for:
- Agent planning
- Intent classification
- Tool routing
- Runtime execution
- Memory
- Reliability
- Artifact validation
- Deployment lifecycle
- Application factory
- Search/retrieval
- Office/document generation
This makes the system easier to extend while keeping expensive and stateful operations isolated.
🌐 Web Apps & Games
- Reworked web-app generation flow
- Improved game generation and validation
- Better device-aware design generation
- More diverse UI generation instead of forcing game-style controls onto every mobile app
- Improved source/project delivery for serious multi-file requests
- Better deployment lifecycle management
- Improved hosted-app metadata, expiry and redeployment handling
📱 Mini App & Dashboards
- Added/expanded the user-facing Telegram Mini App
- User resources are now isolated from admin data
- Added authenticated Mini App API flow using Telegram
initData - Improved dashboard architecture and performance
- Added dedicated admin control center architecture
- Added application factory surface
- Telegram menu integration now opens the web app directly
📄 Office & Document Engine
Improved Nova's document generation pipeline across:
- DOCX
- XLSX
- PPTX
Includes improved themes, RTL handling, Persian typography/punctuation support, normalization and document validation.
🔎 Search & Research
- Improved web-search routing
- Added clearer separation between search, page reading and synthesis
- Improved retrieval orchestration and result handling
- Reduced unnecessary searches during normal conversations
🧠 Memory & Context
- Improved task-scoped state
- Improved memory selection and merging
- Reduced stale-memory paths
- Better separation between conversation state and durable artifacts
- Improved group context handling
- Added stronger protections against accidental state loss
🤖 Telegram Runtime
- Improved message delivery handling
- Better progress panels and cancellation
- Improved group behavior and heavy-task controls
- Improved sticker/GIF reactions and anti-repetition logic
- Better media handling
- Improved scheduled jobs and reminder infrastructure
- Stronger admin and moderation controls
🏗️ Application Factory
- Added a dedicated native application workflow
- Added Android APK/AAB and Windows build targets
- Added project/build lifecycle state
- Added application status/list/edit/build operations
- Added a dedicated factory dashboard
- Native builds remain capability-dependent on the configured external build worker
🔐 Security & Isolation
- User Mini App APIs are scoped to the authenticated Telegram user
- Admin interfaces remain owner-only
- Sensitive global system data is isolated from user-facing surfaces
- Stronger request validation and capability boundaries
- Improved webhook and runtime safety checks
🧪 Validation
The architecture has gone through repeated engineering and validation passes covering:
- Agent routing
- Tool execution
- Memory/state handling
- Telegram delivery
- D1/KV usage
- Web apps
- Games
- Documents
- Mini Apps
- Admin surfaces
- Application factory
- Failure recovery
- Artifact validation
The goal of this release is not simply to add more capabilities, but to make Nova substantially more capable of planning, building, verifying and delivering complete results reliably.
Core Direction
Nova is evolving from a Telegram AI bot into a full agentic application platform:
Understand → Plan → Execute → Verify → Recover → Deliver
This release establishes the architecture for the next generation of Nova.
🇮🇷 ترجمه فارسی
ƝØVΛ 0.961 — معماری Astro
Nova وارد یک مرحلهی جدید معماری شده است.
این نسخه فقط مجموعهای از قابلیتهای جدید نیست. بخش بزرگی از سیستم با تمرکز بر معماریای قابلاعتمادتر، قطعیتر و Agent-oriented بازطراحی شده است؛ از برنامهریزی وظایف و مسیریابی گرفته تا کنترل اجرا، اعتبارسنجی، مدیریت حافظه، تحویل نتیجه و سطوح مختلف محصول.
🚀 قابلیتهای جدید
🧠 هوش Agent و مدیریت وظایف
- اضافه شدن برنامهریزی قطعی وظایف با
agentPlan - ایجاد جریان مشخص Plan → Execute → Verify → Recover
- اضافه شدن مدیریت وضعیت وظایف و Artifact Ledger
- اضافه شدن امتیازدهی کیفیت خروجی بر اساس کاملبودن، Design System، اندازه و میزان تطابق با درخواست
- بهبود مسیریابی بین مکالمه، تحقیق، مدیا، وباپ، بازی و فرآیندهای اسناد
- اضافه شدن مسیریابی اجباری ابزارها و قرارداد rebuild-once برای اپلیکیشنهای تولیدشده
- کاهش فراخوانیهای تکراری ابزارها و پردازشهای غیرضروری مدل
- بهبود اجرای وظایف چندمرحلهای و چندخروجی
⚡ عملکرد و پایداری
- کاهش چشمگیر فراخوانیهای غیرضروری مدل و ابزار
- بهبود اجرای موازی عملیات مستقل
- مدیریت بهتر Timeout و Cancellation
- حفظ بهتر نتایج در صورت خطاهای جزئی
- طبقهبندی و بازیابی بهتر خطاهای تحویل
- مدیریت قابلاعتمادتر وضعیت پیشرفت و چرخهی حیات وظایف
- کاهش فعالیتهای غیرضروری D1/KV
- بهبود مدیریت Session و وضعیت Runtime
- محافظت بیشتر در برابر وضعیتهای قدیمی یا نامعتبر
🧩 معماری جدید Application
Nova دیگر بر پایهی یک مسیر رفتاری Monolithic ساخته نشده است.
Runtime اکنون به لایههای اختصاصی برای بخشهای زیر تقسیم شده است:
- Agent Planning
- Intent Classification
- Tool Routing
- Runtime Execution
- Memory
- Reliability
- Artifact Validation
- Deployment Lifecycle
- Application Factory
- Search / Retrieval
- Office / Document Generation
این ساختار باعث میشود توسعهی سیستم آسانتر شود و در عین حال عملیات سنگین و Stateful از بخشهای دیگر جدا بمانند.
🌐 وباپها و بازیها
- بازطراحی فرآیند تولید Web App
- بهبود تولید و اعتبارسنجی بازیها
- طراحی بهتر بر اساس دستگاه هدف
- رابطهای متنوعتر بهجای تحمیل کنترلهای مخصوص بازی به تمام اپلیکیشنهای موبایل
- تحویل بهتر Source و Project برای پروژههای چندفایلی جدی
- مدیریت بهتر چرخهی حیات Deployment
- بهبود Metadata، انقضا و انتشار مجدد Web Appها
📱 Mini App و داشبوردها
- توسعه و گسترش Telegram Mini App کاربر
- جداسازی منابع کاربران از دادههای Admin
- API احراز هویتشدهی Mini App با Telegram
initData - بهبود معماری و عملکرد Dashboard
- ایجاد معماری اختصاصی برای Nova Control Center
- اضافه شدن Application Factory
- اتصال مستقیم منوی تلگرام به Web App
📄 موتور Office و اسناد
موتور تولید اسناد Nova برای موارد زیر بهبود یافته است:
- DOCX
- XLSX
- PPTX
این تغییرات شامل Themeهای بهتر، RTL، پشتیبانی بهتر از تایپوگرافی و علائم نگارشی فارسی، Normalization و اعتبارسنجی اسناد است.
🔎 جستوجو و Research
- بهبود مسیریابی Web Search
- تفکیک بهتر Search، Page Reading و Synthesis
- بهبود Retrieval و پردازش نتایج
- کاهش جستوجوهای غیرضروری در مکالمات معمولی
🧠 حافظه و Context
- بهبود Task-scoped State
- بهبود انتخاب و ادغام Memory
- کاهش مسیرهای استفاده از حافظهی قدیمی
- جداسازی بهتر Conversation State از Durable Artifacts
- بهبود Context گروهها
- محافظت بیشتر در برابر از دست رفتن تصادفی وضعیت
🤖 Runtime تلگرام
- بهبود تحویل پیامها
- پنلهای Progress و Cancellation بهتر
- بهبود رفتار گروهها و کنترل عملیات سنگین
- بهبود سیستم Sticker/GIF و جلوگیری از تکرار
- مدیریت بهتر Media
- بهبود Scheduled Jobs و Reminderها
- کنترلهای قویتر Admin و Moderation
🏗️ Application Factory
- اضافه شدن Workflow اختصاصی ساخت اپلیکیشن Native
- پشتیبانی از Targetهای Android APK/AAB و Windows
- مدیریت چرخهی حیات Project و Build
- عملیات Status / List / Edit / Build
- داشبورد اختصاصی Factory
- Buildهای Native همچنان وابسته به External Build Worker تنظیمشده هستند
🔐 امنیت و Isolation
- APIهای Mini App کاربر فقط به کاربر احراز هویتشده دسترسی دارند
- رابطهای Admin همچنان فقط برای Owner قابل دسترسی هستند
- دادههای حساس و سراسری سیستم از سطوح کاربری جدا شدهاند
- اعتبارسنجی درخواستها و مرزهای دسترسی قویتر شدهاند
- امنیت Webhook و Runtime بهبود یافته است
🧪 اعتبارسنجی
این معماری طی چندین مرحلهی مهندسی و Validation در بخشهای زیر بررسی و بهبود داده شده است:
- Agent Routing
- Tool Execution
- Memory / State Handling
- Telegram Delivery
- D1 / KV Usage
- Web Apps
- Games
- Documents
- Mini Apps
- Admin Surfaces
- Application Factory
- Failure Recovery
- Artifact Validation
هدف این Release فقط اضافه کردن قابلیتهای بیشتر نیست؛ هدف این است که Nova در **برنامهری...
Nova v0.955 B — Speed, Search & Intelligence Upgrade⚡
🇬🇧 English
A major Nova upgrade focused on speed, smarter search, reliability, and overall intelligence.
🚀 Performance
- Significantly improved response latency and time-to-first-byte.
- Gemini responses now stream progressively.
- Removed unnecessary model round-trips and redundant processing.
- Moved non-critical persistence and bookkeeping off the main response path.
- Improved concurrency, caching, retries, and request efficiency.
🔎 New Search Engine
- Rebuilt Nova's search architecture into a single canonical, model-driven system.
- Search depth, freshness, queries, research rounds, and stopping conditions are decided intelligently per request.
- Fast requests stay fast; complex questions automatically receive deeper research.
- Search answers are clean and natural by default, without unnecessary source lists or URLs.
- Super Deep Search is now adaptive, parallelized, bounded, and resilient instead of failing from excessive steps.
- Improved graceful degradation when providers or individual searches fail.
🧠 Intelligence & Routing
- More semantic request routing with fewer hardcoded keyword rules.
- Improved handling of activation, research, persona, and tool selection.
- Reduced unnecessary processing for simple conversations.
🎮 Game Engine
- Improved generated game visual diversity and design consistency.
- Fixed legacy visual fallbacks and improved theme/palette handling.
- Improved puzzle-game controls and contextual hints.
- Improved horror-game visual behavior.
✅ Reliability
- Expanded regression coverage.
- 140+ automated tests passing.
- TypeScript validation clean.
🇮🇷 فارسی
یک آپدیت بزرگ برای Nova با تمرکز روی افزایش محسوس سرعت، جستجوی هوشمندتر، پایداری و عملکرد بهتر.
🚀 عملکرد
- کاهش محسوس زمان پاسخ و شروع سریعتر نمایش پاسخ.
- استریم تدریجی پاسخهای Gemini.
- حذف درخواستها و پردازشهای اضافی.
- انتقال عملیات غیرضروری از مسیر اصلی پاسخ.
- بهینهسازی همزمانی، کش، Retry و ارتباطات.
🔎 سیستم جستجوی جدید
- بازطراحی کامل Search بهصورت یک سیستم واحد و Model-Driven.
- خود مدل بر اساس مفهوم درخواست تصمیم میگیرد چه مقدار جستجو و چه میزان تازگی لازم است.
- درخواستهای ساده سریع انجام میشوند و درخواستهای پیچیده بهصورت عمیقتر بررسی میشوند.
- نمایش پیشفرض منابع و URLهای اضافی حذف شده است.
- Super Deep Search به یک سیستم تحقیقاتی تطبیقی، موازی و کنترلشده تبدیل شده و خطای «مراحل بیش از حد مجاز» برطرف شده است.
- خطاهای جستجو و سرویسها با Graceful Degradation مدیریت میشوند.
🧠 هوشمندی و Routing
- درک معنایی بهتر درخواستها و کاهش وابستگی به Keywordهای هاردکد.
- بهبود انتخاب ابزار و تشخیص Research، Persona و سایر Intentها.
- کاهش پردازشهای غیرضروری در مکالمات ساده.
🎮 Game Engine
- تنوع و کیفیت بصری بازیهای تولیدشده بهبود یافته.
- مشکلات ظاهرهای قدیمی و Paletteهای تکراری اصلاح شدهاند.
- Hint و کنترل بازیهای Puzzle هوشمندتر شدهاند.
- رفتار بصری بازیهای Horror بهبود یافته است.
✅ پایداری
- تستهای Regression گستردهتر.
- بیش از ۱۴۰ تست خودکار موفق.
- TypeScript بدون خطا بررسی شده است.
What's Changed
New Contributors
Full Changelog: V956...V0.955
NOVA v0.953 HotFix⚡
🔥 Nova Hotfix — Media & Reply Analysis
This release includes a critical hotfix for media analysis and reply handling.
- 🖼️ Improved image analysis — more reliable processing of images sent directly or via reply.
- 🎬 Fixed GIF analysis — GIFs are now properly detected and analyzed instead of being treated as unknown/random files.
- 🎥 Improved video handling — videos are passed to the AI as actual media for content analysis.
- 📎 Fixed GIFs sent as documents — Telegram may represent some GIFs as
document/MP4 instead ofanimation; Nova now detects and analyzes both formats. - 🔁 Improved reply-to-media context — replying to a GIF, video, image, audio or document now correctly attaches the original media to the AI context.
- 🎙️ Better voice analysis — voice messages now use both transcription and the original audio when processing.
- 📄 Improved document handling — non-PDF documents are no longer blindly reduced to their filenames; the actual file is passed when supported.
- 🛡️ Reduced hallucinations — Nova is explicitly prevented from guessing media content based on filenames, file IDs or placeholders such as
[GIF]. - 🐛 Additional diagnostics & stability fixes across the media pipeline.
🇮🇷 هاتفیکس نوا — تحلیل رسانه و ریپلای
این نسخه یک هاتفیکس مهم برای سیستم تحلیل رسانه و پیامهای ریپلایشده است.
- 🖼️ بهبود تحلیل تصاویر — پردازش تصاویر ارسالی مستقیم و ریپلایشده قابلاعتمادتر شده است.
- 🎬 رفع مشکل تحلیل GIF — گیفها دیگر بهعنوان فایل ناشناس یا رندوم در نظر گرفته نمیشوند و محتوای واقعی آنها بررسی میشود.
- 🎥 بهبود تحلیل ویدیو — فایل واقعی ویدیو برای تحلیل محتوایی در اختیار هوش مصنوعی قرار میگیرد.
- 📎 رفع مشکل GIFهایی که بهصورت Document ارسال میشوند — تلگرام بعضی گیفها را به شکل
documentیا MP4 تحویل میدهد؛ نوا حالا این حالتها را نیز تشخیص میدهد. - 🔁 بهبود Reply Context — ریپلای روی GIF، ویدیو، تصویر، صوت و سند حالا رسانه اصلی را بهدرستی وارد context هوش مصنوعی میکند.
- 🎙️ بهبود تحلیل ویس — علاوه بر متن استخراجشده، خود فایل صوتی نیز برای تحلیل استفاده میشود.
- 📄 بهبود تحلیل فایلها — فایلهای غیر PDF دیگر صرفاً بر اساس اسم فایل به مدل معرفی نمیشوند و در صورت پشتیبانی، محتوای واقعی فایل ارسال میشود.
- 🛡️ کاهش پاسخهای حدسی — نوا نباید محتوای رسانه را از روی اسم فایل، File ID یا عباراتی مثل
[GIF]حدس بزند. - 🐛 رفع باگها و بهبود پایداری در pipeline پردازش و تحلیل رسانه.
Full Changelog: V0.952...V953
NOVA v0.952⚡
ƝØVΛ 0.952 Beta
A major reliability and performance update for Nova Telegram AI Assistant.
✨ Highlights
- Improved ElevenLabs TTS reliability and audio handling
- Fixed voice generation failures caused by aggressive timeouts
- Added better TTS validation and error reporting
- Improved automatic API key rotation for Gemini and ElevenLabs
- Added stronger voice-response tool instructions to prevent invalid TTS input
- Improved Agent tool execution and timeout coordination
- Optimized Cloudflare AI image generation fallback handling
- Improved Telegram media delivery and retry behavior
- Added better cancellation and task-progress handling
- Improved memory, session and background-task reliability
- Cleaner and more Open Source-friendly
wrangler.tomlconfiguration - Improved logging and observability for production debugging
⚡ Performance
- Better timeout coordination across AI providers and Agent tools
- Reduced unnecessary retries and wasted requests
- Improved fallback behavior when an upstream provider is slow or unavailable
- Optimized Cloudflare Workers execution for lightweight and responsive operation
🔧 Deployment
This release is designed to run on Cloudflare Workers with:
- Cloudflare D1
- Gemini API
- ElevenLabs TTS
- Google Custom Search
- Cloudflare AI
🔐 Security
- Configuration uses safe placeholders for Open Source deployment
- API keys and tokens should be supplied through your own deployment environment
- No real credentials are included in this release
📌 Notes
This is a Beta release. Some features may continue to receive performance and reliability improvements in upcoming versions.
Thanks for testing Nova and helping improve the project. ❤️
🇮🇷 توضیحات فارسی
ƝØVΛ 0.952 Beta
این نسخه یک بهروزرسانی مهم برای پایداری، سرعت و قابلیت اطمینان نوا است.
✨ تغییرات مهم
- بهبود پایداری سیستم تبدیل متن به گفتار با ElevenLabs
- رفع خطاهای تولید ویس بهدلیل Timeoutهای نامناسب
- بهبود اعتبارسنجی و گزارش خطاهای TTS
- بهبود چرخش خودکار API Keyهای Gemini و ElevenLabs
- جلوگیری بهتر از ارسال متن نامعتبر به ابزار Voice
- بهبود اجرای ابزارهای Agent و هماهنگی Timeoutها
- بهبود سیستم Fallback برای Cloudflare AI
- بهبود ارسال رسانه در Telegram و مکانیزم Retry
- بهبود سیستم لغو عملیات و نمایش پیشرفت
- بهبود پایداری Session، Memory و Background Taskها
- آمادهسازی بهتر تنظیمات
wrangler.tomlبرای پروژههای Open Source - بهبود Logging و Observability برای عیبیابی در محیط Production
⚡ بهینهسازی عملکرد
- هماهنگی بهتر Timeoutها بین Agent و سرویسهای هوش مصنوعی
- کاهش Retryهای غیرضروری و مصرف منابع
- بهبود Fallback هنگام کند بودن یا در دسترس نبودن سرویسها
- بهینهسازی اجرای Nova روی Cloudflare Workers
🔧 زیرساخت
این نسخه برای اجرا روی زیرساختهای زیر طراحی شده است:
- Cloudflare Workers
- Cloudflare D1
- Google Gemini
- ElevenLabs
- Google Custom Search
- Cloudflare AI
🔐 امنیت
- تنظیمات Open Source با Placeholderهای امن ارائه شدهاند
- کلیدهای API و Tokenها باید توسط صاحب Deployment تنظیم شوند
- هیچ Credential واقعی در این Release قرار داده نشده است
📌 توجه
این نسخه همچنان Beta است و ممکن است در نسخههای آینده بهبودهای بیشتری در سرعت، پایداری و قابلیتهای Nova اعمال شود.
از همه کسانی که Nova را تست میکنند و در بهتر شدن پروژه کمک میکنند، ممنونیم. ❤️
Full Changelog: v0.950...V0.952
NOVA v0.950⚡
🇬🇧 Nova vNext — Full Admin Dashboard Migration
A major new release for Nova: the legacy Telegram Admin Panel has been completely removed and replaced with a modern, responsive Web Admin Dashboard.
✨ Highlights
- 🌐 Brand-New Web Admin Dashboard with full Telegram WebApp support
- ⚡ Expanded Admin API from 13 → 28 Endpoints
- 👤 Advanced user management: Memory, History, Notes, Prompts, Limits & Direct Messages
- 👥 Group management with VIP and Heavy Task controls
- 📡 Live Broadcast System with progress tracking and cancellation
- 🗂️ WebApp and Media management
- ⚙️ Config, Logs, Keys, Personas and System controls
- 🔐 Improved security with Telegram WebApp initData authentication
- 📱 Better mobile, Safe Area and Telegram WebView support
- 🧹 Completely removed the legacy Telegram Control Center and dead code
- 🐛 Multiple bug fixes and architecture improvements
Nova just got a brand-new command center. 🚀
🚀 Nova vNext — مهاجرت کامل پنل مدیریت به Web Dashboard
نسخه جدید Nova با یک تغییر بزرگ منتشر شد: پنل مدیریت تلگرام بهطور کامل کنار گذاشته شد و تمام امکانات مدیریتی به یک Web Dashboard مدرن و ریسپانسیو منتقل شدند.
✨ تغییرات اصلی
- 🌐 Web Admin Dashboard جدید با پشتیبانی کامل از Telegram WebApp
- ⚡ افزایش Admin API از 13 → 28 Endpoint
- 👤 مدیریت پیشرفته کاربران: Memory، History، Notes، Prompt، Limits و Direct Message
- 👥 مدیریت گروهها، VIP و Heavy Tasks
- 📡 Broadcast زنده با نمایش Progress و امکان Cancel
- 🗂️ مدیریت و حذف WebAppها و Mediaها
- ⚙️ مدیریت Config، Logs، Keys، Personas و System
- 🔐 احراز هویت امنتر با Telegram WebApp initData
- 📱 بهبود کامل تجربه موبایل، Safe Area و Telegram WebView
- 🧹 حذف کامل Telegram Control Center و کدهای قدیمی و بدون استفاده
- 🐛 رفع باگهای متعدد و بهبود ساختار کلی پروژه
Full Changelog: v0.949...v0.950
NOVA v0.949 — First Open-Source Release 🌍
First public open-source release of ƝØVΛ — Advanced AI Agent Platform for Telegram, now licensed under AGPL-3.0-or-later.
Highlights
🧠 Gemini AI agent with function calling, memory & multi-step tool execution
🎨 Image generation/editing/search, TTS voice responses, RTL PDF engine
🌐 Web Builder: AI-generated, publicly-hosted single-file web apps
🎮 Game Engine: AI-generated HTML5 games (canvas, physics, particles)
📱 Telegram Mini App dashboard + 👑 Nova Control Center for admins
🏢 Telegram Business automation
Self-hosting
Nova is self-hostable on the Cloudflare free tier — see the README (Installation) to deploy your own instance in minutes.
Security notes
All credentials now live in Worker Secrets — wrangler.toml ships clean.
npm test includes an automated secret-leak guard.
Full changelog: CHANGELOG.md
Full Changelog: https://github.com/Hsoofi82/NovaAgent/commits/v0.949