baobab/core/supervisor/cmd

Supervisor CLI

Interactive command-line interface for the Hero Supervisor that allows you to dispatch jobs to actors and manage the job lifecycle.

Features

• Interactive Menu: Easy-to-use menu system for all supervisor operations
• Job Management: Create, run, monitor, and manage jobs
• OSIS Actor Integration: Dispatch Rhai scripts to the OSIS actor
• Real-time Results: Get immediate feedback from job execution
• Colorized Output: Clear visual feedback with colored status indicators

Usage

1. Build the OSIS Actor

First, ensure the OSIS actor is built:

cd /Users/timurgordon/code/git.ourworld.tf/herocode/actor_osis
cargo build

2. Configure the Supervisor

Create or use the example configuration file at examples/cli_config.toml:

[global]
redis_url = "redis://127.0.0.1/"

[actors]
osis_actor = "/Users/timurgordon/code/git.ourworld.tf/herocode/actor_osis/target/debug/actor_osis"

3. Run the CLI

cd /Users/timurgordon/code/git.ourworld.tf/herocode/baobab/core/supervisor
cargo run --bin supervisor-cli -- --config examples/cli_config.toml

Or with verbose logging:

cargo run --bin supervisor-cli -- --config examples/cli_config.toml --verbose

Available Commands

1. list_jobs - List all jobs in the system
2. run_job - Create and run a new job interactively
3. get_job_status - Get status of a specific job
4. get_job_output - Get output of a completed job
5. get_job_logs - Get logs for a specific job
6. stop_job - Stop a running job
7. delete_job - Delete a specific job
8. clear_all_jobs - Clear all jobs from the system
9. quit - Exit the CLI

Example Workflow

1. Start the CLI with your configuration
2. Select option 2 (run_job)
3. Enter job details:
   • Caller: Your name or identifier
   • Context: Description of what the job does
   • Script: Rhai script to execute (end with empty line)
4. The job is automatically dispatched to the OSIS actor
5. View the real-time result

Example Rhai Script

// Simple calculation
let result = 10 + 20 * 3;
print("Calculation result: " + result);
result

// Working with strings
let message = "Hello from OSIS Actor!";
print(message);
message.to_upper()

Job Status Colors

• Created - Cyan
• Dispatched - Blue
• Started - Yellow
• Finished - Green
• Error - Red

Prerequisites

• Redis server running on localhost:6379 (or configured URL)
• OSIS actor binary built and accessible
• Proper permissions to start/stop processes via Zinit

Troubleshooting

Actor Not Starting

• Verify the OSIS actor binary path in the TOML config
• Check that the binary exists and is executable
• Ensure Redis is running and accessible

Connection Issues

• Verify Redis URL in configuration
• Check network connectivity to Redis server
• Ensure no firewall blocking connections

Job Execution Failures

• Check job logs using get_job_logs command
• Verify Rhai script syntax
• Check actor logs for detailed error information