feat: add support for single SAA operator actions

[spkane31]

What changed?

Add standalone activity support for pause, unpause, reset, update-options.

Combinations, Results, and Changes

activity-id	workflow-id	run-id	query	Current Result	Result w/ SAA single operation support	Change
NO	NO	NO	NO	Invalid	Invalid	—
NO	NO	NO	YES	All workflows matching the visibility query	All workflows matching the visibility query	—
NO	NO	YES	NO	Invalid	Invalid	—
NO	NO	YES	YES	Invalid	Invalid	—
NO	YES	NO	NO	Invalid (requires activity-id)		—
NO	YES	NO	YES	Invalid	Invalid	—
NO	YES	YES	NO	Invalid (requires activity-id)	Invalid (requires activity-id)	—
NO	YES	YES	YES	Invalid	Invalid	—
YES	NO	NO	NO	Invalid	The most recent activity with a given ID	New (standalone)
YES	NO	NO	YES	Batch of workflows matching the query, --activity-id is ignored	Batch of workflows matching the query, --activity-id is ignored	—
YES	NO	YES	NO	Invalid	A specific standalone activity	New (standalone)
YES	NO	YES	YES	Invalid	Invalid	—
YES	YES	NO	NO	A specific activity in the latest run of a workflow	A specific activity in a workflow	—
YES	YES	YES	NO	Specific activity ID for a workflow ID	Specific activity ID for a workflow ID	—
YES	YES	NO	YES	Invalid	Invalid	—
YES	YES	YES	YES	Invalid	Invalid	—

Checklist

Design

• This feature does not depend on Cloud-only APIs or behavior (it works against an OSS server)
• Experimental features are marked with (Experimental) in commands.yaml

Help text (see style guide at the top of commands.yaml)

• All flags shown in help text and examples are implemented and functional
• Summaries use sentence case and have no trailing period
• Long descriptions end with a period and include at least one example invocation
• Examples use long flags (--namespace, not -n), one flag per line
• Placeholder values use YourXxx form (YourWorkflowId, YourNamespace)

Behavior

• Error messages are lowercase with no trailing punctuation

Tests

• Added functional test(s) (SharedServerSuite)

Manual tests

Setup

temporal server start-dev --headless
temporal workflow start \
    --type YourWorkflowType \
    --task-queue YourTaskQueue \
    --workflow-id YourWorkflowId

Happy path

$ temporal <command> \
    --flag value
<expected output>

Error case

$ temporal <command> \
    --invalid-combination
Error: <expected error message>
$ echo $?
1

Composition

$ temporal <command-one> ...
$ temporal <command-two> --flag <value-from-above>
<expected output>

[spkane31]

NOTE: this is on the feature/activity-operator-cmds branch in temporalio/temporal, once that PR merges this can be updated to latest main.