Bot Chat Commands

from praisonaiagents import Agent

agent = Agent(name="assistant", instructions="You are a helpful assistant.")
agent.start("What commands are available?")

User Information
User ID: 456
Username: alice
Role: User
Allowed commands: help, status, whoami

Current model: gpt-4o-mini
Use /model <name> to switch (e.g., /model gpt-4o)

/model gpt-4o
✅ Model switched to gpt-4o for this conversation.

/model gpt-4o
⚠️ Gateway code changed on disk since it started (2aa28d1 → def5678). Restart the gateway to apply updates before switching models.

session_manager.code_skew_guard = False

📊 Token Usage
Total: 18,204 tokens
Prompt: 12,800 | Completion: 5,404
Est. cost: $0.0036

✅ Compressed 32 messages, freed ~12,400 tokens.

📌 Recap — where we were:
[Previous conversation summary]
User asked about deploy runbook; we outlined steps 1–3.
Recent:
• user: what about step 4?
• assistant: step 4 covers rollback…

Nothing to recap yet — this session has no messages.

⛔ You are not permitted to run /recap

from praisonaiagents.compaction import build_recap

history = [
    {"role": "user", "content": "Outline the deploy runbook."},
    {"role": "assistant", "content": "Steps 1–3 cover build, test, ship."},
    {"role": "user", "content": "What about step 4?"},
    {"role": "assistant", "content": "Step 4 covers rollback."},
]

print(build_recap(history))

📝 Pending follow-up: summarise the key findings

No follow-up queued. Use /queue <message> to add one while a task is running.

📁 Recent sessions:
• telegram:123456789
• telegram:123456789:project-a

Use /resume <id> to switch to one.

/resume telegram:123456789:project-a
✅ Resumed session telegram:123456789:project-a.

🔁 Retrying your last message:
Summarise the deployment runbook in three bullets.

/reasoning
🧠 Reasoning output will be shown for this conversation.

/reasoning
🙈 Reasoning output will be hidden for this conversation.

/tasks
🧩 Background tasks:
• aa1b2c… research — running (35%)
• ff9d3e… summary  — completed (100%)

Use /tasks <id> for detail or /tasks cancel <id>.

/learn deploy steps from this repo and the runbook PDF

📋 Create an automation from a template:

• morning-brief — Daily morning briefing with news and priorities
• important-mail — Check for important emails at a regular interval
• weekly-review — End-of-week summary and review

Usage: /blueprint <name> [slot=value ...]
Example: /blueprint morning-brief hour=8 weekdays=mon-fri

✅ Automation scheduled from 'morning-brief'. Added job 'morning-brief' (schedule cron:0 8 * * mon,tue,wed,thu,fri)

❌ Blueprint 'unknown' not found. Available: morning-brief, important-mail, weekly-review

from praisonai.bots import TelegramBot
from praisonaiagents import Agent

agent = Agent(name="assistant", instructions="Be helpful")
bot = TelegramBot(token="YOUR_TOKEN", agent=agent)

# Register a custom command
async def handle_ping(message):
    return "Pong! Bot is alive."

bot.register_command("ping", handle_ping, description="Check if bot is alive")

import asyncio
asyncio.run(bot.start())
# Now /ping is available alongside /status, /new, /stop, /help

bot.register_command(
    name="mycommand",           # Command name (without /)
    handler=my_handler,          # Async or sync callable
    description="What it does",  # Shown in /help
    usage="/mycommand <arg>",    # Optional usage string
    channels=["telegram"],       # Optional: restrict to specific platforms
)

commands = bot.list_commands()
# Returns: [ChatCommandInfo(name="status", ...), ChatCommandInfo(name="new", ...), ...]

# Filter by platform
telegram_commands = bot.list_commands(platform="telegram")

---
description: Summarise the current channel
argument-hint: <topic?>
---
Summarise recent messages about $ARGUMENTS.

from praisonai.bots import TelegramBot
from praisonaiagents import Agent

agent = Agent(name="assistant", instructions="Be helpful.")
bot = TelegramBot(token="YOUR_TOKEN", agent=agent)

import asyncio
asyncio.run(bot.start())
# /summary is now available in Telegram — same file also works in `praisonai code`.

User:  /summary Q3 revenue
Bot:   [agent replies with a Q3 revenue summary]

# pyproject.toml
[project.entry-points."praisonai.bot_commands"]
mypkg = "mypkg.bot_commands:commands"

# mypkg/bot_commands.py
commands = {
    "greet": {
        "description": "Say hi",
        "template": "Say hello to $ARGUMENTS.",
        "allow_shell": False,   # optional; safe default
    },
}
# Or expose a zero-argument callable that returns the same dict.

from praisonai.bots import TelegramBot
from praisonaiagents import BotConfig
from praisonaiagents import Agent

agent = Agent(name="assistant", instructions="Be helpful")
bot = TelegramBot(
    token="YOUR_TOKEN",
    agent=agent,
    config=BotConfig(allowed_users=["123456789"]),  # Only this user
)

# /help, /status, /new from any other user are now silently ignored

from praisonai.bots import TelegramBot
from praisonaiagents import Agent

agent = Agent(name="Support", instructions="Answer customer questions.")
bot = TelegramBot(token="YOUR_TOKEN", agent=agent)

import asyncio
asyncio.run(bot.start())  # /-menu appears in Telegram automatically

from praisonai.bots import TelegramBot
from praisonaiagents import Agent

agent = Agent(name="Support", instructions="Answer customer questions.")
bot = TelegramBot(token="YOUR_TOKEN", agent=agent)

async def summary(message):
    return "Latest summary..."

bot.register_command("summary", summary, description="Get the latest summary")

import asyncio
asyncio.run(bot.start())  # /summary appears alongside /status, /model, /usage in the / menu