Message Tool

{
  "tool": "message",
  "parameters": {
    "content": "Your analysis is complete. Found 42 items matching the criteria."
  }
}

messageTool.SetContext("telegram", "123456789")

{
  "tool": "message",
  "parameters": {
    "content": "Alert: System maintenance in 5 minutes",
    "channel": "telegram",
    "chat_id": "987654321"
  }
}

if messageTool.HasSentInRound() {
    // Message was sent during this round
}

type SendCallback func(channel, chatID, content string) error

messageTool.SetSendCallback(func(channel, chatID, content string) error {
    return sendToChannel(channel, chatID, content)
})

{
  "error": "content is required"
}

{
  "error": "No target channel/chat specified"
}

{
  "error": "Message sending not configured"
}

{
  "error": "sending message: connection timeout"
}

{
  "tool": "message",
  "parameters": {
    "content": "Step 1/3 complete: Data collected (2.5 GB)"
  }
}

{
  "tool": "message",
  "parameters": {
    "content": "✅ Analysis complete!\n\nResults:\n- Total items: 156\n- Errors: 3\n- Duration: 2m 30s"
  }
}

{
  "tool": "message",
  "parameters": {
    "content": "⚠️ Warning: Disk space low (5% remaining)"
  }
}

[
  {
    "tool": "message",
    "parameters": {
      "content": "Deployment starting...",
      "chat_id": "user1"
    }
  },
  {
    "tool": "message",
    "parameters": {
      "content": "Deployment starting...",
      "chat_id": "user2"
    }
  }
]

// ✅ Good - Structured formatting
{
  "content": "Analysis Complete\n\nResults:\n- Items: 42\n- Errors: 0\n- Time: 1m 30s"
}

// ❌ Avoid - Wall of text
{
  "content": "Analysis complete found 42 items no errors took 1 minute 30 seconds"
}

// ✅ Good
{
  "content": "Database backup completed at 02:30 AM\nSize: 2.5 GB\nLocation: /backups/2024-03-15.sql.gz"
}

// ❌ Avoid
{
  "content": "Backup done"
}

// ✅ Good
{
  "content": "✅ Build successful\n⚠️ 3 warnings"
}

// ❌ Avoid
{
  "content": "🎉🎊✨ Build successful! 🚀💯🔥"
}

func sendWithRetry(channel, chatID, content string) error {
    for i := 0; i < 3; i++ {
        if err := sendToChannel(channel, chatID, content); err == nil {
            return nil
        }
        time.Sleep(time.Second * time.Duration(i+1))
    }
    return errors.New("failed after 3 retries")
}

messageTool.SetSendCallback(sendWithRetry)

// Cron job sends message at scheduled time
job.Payload.Message = "Daily report ready"
job.Payload.Deliver = true

// Subagent reports completion via message
spawnTool.SetCallback(func(result string) {
    messageTool.Execute(ctx, map[string]any{
        "content": fmt.Sprintf("Subagent completed: %s", result),
    })
})