Repository navigation
Releases
TeleCodex 0.10.1 — Connection recovery
Recover transient read-only Windows connector requests with one bounded retry. Preserve at-most-once command execution and authenticated receipt recovery. Add safe transport diagnostics and outage regressions.
TeleCodex 0.10.0 — Desktop connection reliability
0.10.0 - 2026-10-12
- Preserve control of the existing desktop thread owner; no independent execution engine is introduced.
- Send compact state deltas for small updates, with revision validation and snapshot fallback.
- Add bounded sequenced SSE replay with Last-Event-ID; expired cursors and connector restarts require fresh state.
- Persist command receipts in SQLite WAL before desktop dispatch; reject duplicate pending commands and conflicting identities. Recover lost acceptance responses through read-only receipt lookup.
- Separate desktop reconciliation, Telegram delivery and account polling into independently locked maintenance lanes.
- Persist Telegram delivery checkpoints, reuse message IDs after bot restart, and deliver all unseen completed turns when newer work has already started.
- Resume Telegram polling from the saved offset instead of discarding offline updates.
- Add outage, restart, duplicate-write, receipt binding, delta-size and blocked-delivery regression coverage.
TeleCodex v0.9.4 — Queue recovery
TeleCodex 0.9.4 includes the queue completion recovery introduced in 0.9.2 and fixes a timeout edge case during slow network reconnection.
- Accepted turn IDs persist across restarts; completed, failed and interrupted tasks are reconciled without replaying their requests.
- Queue refresh and two-step owner confirmation are available for legacy accepted requests whose identity was not saved. Fresh idle state is required.
- Telegram delivery failures no longer prevent queue maintenance.
- Snapshot deadlines are handled while slow follow RPCs are still pending, avoiding an unhandled rejection during an internet outage.
- The graphical panel stays opt-in; this update does not enable it.
Validation: 154 Persian-edition and 156 English-edition automated tests, including receipt recovery, confirmation expiry, identity conflicts, Telegram failures and slow snapshot refresh.
Developed by Mohsen Zamani / ZamaniDeveloper. See LICENSE for use and attribution requirements.
TeleCodex v0.9.2 — Queue completion recovery
TeleCodex 0.9.2 fixes queue waits after interrupted or completed tasks lose their user-message identity during an internet disruption.
- Persist the exact accepted turn ID from the desktop response.
- Match completion by that saved receipt or request identity, including itemless interrupted turns and positively observed uncertain deliveries.
- Refresh the queue from live snapshots and keep maintenance running when Telegram output fails.
- Provide a two-step owner confirmation for old accepted requests with no recoverable identity; require fresh idle state and never replay the old request.
- Keep the graphical panel opt-in and preserve queued requests, files, conversations and authentication.
Validation: 153 Persian-edition and 155 English-edition automated tests, including acceptance across restart, missing message items, identity conflicts, confirmation expiry and Telegram delivery failures.
Developed by Mohsen Zamani / ZamaniDeveloper. See LICENSE for use and attribution requirements.
TeleCodex v0.9.1 — Queue recovery
TeleCodex 0.9.1 fixes a queue that could remain blocked after an internet interruption.
- An empty pending turn with no ID is ignored only after a terminal identified turn when desktop runtime is explicitly idle. Active or ambiguous starts still block dispatch.
- Queued conversations receive a fresh snapshot after 30 seconds without one, and reconnects force a new subscription snapshot.
- Silent event connections expire after 35 seconds without data or a heartbeat and reconnect without replaying control requests.
- FIFO identity, positive completion matching and uncertain-request protection remain in force.
- The optional graphical panel remains opt-in; updating does not enable it.
Validation: 146 Persian-edition and 148 English-edition tests, including the observed DMC state, missed completion notifications, failed snapshot reads, silent connections and heartbeat recovery. No test message is submitted to a real model.
Developed by Mohsen Zamani / ZamaniDeveloper. See LICENSE for use and attribution requirements.
TeleCodex 0.9.0 — Telegram Mini App
TeleCodex 0.9.0 adds an optional graphical panel inside Telegram, using your existing Windows Codex chats.
- Mobile dashboard with live status and waiting counts.
- Searchable conversations, latest-message preview and explicit activation.
- Projects and new chats within existing projects.
- Loaded chat messages, text submission, exact-turn steering and interruption.
- Queue previews and confirmed removal of waiting or uncertain requests.
- Code diffs reported by Codex in the latest live turn, with bounded previews.
- Telegram initData HMAC authentication, paired-owner restriction, one-hour freshness and same-origin API.
- Durable action intent and duplicate protection, including after restart; uncertain actions are never replayed.
- HTTPS reverse proxy to a localhost listener; the Windows connector remains private behind SSH.
Configure MINIAPP_URL and MINIAPP_PORT as described in docs/MINIAPP.en.md. Restart the Windows connector after updating to include fileChange events. Telegram question replies, grouped attachments, account switching and quota controls remain in the bot chat.
Validation: automated Windows/Linux checks, authenticated HTTP integration tests and a mobile browser walkthrough with synthetic data. Native Telegram phone launch requires verification on the user's device.
Developed by Mohsen Zamani / ZamaniDeveloper. See LICENSE for use and attribution requirements.
TeleCodex 0.8.5 — Queue counts
Codex status now shows the number of waiting requests for the selected conversation and all conversations. The main menu shows the total, and queued-message receipts show both counts.
Each grouped submission counts once. Accepted, dispatching and uncertain requests are excluded from waiting counts. Reopen the status card or main menu to see current values.
Both editions passed automated checks, including multi-chat counts, cancellation, persisted state and existing queue behavior.
Developed by Mohsen Zamani / ZamaniDeveloper. See LICENSE for use and attribution requirements.
TeleCodex 0.8.4 — Telegram Premium
TeleCodex 0.8.4 detects the paired Telegram user's Premium status automatically and provides a Premium settings button and /premium command.
- Animated title emoji and inline button icons, when the bot has Telegram's custom-emoji permission.
- Reuse the effect from a direct private message on short confirmation cards.
- Appearance toggle, permission refresh and safe plain rendering after definitive cosmetic rejections.
- Preserve rich text, question replies, callback routes, edits and live pins.
- Standard 20 MB Bot API download limit and local Whisper remain in effect; no Stars spending or paid broadcasts.
Validated with automated tests in both editions and a real Telegram probe: custom header, custom button and editing the same message were accepted. Received message effects are covered by automated tests; no effect-bearing user message was supplied for live verification.
Developed by Mohsen Zamani / ZamaniDeveloper. See LICENSE for use and attribution requirements.
TeleCodex 0.8.3 — Pinned live progress
پین خودکار پیامهای زندهٔ پیشرفت.
- هر پیام زنده فقط یک بار و بیصدا پین میشود.
- تغییرات و پاسخ نهایی روی همان پیام ویرایش میشوند؛ پین پس از پایان باقی میماند.
- خطای پین ارسال پاسخها و سؤالهای Codex را متوقف نمیکند؛ تلاش مجدد با رعایت محدودیت تلگرام انجام میشود.
- پینهای دیگر و پیامهای تاریخچه تغییر نمیکنند.
اعتبارسنجی: ۱۲۰ آزمون محلی؛ بررسی انتشار بدون اطلاعات خصوصی.
توسعهدهنده: Mohsen Zamani / ZamaniDeveloper. مجوز و نام توسعهدهنده را در بازنشر حفظ کنید.
TeleCodex 0.8.2 — Automatic desktop recovery
بازیابی خودکار Codex و اتصال ربات در ویندوز.
- اگر Codex بسته شود، رابط آن را دوباره باز میکند و اتصال چت انتخابشده را بازیابی میکند.
- بازیابی با تعویض حساب هماهنگ است؛ برنامهٔ در حال اجرا را متوقف نمیکند و درخواست نامشخص را دوباره نمیفرستد.
- اتصال SSH با فاصلهٔ افزایشی دوباره برقرار میشود؛ راهنمای تنظیم سرور برای آزادشدن تونلهای قطعشده اضافه شده است.
- ویندوز باید روشن، بیدار، متصل به اینترنت و وارد حساب کاربر باشد. ورود اولیه به Codex لازم است.
اعتبارسنجی: ۱۱۶ آزمون محلی ویندوز، بررسی نحو PowerShell و بررسی انتشار بدون اطلاعات خصوصی.
توسعهدهنده: Mohsen Zamani / ZamaniDeveloper. مجوز و نام توسعهدهنده را در بازنشر حفظ کنید.