Skip to content

tools.md

Latest commit

 

History

History
82 lines (67 loc) · 4.35 KB

tools.md

File metadata and controls

82 lines (67 loc) · 4.35 KB

Tools Reference

Complete catalog of Hexis tools organized by category.

Tool Categories

Category Factory Function Tools
Memory create_memory_tools() recall, remember, sense_memory_availability, explore_concept, get_procedures, get_strategies, queue_user_message, + type-specific creators
Web create_web_tools() web_search, web_fetch, web_summarize
Filesystem create_filesystem_tools() read_file, write_file, edit_file, glob, grep, list_directory
Shell create_shell_tools() shell, safe_shell, run_script
Code create_code_execution_tools() code_execution
Browser create_browser_tools() browser
Calendar create_calendar_tools() calendar_events, calendar_create, calendar_update, calendar_delete, meeting_prep
Email create_email_tools() email_send, email_send_sendgrid, email_list, email_read, email_search, email_forward
Messaging create_messaging_tools() discord_send, slack_send, telegram_send
Contacts create_contact_tools() search_contacts, get_contact, create_contact, update_contact, merge_contacts, ingest_contacts_from_email, ingest_contacts_from_calendar
Ingest create_ingest_tools() fast_ingest, slow_ingest, hybrid_ingest, git_ingest, url_ingest
Goals create_goal_tools() manage_goals
Backlog create_backlog_tools() manage_backlog
Cron create_cron_tools() manage_schedule
Sessions create_session_tools() manage_sessions
Image/Video create_image_gen_tools(), create_video_gen_tools() generate_image, generate_video
Council create_council_tools() list_council_personas, run_council, aggregate_signals
Usage create_usage_tools() query_usage
Backup create_backup_tools() database_backup, backup_retention, config_export, config_import
Humanizer create_humanizer_tools() humanize_text, post_process_output
External Various todoist_, asana_, hubspot_, youtube_, twitter_search, brave_search, firecrawl_scrape, fathom_*
Workflow create_workflow_tools() workflow
Dynamic create_dynamic_tools() create_tool

Energy Cost Table

Cost Tools
0 sense_memory_availability, queue_user_message, get_contact, list_council_personas, manage_sessions (list/get)
1 recall, remember, explore_concept, get_procedures, get_strategies, read_file, glob, grep, list_directory, manage_goals, manage_backlog, manage_schedule, search_contacts, query_usage, hubspot_, youtube_, humanize_text, backup_retention, config_export
2 web_search, web_fetch, calendar_events, email_list, email_read, email_search, fast_ingest, write_file, edit_file, safe_shell, todoist_create, todoist_complete, asana_create, twitter_search, brave_search, fathom_transcripts, merge_contacts, workflow, post_process_output, config_import
3 shell, run_script, code_execution, calendar_create, calendar_update, calendar_delete, hybrid_ingest, url_ingest, generate_image, firecrawl_scrape, ingest_contacts_*, database_backup, aggregate_signals
4 web_summarize, browser, email_send, email_send_sendgrid, git_ingest, meeting_prep, fathom_ingest
5 discord_send, slack_send, telegram_send, slow_ingest, email_forward, run_council, create_tool
8 generate_video

Context Permissions

Context Default
Chat All tools enabled (user present)
Heartbeat Restricted: shell, write_file disabled; max 5 energy per call
MCP Memory tools only

Tool Handler Pattern

All tools implement the ToolHandler ABC:

class ToolHandler(ABC):
    @property
    def spec(self) -> dict:
        """OpenAI function calling spec"""

    async def execute(self, arguments: dict, context: ToolContext) -> str:
        """Execute the tool and return result"""

Tools get the DB pool via context.registry.pool at execution time.

Related