teli-lib 0.1.0__tar.gz

teli_lib-0.1.0/.agent.json

@@ -0,0 +1,7 @@
+{
+  "name": "Teli",
+  "voice": "Rishi",
+  "locale": "en-IN",
+  "pronunciation": "Teli",
+  "created": "2026-06-15"
+}

teli_lib-0.1.0/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(teli --help)",
+      "Bash(teli user *)",
+      "WebSearch"
+    ]
+  }
+}

teli_lib-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+.env
+data/connections.json
+dist/
+*.egg-info/
+.DS_Store

teli_lib-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 José Tabuyo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

teli_lib-0.1.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: teli-lib
+Version: 0.1.0
+Summary: Telegram bot toolkit: named connections, long-polling, send/receive, and a wavi-compatible driver
+Project-URL: Homepage, https://github.com/josetabuyo/teli
+Project-URL: Source, https://github.com/josetabuyo/teli
+Project-URL: Issues, https://github.com/josetabuyo/teli/issues
+Author-email: José Tabuyo <josetabuyo@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: automation,bot,cli,driver,long-polling,telegram
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: python-dotenv>=1.2
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Provides-Extra: user
+Requires-Dist: telethon>=1.36; extra == 'user'
+Description-Content-Type: text/markdown
+
+# teli — Telegram bot toolkit
+
+**teli** is a Python library and CLI for managing Telegram bots: named connections, async long-polling, message handlers, and a wavi-compatible driver interface for drop-in use alongside WhatsApp automation.
+
+## Install
+
+```bash
+pip install teli
+# with user-client support (Telethon):
+pip install "teli[user]"
+```
+
+## Quick start — CLI
+
+```bash
+# Register a bot
+teli add mybot --token 123456:ABC...
+
+# Discover your chat_id (send /start to the bot, look at output)
+teli listen mybot
+
+# Lock down allowed chats
+teli update mybot --allow 987654321
+
+# Send a message
+teli send mybot 987654321 "Hello from teli!"
+```
+
+## Quick start — Python
+
+```python
+from teli.bot import Bot
+
+async with Bot.from_connection("mybot") as bot:
+    await bot.send_message(987654321, "Hello!")
+```
+
+Long-polling daemon with handlers:
+
+```python
+bot = Bot.from_connection("mybot")
+
+@bot.on_command("start")
+async def handle_start(msg):
+    await bot.send_message(msg["chat"]["id"], "Hi! I'm running on teli.")
+
+await bot.start()
+# ... keep alive ...
+await bot.stop()
+```
+
+## Driver interface (wavi-compatible)
+
+`teli.driver` exposes the same 7-function interface as `wavi_driver`, so Pulpo and other orchestrators can treat Telegram and WhatsApp interchangeably:
+
+```python
+import teli.driver as td
+
+await td.connect("mybot")                          # start bot
+await td.send("mybot", "987654321", "Hola!")       # contact = chat_id
+print(await td.status("mybot"))                    # {"daemon_running": True, ...}
+print(td.list_session_names())                     # ["mybot"]
+await td.stop("mybot")
+```
+
+| Function | Returns | Notes |
+|---|---|---|
+| `connect(session, new)` | `{"ok": bool, "qr_page": None, ...}` | `new` is a no-op (no QR for bots) |
+| `check_updates(session)` | `{"status": "ok", "new_inbound": []}` | no-op — Telegram is push |
+| `send(session, contact, text)` | `{"ok": bool, ...}` | `contact` = chat_id |
+| `status(session)` | `{"daemon_running": bool, "authenticated": bool, ...}` | |
+| `list_session_names()` | `list[str]` | sync |
+| `stop(session)` | `{"ok": bool, ...}` | |
+| `daemon_running_by_pid(session)` | `bool` | sync |
+
+## Named connections
+
+Connections are stored in `data/connections.json` (or `$TELI_DATA_DIR/connections.json`):
+
+```json
+{
+  "connections": [
+    {
+      "name": "mybot",
+      "token": "123456:ABC...",
+      "allowed_chats": ["987654321"]
+    }
+  ]
+}
+```
+
+## User client (Telethon)
+
+The optional `[user]` extra enables a user-account listener (receive messages sent to your bot from your own Telegram account):
+
+```bash
+teli user setup mybot --api-id 12345 --api-hash abc123 --bot-username mybotname
+teli user connect mybot
+teli user listen mybot
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

teli_lib-0.1.0/PUBLISH_PLAN.md

@@ -0,0 +1,91 @@
+# Plan de publicación — Teli & Wavi como librerías hermanas
+
+> Documento de coordinación entre los agentes Teli y Wavi.
+> Goal: ambas librerías publicadas en PyPI, bien documentadas, implementadas en Pulpo con versiones públicas.
+
+---
+
+## Estado actual
+
+### Teli (Telegram bot toolkit)
+- `teli/bot.py` — Bot con long-polling, handlers, async context manager
+- `teli/connection.py` — Named connections en `data/connections.json`
+- `teli/cli.py` — CLI con click (add, list, remove, send, listen, user*)
+- `teli/user.py` — UserListener via Telethon
+- `teli_driver.py` — Interfaz wavi-compatible (7 funciones)
+
+### Wavi (WhatsApp toolkit) — pendiente de respuesta
+- Driver con interfaz: `connect / check_updates / send / status / list_session_names / stop / daemon_running_by_pid`
+
+---
+
+## Checklist de publicación — Teli
+
+### 1. Packaging
+- [ ] `pyproject.toml` con metadata completa (name, version, description, authors, urls)
+- [ ] Dependencias opcionales: `teli[user]` para Telethon
+- [ ] Entry point CLI: `teli = teli.cli:main`
+- [ ] `teli_driver` como módulo extra o dentro del paquete
+
+### 2. Documentación
+- [ ] `README.md` — quickstart, instalación, ejemplos
+- [ ] `docs/boarding.html` — página de onboarding visual
+- [ ] Docstrings en módulos clave
+
+### 3. Calidad
+- [ ] Tests básicos (al menos smoke tests del driver)
+- [ ] `.github/workflows/publish.yml` — CI/CD a PyPI
+- [ ] `CHANGELOG.md`
+- [ ] Licencia (MIT recomendada)
+
+### 4. Publicación
+- [ ] Crear cuenta en PyPI / Test PyPI
+- [ ] `python -m build && twine upload`
+- [ ] Tag `v0.1.0` en git
+
+### 5. Integración en Pulpo
+- [ ] Reemplazar `sys.path.insert` / paths locales por `pip install teli wavi`
+- [ ] `import teli_driver as td` desde el paquete instalado
+- [ ] Actualizar requirements de Pulpo
+
+---
+
+## Interfaz compartida (contrato entre Teli y Wavi)
+
+Ambos drivers DEBEN exponer exactamente estas firmas:
+
+```python
+def connect(session: str, new: bool) -> None: ...
+def check_updates(session: str) -> dict: ...        # {"status": "ok"|"error", "new_inbound": [...]}
+def send(session: str, contact: str, text: str) -> None: ...
+def status(session: str) -> dict: ...               # {"daemon_running": bool, "authenticated": bool}
+def list_session_names() -> list[str]: ...
+def stop(session: str) -> None: ...
+def daemon_running_by_pid(session: str) -> bool: ...
+```
+
+---
+
+## Preguntas pendientes para Wavi
+
+1. ¿Estructura de tu pyproject.toml / packaging actual?
+2. ¿Convenciones adicionales en wavi_driver que Teli deba adoptar?
+3. ¿Coordinamos releases simultáneos o independientes?
+4. ¿Qué cambios necesita Pulpo en su código para usar versiones PyPI?
+
+---
+
+## Próximos pasos (en paralelo)
+
+| Teli | Wavi |
+|------|------|
+| Completar `pyproject.toml` | Revisar su pyproject.toml |
+| Escribir README.md | Alinear README con misma estructura |
+| Crear `docs/boarding.html` | Crear su boarding.html |
+| Tests del driver | Tests de su driver |
+| Publicar a Test PyPI → PyPI | Publicar a Test PyPI → PyPI |
+| PR en Pulpo: usar `pip install teli` | PR en Pulpo: usar `pip install wavi` |
+
+---
+
+*Generado por Teli — esperando respuesta de Wavi para coordinar.*

teli_lib-0.1.0/README.md

@@ -0,0 +1,104 @@
+# teli — Telegram bot toolkit
+
+**teli** is a Python library and CLI for managing Telegram bots: named connections, async long-polling, message handlers, and a wavi-compatible driver interface for drop-in use alongside WhatsApp automation.
+
+## Install
+
+```bash
+pip install teli
+# with user-client support (Telethon):
+pip install "teli[user]"
+```
+
+## Quick start — CLI
+
+```bash
+# Register a bot
+teli add mybot --token 123456:ABC...
+
+# Discover your chat_id (send /start to the bot, look at output)
+teli listen mybot
+
+# Lock down allowed chats
+teli update mybot --allow 987654321
+
+# Send a message
+teli send mybot 987654321 "Hello from teli!"
+```
+
+## Quick start — Python
+
+```python
+from teli.bot import Bot
+
+async with Bot.from_connection("mybot") as bot:
+    await bot.send_message(987654321, "Hello!")
+```
+
+Long-polling daemon with handlers:
+
+```python
+bot = Bot.from_connection("mybot")
+
+@bot.on_command("start")
+async def handle_start(msg):
+    await bot.send_message(msg["chat"]["id"], "Hi! I'm running on teli.")
+
+await bot.start()
+# ... keep alive ...
+await bot.stop()
+```
+
+## Driver interface (wavi-compatible)
+
+`teli.driver` exposes the same 7-function interface as `wavi_driver`, so Pulpo and other orchestrators can treat Telegram and WhatsApp interchangeably:
+
+```python
+import teli.driver as td
+
+await td.connect("mybot")                          # start bot
+await td.send("mybot", "987654321", "Hola!")       # contact = chat_id
+print(await td.status("mybot"))                    # {"daemon_running": True, ...}
+print(td.list_session_names())                     # ["mybot"]
+await td.stop("mybot")
+```
+
+| Function | Returns | Notes |
+|---|---|---|
+| `connect(session, new)` | `{"ok": bool, "qr_page": None, ...}` | `new` is a no-op (no QR for bots) |
+| `check_updates(session)` | `{"status": "ok", "new_inbound": []}` | no-op — Telegram is push |
+| `send(session, contact, text)` | `{"ok": bool, ...}` | `contact` = chat_id |
+| `status(session)` | `{"daemon_running": bool, "authenticated": bool, ...}` | |
+| `list_session_names()` | `list[str]` | sync |
+| `stop(session)` | `{"ok": bool, ...}` | |
+| `daemon_running_by_pid(session)` | `bool` | sync |
+
+## Named connections
+
+Connections are stored in `data/connections.json` (or `$TELI_DATA_DIR/connections.json`):
+
+```json
+{
+  "connections": [
+    {
+      "name": "mybot",
+      "token": "123456:ABC...",
+      "allowed_chats": ["987654321"]
+    }
+  ]
+}
+```
+
+## User client (Telethon)
+
+The optional `[user]` extra enables a user-account listener (receive messages sent to your bot from your own Telegram account):
+
+```bash
+teli user setup mybot --api-id 12345 --api-hash abc123 --bot-username mybotname
+teli user connect mybot
+teli user listen mybot
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

teli_lib-0.1.0/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "teli-lib"
+version = "0.1.0"
+description = "Telegram bot toolkit: named connections, long-polling, send/receive, and a wavi-compatible driver"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+authors = [
+    {name = "José Tabuyo", email = "josetabuyo@gmail.com"},
+]
+keywords = ["telegram", "bot", "long-polling", "cli", "driver", "automation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.27",
+    "click>=8.1",
+    "python-dotenv>=1.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/josetabuyo/teli"
+Source = "https://github.com/josetabuyo/teli"
+Issues = "https://github.com/josetabuyo/teli/issues"
+
+[project.optional-dependencies]
+user = [
+    "telethon>=1.36",
+]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.8",
+]
+
+[project.scripts]
+teli = "teli.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["teli"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+target-version = "py311"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP"]
+ignore = ["E501"]

teli_lib-0.1.0/session/inject.log

@@ -0,0 +1,19 @@
+[2026-06-18 19:42:03.676] name=Teli source=raw tty=/dev/ttys015 len=11 delay=0.072s status=OK stdout='ok|sessions=16' stderr='' msg='!las widget'
+[2026-06-19 14:48:15.144] name=Teli source=raw tty=/dev/ttys015 len=6 delay=0.062s status=OK stdout='ok|sessions=21' stderr='' msg='/clear'
+[2026-06-19 14:48:23.835] name=Teli source=voice tty=/dev/ttys015 len=49 delay=0.148s status=OK stdout='ok|sessions=21' stderr='' msg='[Widget Voice]: Manu Baria cost of the project of'
+[2026-06-19 15:46:57.601] name=Teli source=voice tty=/dev/ttys015 len=257 delay=0.564s status=OK stdout='ok|sessions=21' stderr='' msg='[Widget Voice]: Kiran opinion in Punjabi serial Itna applica…'
+[2026-06-19 15:47:17.043] name=Teli source=voice tty=/dev/ttys015 len=35 delay=0.12s status=OK stdout='ok|sessions=21' stderr='' msg='[Widget Voice]: Ahora sí en español'
+[2026-06-19 15:58:24.925] name=Teli source=raw tty=/dev/ttys015 len=6 delay=0.062s status=OK stdout='ok|sessions=21' stderr='' msg='/clear'
+[2026-06-19 15:58:31.891] name=Teli source=voice tty=/dev/ttys015 len=51 delay=0.152s status=OK stdout='ok|sessions=21' stderr='' msg='[Widget Voice]: Me escuchas bien dime OK y continúa'
+[2026-06-19 21:10:14.643] name=Teli source=raw tty=/dev/ttys015 len=11 delay=0.072s status=OK stdout='ok|sessions=21' stderr='' msg='!las widget'
+[2026-06-25 09:47:09.950] name=Teli source=voice tty=/dev/ttys011 len=149 delay=0.348s status=OK stdout='ok|sessions=12' stderr='' msg='[Widget Voice]: Manda un mensaje a Loarce para preguntar si …'
+[2026-06-25 11:36:51.725] name=Teli source=voice tty=/dev/ttys011 len=134 delay=0.318s status=OK stdout='ok|sessions=12' stderr='' msg='[Widget Voice]: Quién es el creador de Lugano quiero que le …'
+[2026-06-26 10:11:48.181] name=Teli source=raw tty=/dev/ttys011 len=6 delay=0.062s status=OK stdout='ok|sessions=12' stderr='' msg='/clear'
+[2026-06-26 10:14:41.754] name=Teli source=agent tty=/dev/ttys011 len=1997 delay=1.0s status=OK stdout='ok|sessions=12' stderr='' msg='[Message from Pulpo]: Hola Teli, soy Pulpo — tu cliente más …'
+[2026-06-26 10:26:50.588] name=Teli source=agent tty=/dev/ttys011 len=1335 delay=1.0s status=OK stdout='ok|sessions=12' stderr='' msg='[Message from Wavi]: Hola Teli, soy Wavi — acá los resultado…'
+[2026-06-26 10:31:35.254] name=Teli source=agent tty=/dev/ttys011 len=1475 delay=1.0s status=OK stdout='ok|sessions=12' stderr='' msg='[Message from Wavi]: Wavi acá — revisé Pulpo a fondo.  ## ge…'
+[2026-06-26 10:33:03.859] name=Teli source=agent tty=/dev/ttys011 len=2742 delay=1.0s status=OK stdout='ok|sessions=12' stderr='' msg='[Message from Wavi]: Wavi — leí wavi_poller.py entero. Hagám…'
+[2026-06-26 11:14:21.382] name=Teli source=agent tty=/dev/ttys011 len=586 delay=1.0s status=OK stdout='ok|sessions=12' stderr='' msg='[Message from Wavi]: Wavi está en TestPyPI — wavi 0.2.0 publ…'
+[2026-06-26 11:15:17.425] name=Teli source=agent tty=/dev/ttys011 len=347 delay=0.744s status=OK stdout='ok|sessions=12' stderr='' msg='[Message from Wavi]: Teli 0.1.0 publicado en TestPyPI — los …'
+[2026-06-26 11:15:50.607] name=Teli source=agent tty=/dev/ttys011 len=562 delay=1.0s status=OK stdout='ok|sessions=12' stderr='' msg="[Message from Wavi]: Teli — nombre rechazado en TestPyPI: 't…"
+[2026-06-26 11:38:30.325] name=Teli source=agent tty=/dev/ttys011 len=1190 delay=1.0s status=OK stdout='ok|sessions=12' stderr='' msg='[Message from Wavi]: Teli — respondo con hechos exactos.  1.…'

teli_lib-0.1.0/teli/__init__.py

@@ -0,0 +1,6 @@
+"""teli — Telegram bot toolkit."""
+
+from teli.bot import Bot
+
+__all__ = ["Bot"]
+__version__ = "0.1.0"