AI Tools Guide
==============

JamesAI comes with powerful tools that help you get things done. Here's what each tool can do for you.

Communication Tools
-------------------

**Gmail Tool**
~~~~~~~~~~~~~~
Send and manage emails directly through Discord.

* **Compose Email** - Draft an email before sending
* **Send Email** - Send emails to anyone
* **List Sent Emails** - View your recently sent messages

*Note: You need to connect your Gmail account first using the OAuth tool.*

**Discord Tool**
~~~~~~~~~~~~~~~~
Interact with Discord channels and messages.

* **Get Channels** - See all channels in your server
* **Send Channel Message** - Post messages to specific channels
* **Search Channel Messages** - Find past messages by keyword

**User Tool**
~~~~~~~~~~~~~
Find and message other users.

* **Search Users** - Find users by name or username (only shows users in your shared servers)
* **Send Discord DM** - Send direct messages to users

Project Management Tools
------------------------

**GitLab Tool**
~~~~~~~~~~~~~~~
Manage your GitLab projects and issues.

* **Search Users** - Find GitLab users
* **Search Projects** - Find projects by name
* **Search Issues** - Find issues with filters (state, labels, assignee, etc.)
* **Search Milestones** - Find project or group milestones
* **Search Groups** - Find GitLab groups
* **Create Issue** - Create new issues with title, description, due date, and assignee
* **Update Issue** - Modify existing issues (title, description, state, assignee, labels, etc.)

*Note: You need to connect your GitLab account first using the OAuth tool.*

**Task Manager Tool**
~~~~~~~~~~~~~~~~~~~~~
Schedule reminders and recurring tasks.

* **List Tasks** - View your active or all tasks
* **Create Task** - Set up one-time or periodic reminders
  
  * One-time: Executes at a specific date/time
  * Periodic: Repeats every X minutes (minimum 60 minutes)
  
* **Delete Task** - Remove tasks you no longer need

*Example: "Remind me about the meeting tomorrow at 2pm" or "Check my holiday balance every Monday"*

Memory & Search Tools
---------------------

**Memory Tool**
~~~~~~~~~~~~~~~
Save information for JamesAI to remember later.

* **Save Memory** - Store information with a key and optional expiration
  
  * Can be user-wide or channel-specific
  * Set expiration dates for temporary info
  
* **Retrieve Memory** - Get saved information by key or context
* **Delete Memory** - Remove stored information

*Example: "Remember my favorite color is blue" or "Save that the project deadline is March 15"*

**Message Search Tool**
~~~~~~~~~~~~~~~~~~~~~~~
Search through your conversation history.

* **Search Message History** - Find past messages by keyword
  
  * Filter by user or AI messages
  * Limit results (up to 50)
  * Searches current channel only

Research & Content Tools
------------------------

**Research Tool**
~~~~~~~~~~~~~~~~~
Search the web for information.

* **Research** - Get search results on any topic (returns top 5 results with titles, URLs, and descriptions)

**Web Scraping Tool**
~~~~~~~~~~~~~~~~~~~~~
Extract content from specific websites.

* **Scrape Website** - Get the full content from a URL (returns title and main content in markdown format)

**LinkedIn Post Tool**
~~~~~~~~~~~~~~~~~~~~~~
Create professional LinkedIn posts.

* **Create Post** - Generate a LinkedIn post with:
  
  * Topic
  * Key points
  * Relevant facts
  * Automatic hashtags

**Meme Tool**
~~~~~~~~~~~~~
Find and share memes.

* **Search Memes** - Find memes by keyword or get random ones (returns up to 10 memes)

Translation & Language Tools
----------------------------

**DeepL Tool**
~~~~~~~~~~~~~~
Translate text between languages.

* **Translate Text** - Translate to any supported language
  
  * Auto-detects source language
  * Supports formality levels
  * Preserves formatting
  
* **Get Supported Languages** - See all available languages

*Supported languages: English, German, French, Spanish, Italian, Japanese, Chinese, and many more*

**Timezone Tool**
~~~~~~~~~~~~~~~~~
Manage your timezone settings.

* **Set Timezone** - Update your timezone (e.g., Europe/Zurich, America/New_York)
* **Get Timezone** - Check your current timezone setting

Specialized Tools
-----------------

**OAuth Tool**
~~~~~~~~~~~~~~
Connect external accounts.

* **Get OAuth Link** - Generate authentication links for:
  
  * GitLab
  * Gmail (Google)
  
* **Disconnect OAuth** - Remove connected accounts

*Links expire in 5 minutes for security*

**Escape Room Tool**
~~~~~~~~~~~~~~~~~~~~
Manage escape room challenges.

* **Start Challenge** - Begin a timed challenge for your team
* **Complete Challenge** - Mark challenge as finished and see your ranking
* **Submit Feedback** - Share what you liked/disliked with optional rating

**Bookkeeping Tool**
~~~~~~~~~~~~~~~~~~~~
Process financial documents.

* **Process Stripe Payout** - Parse Stripe payout PDFs and create invoice entries
  
  * Extracts payout amounts, fees, and dates
  * Creates separate entries for tracking
  * Requires organisation ID

*Note: This tool is for financial administrators*

How to Use Tools
----------------

JamesAI automatically uses the right tool based on your request. Just ask naturally:

* "Send an email to john@example.com about the meeting"
* "Create a GitLab issue for the bug I found"
* "Remind me tomorrow at 3pm to call the client"
* "Remember that my project deadline is next Friday"
* "Search for messages about the budget"
* "Translate this to German"
* "Find me a funny cat meme"

Tips
----

1. **Be specific** - The more details you provide, the better the results
2. **Connect accounts first** - Use OAuth tool for Gmail and GitLab before using those tools
3. **Set your timezone** - Helps with scheduling and time-based tasks
4. **Use memory** - Save important info so you don't have to repeat it
5. **Check permissions** - Some tools require specific Discord or account permissions