Glossary
The UI, query filters and event histories use the industry-standard words: Workflow, Activity,
Worker, Task Queue. The Kotlin port and the lertha CLI name some of the same things more
briefly. This table maps them so nothing on a screen is a mystery.
| In the UI | Kotlin port and CLI | Identifiers | Note |
|---|---|---|---|
| Activity | Task | ActivityType, ActivityId | one unit of work; started from code or from a Workflow |
| Standalone Activity | standalone Task | standalone Activity | an Activity started directly from application code |
| Workflow | Flow | WorkflowType, WorkflowId | the durable program |
| Workflow ID, Activity ID | RunId | WorkflowId, ActivityId | the id you chose |
| Workflow Execution | flow run | WorkflowExecution | one execution of a Workflow |
| Activity Execution | task run | ActivityExecution | |
| Run ID | RunId | the orchestrator's per-attempt execution id, distinct from the port's RunId | |
| Task Queue | queue | TaskQueue | |
| Worker | runner | Worker | the process that polls a Task Queue |
| Signal | Signal | WorkflowExecutionSignaled | |
| Start-to-Close Timeout | attemptTimeout | StartToCloseTimeout | |
| Schedule-to-Close Timeout | overallTimeout | ScheduleToCloseTimeout | |
| Heartbeat Timeout | heartbeatTimeout | HeartbeatTimeout | |
| ID conflict policy | ConflictPolicy | FAIL, USE_EXISTING | |
| ID reuse policy | ReusePolicy | ALLOW_DUPLICATE, ALLOW_DUPLICATE_FAILED_ONLY, REJECT_DUPLICATE | |
| non-retryable failure | NonRetryableTaskError | ||
| Services, Service Endpoint, Service Call | NexusEndpoint, NexusOperation | cross-team calls | |
| Serverless Workers | Workers the orchestrator starts and stops; see Serverless Workers | ||
| Orchestrator | the service | ||
lertha task run | activity execute | lertha raw -- ... passes arguments to the core untouched | |
lertha flow history | workflow show | ||
LERTHA_ADDRESS, LERTHA_NAMESPACE | --address, --namespace |
Query syntax
List filters use the identifiers: ActivityType = "ComposeGreeting",
WorkflowType = "AgentRun", ExecutionStatus = "Running", WorkflowId = "agent-42".