telegram

name	telegram
description	Owner-only Telegram text bridge and Mini App gateway for the existing Ouroboros interface.
version	1.0.1
type	extension
entry	plugin.py
runtime	python3
os	any
permissions	["net","read_settings","widget","route","supervised_task","subscribe_event","inject_chat","subprocess","companion_process"]
env_from_settings	["TELEGRAM_BOT_TOKEN"]
subscribe_events	["chat.outbound","chat.typing","chat.photo","chat.video","chat.document"]
conflicts	["telegram-bridge","telegram-miniapp-poc"]
when_to_use	The owner wants to communicate with and control Ouroboros through Telegram.
timeout_sec	60
companion_processes	[{"name":"miniapp_gateway","command":["python3","scripts/companion.py"],"runtime":"python3","restart_policy":"on_failure","max_restarts":5}]

Telegram

One owner-only Telegram integration provides both the established bot bridge and the optional Mini App. The first positive private Telegram chat binds as the sole owner. Text and photos can be sent to Ouroboros; replies, photos, videos, documents, typing state, subagent cards, and opt-in notifications are mirrored back to that owner.

The Mini App exposes the unchanged Ouroboros SPA through the established owner-authenticated sidecar and a pinned Cloudflare Quick Tunnel. It is enabled by default after owner binding and can be turned off independently without stopping the text bridge. Disabling the skill destroys process-memory Mini App sessions, stops public exposure, and best-effort restores the prior Telegram menu button. Rotate the bot token only while the skill is disabled, then re-enable it.

Set TELEGRAM_BOT_TOKEN in Settings, grant it to this skill, enable the skill, and send the bot a private message to bind the owner. No legacy Telegram skill state is copied or changed. Installations that use telegram-bridge or telegram-miniapp-poc must disable or remove those skills before enabling this one.

The Mini App supports macOS arm64/x86_64, Linux arm64/x86_64, and Windows x86_64. Only the explicit unsupported OS/architecture case degrades independently: the text bridge remains available while Mini App status reports that no pinned cloudflared asset exists. Invalid host runtime, unsafe state, or companion registration errors fail the skill load instead of claiming a partial healthy installation.

The Mini App is Beta. Its best-effort Cloudflare Quick Tunnel has no SLA and does not support Server-Sent Events (SSE). It targets native Telegram clients; Telegram WebA/WebK are not supported.