feat(approval): add env fallbacks, SSL toggles, crash fix, and examples

- Discord: DISCORD_CHANNEL_ID env fallback + PRAISONAI_DISCORD_SSL_VERIFY toggle
- Telegram: TELEGRAM_CHAT_ID env fallback + PRAISONAI_TELEGRAM_SSL_VERIFY toggle
- HTTP: print approval URL to console for better UX
- Webhook: fix str(status).lower() crash on non-JSON responses
- Add examples/approval/ with Slack, Telegram, Discord, HTTP, Agent examples

Co-authored-by: Dhivya-Bharathy <divysarah2261999@gmail.com>

Author: Dhivya-Bharathy

examples/approval/README.md

@@ -0,0 +1,31 @@
+# Approval Examples
+
+Minimal examples showing how to route tool-execution approvals through
+different backends.
+
+## Quick Start
+
+```bash
+pip install praisonaiagents praisonai[bot]
+export OPENAI_API_KEY=sk-...
+```
+
+| Backend  | Script               | Extra env vars                                   |
+|----------|-----------------------|--------------------------------------------------|
+| Slack    | `slack_approval.py`   | `SLACK_BOT_TOKEN`, `SLACK_CHANNEL`               |
+| Telegram | `telegram_approval.py`| `TELEGRAM_BOT_TOKEN`, `TELEGRAM_CHAT_ID`         |
+| Discord  | `discord_approval.py` | `DISCORD_BOT_TOKEN`, `DISCORD_CHANNEL_ID`        |
+| HTTP     | `http_approval.py`    | *(none — opens a local web dashboard)*           |
+| Agent    | `agent_approval.py`   | *(none — AI reviewer agent decides)*             |
+
+## SSL Verification
+
+For corporate proxy / CA issues, Discord and Telegram backends support
+optional SSL bypass:
+
+```bash
+export PRAISONAI_DISCORD_SSL_VERIFY=false
+export PRAISONAI_TELEGRAM_SSL_VERIFY=false
+```
+
+Default is `true` (secure).

examples/approval/agent_approval.py

@@ -0,0 +1,26 @@
+"""
+Agent Approval Example
+======================
+Uses an AI agent as an automated reviewer to approve/deny tool calls.
+
+Requires:
+    pip install praisonaiagents
+    export OPENAI_API_KEY=sk-...
+"""
+
+from praisonaiagents import Agent
+from praisonaiagents.approval import AgentApproval
+from praisonaiagents.tools.shell_tools import execute_command
+
+reviewer = AgentApproval(
+    instructions="Only approve read-only commands like 'ls' or 'cat'. Deny destructive commands.",
+)
+
+agent = Agent(
+    name="DevOps",
+    instructions="You are a DevOps assistant. Use shell tools when asked.",
+    tools=[execute_command],
+    approval=reviewer,
+)
+
+agent.start("List files in the current directory")

examples/approval/discord_approval.py

@@ -0,0 +1,24 @@
+"""
+Discord Approval Example
+========================
+Routes tool approvals to a Discord channel.
+
+Requires:
+    pip install praisonaiagents praisonai[bot]
+    export DISCORD_BOT_TOKEN=MTIz...
+    export DISCORD_CHANNEL_ID=1234567890
+    export OPENAI_API_KEY=sk-...
+"""
+
+from praisonaiagents import Agent
+from praisonaiagents.tools.shell_tools import execute_command
+from praisonai.bots import DiscordApproval
+
+agent = Agent(
+    name="DevOps",
+    instructions="You are a DevOps assistant. Use shell tools when asked.",
+    tools=[execute_command],
+    approval=DiscordApproval(),
+)
+
+agent.start("List files in the current directory")

examples/approval/http_approval.py

@@ -0,0 +1,22 @@
+"""
+HTTP Approval Example
+=====================
+Opens a local web dashboard for tool approvals.
+
+Requires:
+    pip install praisonaiagents praisonai[bot]
+    export OPENAI_API_KEY=sk-...
+"""
+
+from praisonaiagents import Agent
+from praisonaiagents.tools.shell_tools import execute_command
+from praisonai.bots import HTTPApproval
+
+agent = Agent(
+    name="DevOps",
+    instructions="You are a DevOps assistant. Use shell tools when asked.",
+    tools=[execute_command],
+    approval=HTTPApproval(),
+)
+
+agent.start("List files in the current directory")

examples/approval/slack_approval.py

@@ -0,0 +1,24 @@
+"""
+Slack Approval Example
+======================
+Routes tool approvals to a Slack channel.
+
+Requires:
+    pip install praisonaiagents praisonai[bot]
+    export SLACK_BOT_TOKEN=xoxb-...
+    export SLACK_CHANNEL=C0123456789
+    export OPENAI_API_KEY=sk-...
+"""
+
+from praisonaiagents import Agent
+from praisonaiagents.tools.shell_tools import execute_command
+from praisonai.bots import SlackApproval
+
+agent = Agent(
+    name="DevOps",
+    instructions="You are a DevOps assistant. Use shell tools when asked.",
+    tools=[execute_command],
+    approval=SlackApproval(),
+)
+
+agent.start("List files in the current directory")

examples/approval/telegram_approval.py

@@ -0,0 +1,24 @@
+"""
+Telegram Approval Example
+=========================
+Routes tool approvals to a Telegram chat.
+
+Requires:
+    pip install praisonaiagents praisonai[bot]
+    export TELEGRAM_BOT_TOKEN=123456:ABC-...
+    export TELEGRAM_CHAT_ID=987654321
+    export OPENAI_API_KEY=sk-...
+"""
+
+from praisonaiagents import Agent
+from praisonaiagents.tools.shell_tools import execute_command
+from praisonai.bots import TelegramApproval
+
+agent = Agent(
+    name="DevOps",
+    instructions="You are a DevOps assistant. Use shell tools when asked.",
+    tools=[execute_command],
+    approval=TelegramApproval(),
+)
+
+agent.start("List files in the current directory")

src/praisonai/praisonai/bots/_discord_approval.py

@@ -66,9 +66,13 @@ def __init__(
             raise ValueError(
                 "Discord bot token is required. Pass token= or set DISCORD_BOT_TOKEN env var."
             )
-        self._channel_id = channel_id or ""
+        self._channel_id = channel_id or os.environ.get("DISCORD_CHANNEL_ID", "")
         self._timeout = timeout
         self._poll_interval = poll_interval
+        # Optional: set PRAISONAI_DISCORD_SSL_VERIFY=false to skip SSL verify
+        # (e.g. corporate proxy / CA issues)
+        _v = os.environ.get("PRAISONAI_DISCORD_SSL_VERIFY", "true").lower()
+        self._ssl_verify = _v not in ("false", "0", "no")
 
     def __repr__(self) -> str:
         masked = f"...{self._token[-4:]}" if len(self._token) > 4 else "***"
@@ -109,7 +113,9 @@ async def _do_request(s):
         if session is not None:
             return await _do_request(session)
         else:
-            async with aiohttp.ClientSession() as _session:
+            async with aiohttp.ClientSession(
+                connector=aiohttp.TCPConnector(ssl=self._ssl_verify),
+            ) as _session:
                 return await _do_request(_session)
 
     # ── ApprovalProtocol implementation ─────────────────────────────────
@@ -126,7 +132,9 @@ async def request_approval(self, request) -> Any:
                 reason="No Discord channel_id configured",
             )
 
-        async with aiohttp.ClientSession() as session:
+        async with aiohttp.ClientSession(
+            connector=aiohttp.TCPConnector(ssl=self._ssl_verify),
+        ) as session:
             # 1. Post approval embed
             embed = self._build_embed(request)
             content = self._build_fallback_text(request)
@@ -349,7 +357,9 @@ async def _update_message(
                 ) as resp:
                     data = await resp.json()
             else:
-                async with aiohttp.ClientSession() as _session:
+                async with aiohttp.ClientSession(
+                    connector=aiohttp.TCPConnector(ssl=self._ssl_verify),
+                ) as _session:
                     async with _session.patch(
                         url, headers=headers, json=payload,
                         timeout=aiohttp.ClientTimeout(total=10),

src/praisonai/praisonai/bots/_http_approval.py

@@ -206,6 +206,7 @@ async def request_approval(self, request) -> Any:
 
         url = f"http://{self._host}:{self._port}/approve/{request_id}"
         logger.info(f"HTTPApproval: Waiting for decision at {url}")
+        print(f"\n🔗 Open this URL to approve/deny:\n   {url}\n")
 
         # Poll for decision
         deadline = time.monotonic() + self._timeout

src/praisonai/praisonai/bots/_telegram_approval.py

@@ -64,9 +64,13 @@ def __init__(
             raise ValueError(
                 "Telegram bot token is required. Pass token= or set TELEGRAM_BOT_TOKEN env var."
             )
-        self._chat_id = chat_id or ""
+        self._chat_id = chat_id or os.environ.get("TELEGRAM_CHAT_ID", "")
         self._timeout = timeout
         self._poll_interval = poll_interval
+        # Optional: set PRAISONAI_TELEGRAM_SSL_VERIFY=false to skip SSL verify
+        # (e.g. corporate proxy / CA issues)
+        _v = os.environ.get("PRAISONAI_TELEGRAM_SSL_VERIFY", "true").lower()
+        self._ssl_verify = _v not in ("false", "0", "no")
 
     def __repr__(self) -> str:
         masked = f"...{self._token[-4:]}" if len(self._token) > 4 else "***"
@@ -91,7 +95,9 @@ async def _telegram_api(
             ) as resp:
                 return await resp.json()
         else:
-            async with aiohttp.ClientSession() as _session:
+            async with aiohttp.ClientSession(
+                connector=aiohttp.TCPConnector(ssl=self._ssl_verify),
+            ) as _session:
                 async with _session.post(
                     url, json=payload,
                     timeout=aiohttp.ClientTimeout(total=15),
@@ -112,7 +118,9 @@ async def request_approval(self, request) -> Any:
                 reason="No Telegram chat_id configured",
             )
 
-        async with aiohttp.ClientSession() as session:
+        async with aiohttp.ClientSession(
+            connector=aiohttp.TCPConnector(ssl=self._ssl_verify),
+        ) as session:
             # 1. Send approval message with inline keyboard
             text = self._build_message_text(request)
             keyboard = self._build_inline_keyboard(request)

src/praisonai/praisonai/bots/_webhook_approval.py

@@ -215,7 +215,9 @@ async def _poll_for_decision(
                     continue
 
                 # Check if decision is available
-                status = data.get("status", "").lower()
+                # (status may be int from HTTP status when response isn't JSON)
+                status = data.get("status", "")
+                status = str(status).lower() if status is not None else ""
                 if status == "pending":
                     continue