Agent Delegation & Orchestration

Pando includes Mesnada, a powerful agent orchestration framework that allows you to delegate tasks to specialized sub-agents running in the background. Sub-agents can work on different projects, use different engines, and report results back to the parent agent automatically.

Spawning Sub-Agents

The mesnada_spawn_agent tool launches background tasks:

{
  "prompt": "Analyze the authentication module and write tests",
  "subagent_type": "general",
  "description": "Write auth tests",
  "background": true
}

Key Parameters

Waiting for Results

Non-Blocking (Recommended)

Use mesnada_await after spawning background tasks:

{
  "action": "wait",
  "actor_id": "explore-1"
}

The parent agent is automatically resumed when results arrive.

Blocking

Use mesnada_wait_task to block until a specific task completes:

{
  "task_id": "T1",
  "timeout": "10m"
}

Task Dependencies

Tasks can depend on other tasks. A dependent task starts only when all its dependencies complete:

{
  "prompt": "Write tests based on the analysis",
  "dependencies": ["T1", "T2"],
  "include_dependency_logs": true,
  "dependency_log_lines": 100
}

Custom Engine Templates

Define custom agent engines by placing *.template.yaml files in the engines directory:

[Mesnada.Orchestrator]
EnginesDir = ''   # defaults to <dirname(LogDir)>/engines

Each template specifies command, args (with Go template expressions), prompt mode, output format, and available models. Custom engines appear dynamically in the mesnada_spawn_agent tool.

Multi-Project Delegation

Delegate tasks to other running Pando instances across different projects:

[Mesnada.Delegation]
Enabled = true
ReuseWarmInstances = true
AutoStartWarmInstance = true

The project parameter routes the task to the correct project’s warm instance.

Warm Instance Reuse

When enabled, delegated tasks are routed to already-running (“warm”) ACP instances instead of spawning new CLI processes:

[Mesnada.Delegation]
ReuseWarmInstances = true
WarmInstanceIdleTimeout = '10m'
MaxConcurrent = 8

Delegation Supervisor

The supervisor handles automatic finalization of delegated tasks:

• Inject into live loop: When a task completes while the parent is running, results are injected automatically
• Resurrect idle loop: When tasks complete while the parent is idle, the parent is woken up with combined results

[Mesnada.Delegation]
Enabled = true
InjectIntoLiveLoop = true
ResurrectIdleLoop = true
MaxResurrections = 4
MaxDepth = 3

Hot-Peer Delegation (IPC)

Instances can delegate tasks to external peer instances over ZeroMQ IPC:

[Mesnada.Delegation]
AllowExternalWarmTargets = true   # caller-side
AcceptDelegations = true           # target-side

Session Management

Manage Mesnada tasks with dedicated tools:

• mesnada_get_task - Get task details
• mesnada_list_tasks - List tasks with filters
• mesnada_cancel_task - Cancel a task
• mesnada_get_task_output - Get stdout/stderr