feat(telegram): streaming response via sendMessageDraft for private chats

.codex/config.toml

@@ -0,0 +1 @@
+commit_attribution = "Codex(gpt-5.3-codex) <noreply@openai.com>"

.gitignore

@@ -19,4 +19,6 @@ __pycache__/
 poetry.lock
 .pytest_cache/
 botpy.log
-tests/
+*.pem
+.DS_Store
+.tmp_home/

AGENTS.md

@@ -0,0 +1,62 @@
+# CLAUDE.md
+
+## 项目简介
+
+nanobot — 超轻量个人 AI 助手框架，核心代码约 3,500 行。Python 3.11+，MIT 协议。
+
+配置文件：`~/.nanobot/config.json`，工作区：`~/.nanobot/workspace/`
+
+## 全局命令
+
+- 每次功能变更、bug 修复、代码合并等都采用 SDD，在 `specs/` 下新增/维护对应规格文档，命名统一为 `YYYY-MM-DD_描述`。
+
+## 常用命令
+
+```bash
+# 安装
+pip install -e .
+pip install -e ".[dev]"
+
+# 运行
+nanobot agent -m "..."     # 单条消息
+nanobot agent              # 交互式对话
+nanobot gateway            # 启动所有渠道
+nanobot status             # 查看配置状态
+
+# 测试 & 检查
+pytest
+ruff check nanobot/
+ruff format nanobot/
+```
+
+## 代码规范
+
+- 全异步：所有 I/O 使用 `async`/`await`
+- Tool 返回错误字符串，不抛异常
+- 日志用 `loguru`（`from loguru import logger`）
+- Ruff：line-length 100, target py311, select E/F/I/N/W, ignore E501
+- pytest：`asyncio_mode = "auto"`
+- 构建系统：hatchling
+
+## 核心架构
+
+```
+Channel → InboundMessage → MessageBus → AgentLoop → LLM + Tools 循环 → OutboundMessage → Channel
+```
+
+关键模块：
+- `agent/loop.py` — 主循环，接收消息、构建上下文、调用 LLM、执行工具
+- `agent/context.py` — 组装 system prompt（身份 → bootstrap 文件 → 记忆 → 技能）
+- `agent/memory.py` — 记忆管理，日记在 `memory/daily/YYYY-MM-DD.md`，长期记忆在 `MEMORY.md`
+- `agent/skills.py` — 技能发现与加载（内置 `nanobot/skills/` + 用户 `~/.nanobot/workspace/skills/`）
+- `agent/tools/` — 工具系统，继承 `Tool` 基类，实现 `name`/`description`/`parameters`/`execute()`
+- `channels/` — 渠道适配，继承 `BaseChannel`，实现 `start()`/`stop()`/`send()`
+- `providers/` — LLM 提供商，基于 LiteLLM，`ProviderSpec` 自动路由
+- `config/schema.py` — Pydantic v2 配置模型
+
+## 扩展方式
+
+- **添加工具**：创建 `agent/tools/xxx.py` 继承 `Tool`，在 `AgentLoop._register_default_tools()` 注册
+- **添加技能**：创建 `nanobot/skills/xxx/SKILL.md`（YAML frontmatter + markdown 指令）
+- **添加渠道**：创建 `channels/xxx.py` 继承 `BaseChannel`，在 `config/schema.py` 加配置
+- **添加提供商**：在 `providers/registry.py` 加 `ProviderSpec`，在 `config/schema.py` 加配置

CLAUDE.md

@@ -0,0 +1,58 @@
+# CLAUDE.md
+
+## 项目简介
+
+nanobot — 超轻量个人 AI 助手框架，核心代码约 3,500 行。Python 3.11+，MIT 协议。
+
+配置文件：`~/.nanobot/config.json`，工作区：`~/.nanobot/workspace/`
+
+## 常用命令
+
+```bash
+# 安装
+pip install -e .
+pip install -e ".[dev]"
+
+# 运行
+nanobot agent -m "..."     # 单条消息
+nanobot agent              # 交互式对话
+nanobot gateway            # 启动所有渠道
+nanobot status             # 查看配置状态
+
+# 测试 & 检查
+pytest
+ruff check nanobot/
+ruff format nanobot/
+```
+
+## 代码规范
+
+- 全异步：所有 I/O 使用 `async`/`await`
+- Tool 返回错误字符串，不抛异常
+- 日志用 `loguru`（`from loguru import logger`）
+- Ruff：line-length 100, target py311, select E/F/I/N/W, ignore E501
+- pytest：`asyncio_mode = "auto"`
+- 构建系统：hatchling
+
+## 核心架构
+
+```
+Channel → InboundMessage → MessageBus → AgentLoop → LLM + Tools 循环 → OutboundMessage → Channel
+```
+
+关键模块：
+- `agent/loop.py` — 主循环，接收消息、构建上下文、调用 LLM、执行工具
+- `agent/context.py` — 组装 system prompt（身份 → bootstrap 文件 → 记忆 → 技能）
+- `agent/memory.py` — 记忆管理，日记在 `memory/daily/YYYY-MM-DD.md`，长期记忆在 `MEMORY.md`
+- `agent/skills.py` — 技能发现与加载（内置 `nanobot/skills/` + 用户 `~/.nanobot/workspace/skills/`）
+- `agent/tools/` — 工具系统，继承 `Tool` 基类，实现 `name`/`description`/`parameters`/`execute()`
+- `channels/` — 渠道适配，继承 `BaseChannel`，实现 `start()`/`stop()`/`send()`
+- `providers/` — LLM 提供商，基于 LiteLLM，`ProviderSpec` 自动路由
+- `config/schema.py` — Pydantic v2 配置模型
+
+## 扩展方式
+
+- **添加工具**：创建 `agent/tools/xxx.py` 继承 `Tool`，在 `AgentLoop._register_default_tools()` 注册
+- **添加技能**：创建 `nanobot/skills/xxx/SKILL.md`（YAML frontmatter + markdown 指令）
+- **添加渠道**：创建 `channels/xxx.py` 继承 `BaseChannel`，在 `config/schema.py` 加配置
+- **添加提供商**：在 `providers/registry.py` 加 `ProviderSpec`，在 `config/schema.py` 加配置

README.md

@@ -287,13 +287,18 @@ If you prefer to configure manually, add the following to `~/.nanobot/config.jso
 
 **4. Configure**
 
+By default, nanobot ignores all bot-originated messages. To consume other bots' messages, set `allowBotMessages` to `true`.
+Self-messages from this bot and webhook messages are always ignored to prevent loops.
+
 ```json
 {
   "channels": {
     "discord": {
       "enabled": true,
       "token": "YOUR_BOT_TOKEN",
-      "allowFrom": ["YOUR_USER_ID"]
+      "allowFrom": ["YOUR_USER_ID"],
+      "allowBotMessages": true,
+      "allowBotFrom": ["OTHER_BOT_USER_ID"]
     }
   }
 }
@@ -656,8 +661,24 @@ Config file: `~/.nanobot/config.json`
 > - **Groq** provides free voice transcription via Whisper. If configured, Telegram voice messages will be automatically transcribed.
 > - **Zhipu Coding Plan**: If you're on Zhipu's coding plan, set `"apiBase": "https://open.bigmodel.cn/api/coding/paas/v4"` in your zhipu provider config.
 > - **MiniMax (Mainland China)**: If your API key is from MiniMax's mainland China platform (minimaxi.com), set `"apiBase": "https://api.minimaxi.com/v1"` in your minimax provider config.
+> - **Per-provider stream default**: set `"defaultStream": true` (or `false`) inside each provider block.
 > - **VolcEngine Coding Plan**: If you're on VolcEngine's coding plan, set `"apiBase": "https://ark.cn-beijing.volces.com/api/coding/v3"` in your volcengine provider config.
 
+```json
+{
+  "providers": {
+    "openrouter": {
+      "apiKey": "sk-or-v1-xxx",
+      "defaultStream": true
+    },
+    "deepseek": {
+      "apiKey": "sk-xxx",
+      "defaultStream": false
+    }
+  }
+}
+```
+
 | Provider | Purpose | Get API Key |
 |----------|---------|-------------|
 | `custom` | Any OpenAI-compatible endpoint (direct, no LiteLLM) | — |
@@ -896,6 +917,8 @@ MCP tools are automatically discovered and registered on startup. The LLM can us
 | `nanobot provider login openai-codex` | OAuth login for providers |
 | `nanobot channels login` | Link WhatsApp (scan QR) |
 | `nanobot channels status` | Show channel status |
+| `nanobot mcp list` | List configured MCP servers |
+| `nanobot mcp tools` | Connect to MCP servers and list all discovered tools |
 
 Interactive mode exits: `exit`, `quit`, `/exit`, `/quit`, `:q`, or `Ctrl+D`.
 
@@ -916,10 +939,44 @@ nanobot cron remove <job_id>
 
 </details>
 
+<details>
+<summary><b>MCP Servers</b></summary>
+
+nanobot supports [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers, allowing the agent to use external tools dynamically.
+
+```bash
+# List configured MCP servers
+nanobot mcp list
+
+# Connect to all servers and list discovered tools
+nanobot mcp tools
+```
+
+Configure MCP servers in `~/.nanobot/config.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "my-server": {
+        "command": "npx",
+        "args": ["-y", "@example/mcp-server"],
+        "env": {
+          "API_KEY": "xxx"
+        }
+      }
+    }
+  }
+}
+```
+
+Once configured, MCP tools are automatically discovered and registered as `mcp__{server}__{tool_name}` — the agent can call them like any built-in tool.
+</details>
+
 <details>
 <summary><b>Heartbeat (Periodic Tasks)</b></summary>
 
-The gateway wakes up every 30 minutes and checks `HEARTBEAT.md` in your workspace (`~/.nanobot/workspace/HEARTBEAT.md`). If the file has tasks, the agent executes them and delivers results to your most recently active chat channel.
+The gateway wakes up periodically (default: every 30 minutes) and checks `HEARTBEAT.md` in your workspace (`~/.nanobot/workspace/HEARTBEAT.md`). If the file has tasks, the agent executes them and delivers results to your most recently active chat channel.
 
 **Setup:** edit `~/.nanobot/workspace/HEARTBEAT.md` (created automatically by `nanobot onboard`):
 
@@ -932,6 +989,22 @@ The gateway wakes up every 30 minutes and checks `HEARTBEAT.md` in your workspac
 
 The agent can also manage this file itself — ask it to "add a periodic task" and it will update `HEARTBEAT.md` for you.
 
+You can configure heartbeat interval and a dedicated model in `~/.nanobot/config.json`:
+
+```json
+{
+  "gateway": {
+    "heartbeat": {
+      "enabled": true,
+      "intervalS": 900,
+      "model": "openai/gpt-4o-mini"
+    }
+  }
+}
+```
+
+`gateway.heartbeat.model` (when set) is used for both heartbeat decision and heartbeat task execution.
+
 > **Note:** The gateway must be running (`nanobot gateway`) and you must have chatted with the bot at least once so it knows which channel to deliver to.
 
 </details>
@@ -1090,3 +1163,7 @@ PRs welcome! The codebase is intentionally small and readable. 🤗
 <p align="center">
   <sub>nanobot is for educational, research, and technical exchange purposes only</sub>
 </p>
+
+---
+
+🐱 *kaguya was here* - 我的第一个 bot PR