Mondaic

salvus.flow.acta.executors.base

salvus.flow.acta.executors.base salvus flow acta executors base

Task execution requests, results, and backend interface.

Executors receive spec, <name>_digest inputs, <name>_path file arguments, and optional expected_versions. The caller manages caching.

Functions

dispatch_parameters()

def dispatch_parameters(request: TaskRequest) -> dict[str, Any]: ...

Derive the dispatch-convention keyword arguments for request.

Parameters
  • request TaskRequest — The task request to derive parameters from.
Returns dict[str, Any] — {"spec": ...}, one <ref_name>_digest per input ref, one <ref_name>_path per file argument, and expected_versions when any were requested. Add file_stat_cache=True only when file inputs permit digest reuse.

result_from_task_output()

def result_from_task_output(
    raw: dict[str, Any], default_provenance: dict[str, Any]
) -> TaskResult: ...

Normalize a task body’s raw output dict into a TaskResult.

Separate provenance and omit output references whose value is None.

Parameters
  • raw dict[str, Any] — The dict the task body returned.
  • default_provenance dict[str, Any] — Used when the task body reported no provenance of its own.
Returns TaskResult

Classes

Executor

class Executor(typing.Protocol):
    def __init__(self):
        ...

Task execution interface.

Methods
execute()
def execute(self, request: TaskRequest) -> TaskResult: ...

Run one task and return its output refs and provenance.

Parameters
  • request TaskRequest — The task to dispatch.
Returns TaskResult

TaskRequest

class TaskRequest(builtins.object):
    def __init__(
        self,
        task_name: str,
        spec: dict[str, Any],
        input_refs: dict[str, str | list[str]],
        expected_versions: dict[str, str],
        input_paths: dict[str, str] = default,
        tags: tuple[str, ...] = (),
        file_stat_cache: bool = False,
    ) -> None: ...

Inputs for executing a task.

Parameters
  • task_name str — Registered task name.
  • spec dict[str, Any] — Task parameters as JSON-compatible values.
  • input_refs dict[str, str | list[str]] — Input names mapped to content digests, passed as <name>_digest keyword arguments.
  • expected_versions dict[str, str] — Package versions checked at execution, excluded from cache keys.
  • input_paths dict[str, str] — Absolute file paths, keyed by input name and excluded from cache keys.
  • tags tuple[str, ...] — Placement tags, excluded from cache keys.
  • file_stat_cache bool — Allow metadata-based file verification. Omitted worker parameters retain full hashing. Excluded from cache keys.

TaskResult

class TaskResult(builtins.object):
    def __init__(
        self, output_refs: dict[str, str], provenance: dict[str, Any]
    ) -> None: ...

Task output references and execution metadata.

Parameters
  • output_refs dict[str, str] — Output names mapped to content digests. Outputs reported as None are omitted.
  • provenance dict[str, Any] — Execution metadata recorded in the manifest, excluded from cache keys.