feat(tools): add HumanTool for human intervention during workflows

[matiasmolinas]

Human intervention abstraction - Step 1

Description:
Step 1: Define the 'HumanTool' as a tool which can be equipped to any Bee and be invoked by it when it deems there is some missing information required for the following steps and hence must call out to the user to collect it. So I agree with you on the following:

Tool Name: 'HumanTool'
Tool Input: For a Bee to use this tool, it should generate a NL message asking the user for some specific information.
Tool Output: NL response from the end user
BeeAgentRunner 'HumanTool' Execution: The Runner should then execute the HumanTool by sending the NL message to the end user and wait for a response. Once the user has responded, the tool output (message from the user) is appended to the Agent memory and the loop for Action and ActionInput can continue

Closes: #121

Description

This Pull Request introduces the HumanTool to the Bee Agent Framework as part of Step 1 of the issue: Human intervention abstraction - enhancement. The tool enables Bees to interact with users during workflows to gather additional information.

Changes

1. Added HumanTool (src/tools/human.ts):

   • Implements a tool to handle user input during workflows.
   • Provides natural language (NL) input and output support.

2. Extended Bee Prompts (src/agents/bee/prompts.ts):

   • Includes prompts for the HumanTool to integrate seamlessly with Bees.

3. Added Helper for Console Interaction (src/helpers/io.ts):

   • Provides shared console reading functionality for tools like HumanTool.

4. Created an Experimental Agent (examples/agents/experimental/humantool_agent.ts):

   • Demonstrates the usage of HumanTool in a real-world workflow scenario.

Checklist

• I have read the contributor guide
• Linting passes: yarn lint or yarn lint:fix
• Formatting is applied: yarn format or yarn format:fix
• Unit tests pass: yarn test:unit
• E2E tests pass: yarn test:e2e
• Tests are included
• Documentation is changed or added
• Commit messages and PR title follow conventional commits

[matiasmolinas]

Fixing code formatting issues for consistency and readability

[matiasmolinas]

There is a complex merge and an issue in one commit message that is difficult to fix. I will take the latest files, create a new branch called fresh-human-tool-new, and open a new PR.