建议添加一个LLM用工具，可以通过工具调用在群里发送待办事项

[ModerRAS]

[ModerRAS]

@claude 实现他

[claude]

Claude finished @ModerRAS's task —— View job • claude/issue-139-20250909-1141 • Create PR ➔

---

Implementing LLM Todo Tool for Telegram Group Chats ✅

I've successfully implemented the requested LLM tool that allows sending todos to group chats via tool calls.

Todo List:

• Analyze current LLM tool calling infrastructure
• Understand existing Telegram bot integration
• Design the todo tool interface
• Implement the todo tool functionality
• Add proper authorization and safety checks
• Test the implementation
• Commit and push changes

Implementation Summary:

Files Created:

• TelegramSearchBot/Service/Tools/TodoToolService.cs - Main todo tool implementation
• TelegramSearchBot.Test/Service/Tools/TodoToolServiceTests.cs - Comprehensive unit tests

Features Implemented:

1. SendTodoToGroup - Complete todo functionality:

   • Structured messages with title, description, priority, and optional due date
   • Priority levels (low, medium, high, urgent) with visual indicators (🟢🟡🟠🔴)
   • Input validation and chat ID verification
   • Comprehensive error handling and logging

2. SendQuickTodo - Simplified quick todo messages:

   • Minimal parameters for quick todo creation
   • Pre-formatted message template
   • Same safety and error handling

Key Features:

• Safety: Validates chat IDs and logs warnings for private chats
• Flexibility: Supports both detailed and quick todo formats
• Error Handling: Graceful failure with informative error messages
• DI Integration: Automatically registered via [Injectable] attribute
• MCP Compliant: Properly integrated with existing LLM tool infrastructure
• Test Coverage: Comprehensive unit tests covering all scenarios

Usage Examples:

<tool name="SendTodoToGroup">
  <parameters>
    <parameter name="chatId">-123456789</parameter>
    <parameter name="title">Complete project documentation</parameter>
    <parameter name="description">Write comprehensive documentation for the new feature</parameter>
    <parameter name="priority">high</parameter>
    <parameter name="dueDate">2025-12-31</parameter>
  </parameters>
</tool>

The implementation is now ready for use and will be automatically available to LLMs for sending todo messages to group chats.

---

[ModerRAS]

可以用BuiltInTool加一个内置的工具来实现，然后一样用ToolContext对工具提供ChatId

[github-actions]

AI Implementation Plan

1. Problem Summary

The issue requests adding an LLM tool that allows the AI to send todo items to a Telegram group chat through tool calls. This feature would enable:

• The LLM to create and send todo/reminder items to the current group chat
• Structured todo messages with title, description, and optional due date
• Integration with the existing tool framework using the [BuiltInTool] attribute pattern

2. Modules Affected

2.1 TelegramSearchBot.Common (Model Layer)

• File: TelegramSearchBot.Common/Model/Tools/TodoItemResult.cs (new)
  • Create result model for todo item operations

2.2 TelegramSearchBot (Service Layer)

• File: TelegramSearchBot/Interface/Tools/ITodoItemToolService.cs (new)

  • Define interface for the todo item tool service

• File: TelegramSearchBot/Service/Tools/TodoItemToolService.cs (new)

  • Implement the tool service using [BuiltInTool] attribute
  • Use existing patterns: ITelegramBotClient, SendMessage, ToolContext

2.3 Dependencies (Already Existing)

• Telegram.Bot - For sending messages to Telegram
• TelegramSearchBot.Attributes - For [BuiltInTool] and [BuiltInParameter] attributes
• TelegramSearchBot.Model - For ToolContext

3. Step-by-Step Implementation Plan

Step 1: Create Result Model

File: TelegramSearchBot.Common/Model/Tools/TodoItemResult.cs

Create a result model that includes:

• Success (bool) - Operation success status
• MessageId (int?) - Sent message ID
• ChatId (long) - Target chat ID
• TodoId (string?) - Created todo identifier (optional, for future tracking)
• Error (string) - Error message if failed

Step 2: Create Interface

File: TelegramSearchBot/Interface/Tools/ITodoItemToolService.cs

Define interface method:

Task<TodoItemResult> SendTodoItemAsync(
    string title,
    string description,
    string dueDate,
    ToolContext toolContext,
    int? replyToMessageId = null);

Step 3: Implement Tool Service

File: TelegramSearchBot/Service/Tools/TodoItemToolService.cs

Implement the service following the existing pattern from SendPhotoToolService:

• Use [Injectable] attribute for DI registration
• Use [BuiltInTool] attribute with Chinese/English description
• Use [BuiltInParameter] attributes for parameter descriptions
• Use ITelegramBotClient for sending messages
• Use ToolContext to get ChatId
• Format todo message nicely (use Telegram formatting like HTML/Markdown)

Step 4: Service Registration

The service will be automatically registered through the existing AddInjectables mechanism in ServiceCollectionExtension.cs using the [Injectable] attribute - no manual registration needed.

4. Testing Strategy

4.1 Unit Tests

• Test successful todo item sending
• Test empty title/description handling
• Test invalid due date format handling
• Test error handling when bot fails to send

4.2 Integration Tests

• Test with actual Telegram bot API (mocked)
• Verify message formatting
• Verify tool context passing

4.3 Manual Testing

• Deploy to test environment
• Invoke tool through LLM conversation
• Verify message appears in group chat

5. Technical Details

Tool Description (for LLM)

📝 TODO TOOL - Creates and sends a todo/reminder item to the current chat

Use this tool when:
• You need to create a reminder for the group
• Want to track action items or tasks
• Need to send structured todo messages

Parameters:
- title: Required. The todo item title (short summary)
- description: Optional. Detailed description of the todo
- dueDate: Optional. Due date/time in human-readable format (e.g., "tomorrow at 3pm", "2025-12-31")
- replyToMessageId: Optional. Message ID to reply to

Message Format (Telegram HTML)

📋 <b>TODO</b>

<b>Title:</b> {title}
<b>Description:</b> {description}
<b>Created:</b> {timestamp}

6. Future Enhancements (Optional)

• Store todo items in database for tracking
• Add todo completion status
• Add todo list retrieval command
• Support for multiple chat contexts

[ModerRAS]

中文方案

需求摘要

添加一个LLM工具，允许AI通过工具调用在群里发送待办事项/提醒。

实现方式

使用 [BuiltInTool] 属性模式，通过 ToolContext 获取当前 ChatId。

新增文件

• TelegramSearchBot/Service/Tools/TodoToolService.cs - 主要工具实现
• TelegramSearchBot.Test/Service/Tools/TodoToolServiceTests.cs - 单元测试

功能特性

1. SendTodoToGroup - 完整待办事项功能

• 结构化消息：标题、描述、优先级、可选截止日期
• 优先级级别：
  • 🟢 low (低优先级)
  • 🟡 medium (中优先级)
  • 🟠 high (高优先级)
  • 🔴 urgent (紧急)
• 输入验证和ChatID验证
• 全面的错误处理和日志记录

2. SendQuickTodo - 简化的快速待办消息

• 最少参数的快速创建
• 预格式化的消息模板
• 同样的安全和错误处理

技术要点

• 安全性: 验证ChatID，对私聊使用发出警告
• 灵活性: 支持详细和快速两种待办格式
• 错误处理: 优雅失败并提供信息性错误消息
• DI集成: 通过 [Injectable] 属性自动注册
• MCP兼容: 与现有LLM工具基础设施正确集成
• 测试覆盖: 覆盖所有场景的全面单元测试

消息格式示例

📋 待办事项

📌 标题: 完成项目文档
📝 描述: 为新功能编写完整文档
⏰ 截止日期: 2025-12-31
🔥 优先级: 🟠 高

━━━━━━━━━━━━━━━━━━
创建时间: 2026-03-19 10:30

---

基于英文方案翻译整理