maple.backend.envs.fractal.FractalBackend.list_tasks

FractalBackend.list_tasks(suite: str | None = None) → dict

List available Fractal tasks.

Returns task information in two modes: 1. Dynamic mode (if container running): Queries container for detailed

task list including task names, indices, and instructions.

2. Static mode (no container): Returns suite descriptions with counts.

The dynamic mode provides complete task details by querying a running container’s /tasks endpoint, which returns the full task registry.

Parameters:

suite – Optional suite name to filter results (e.g., ‘fractal’).

Returns:

Dictionary mapping suite names to task information. In dynamic mode, each suite maps to a list of task dicts with ‘index’, ‘name’, and ‘instruction’. In static mode, suites map to description dicts with ‘description’ and ‘count’.