zo-swarm-executors

Local executor system for the zo-swarm-orchestrator. Manages bridge scripts, executor registry, and health checks for AI agents that run directly on the machine.

Quick Start

cd /home/workspace/Skills/zo-swarm-executors

# Check executor health
bun scripts/doctor.ts

# Integration test (sends test prompt through each bridge)
bun scripts/test-harness.ts

# List registered executors
bun scripts/register.ts list

# Validate registry schema
bun scripts/register.ts validate

Available Executors

Bridge Protocol

Bridges are shell scripts that wrap a local AI agent for orchestrator invocation:

bash <bridge> "<prompt>" [workdir]
# stdout = clean text response
# stderr = diagnostics
# exit 0 = success, non-zero = failure

See docs/BRIDGE_PROTOCOL.md for the full specification.

Integration with zo-swarm-orchestrator

The orchestrator reads registry/executor-registry.json to discover local executors. Set the registry path via:

export SWARM_EXECUTOR_REGISTRY=/home/workspace/Skills/zo-swarm-executors/registry/executor-registry.json

Or let the orchestrator use its default path: Skills/zo-swarm-executors/registry/executor-registry.json relative to SWARM_WORKSPACE.

Adding a Custom Executor

1. Copy bridges/template-bridge.sh and implement your executor
2. Create a JSON file with executor metadata (see executor-registry.json for schema)
3. Register: bun scripts/register.ts add my-executor.json
4. Verify: bun scripts/doctor.ts --executor my-executor

Environment Variables