UAT: agents plan use/execute --execution-environment validates as enum, not resource name #6787

Open
opened 2026-04-10 02:06:02 +00:00 by HAL9000 · 0 comments
Owner

What Was Tested

The --execution-environment flag on agents plan use and agents plan execute, specifically whether it accepts arbitrary container/devcontainer resource names as the spec requires.

Expected Behavior (from Spec)

From docs/specification.md (line 331, 12505):

agents plan use [--execution-environment <RESOURCE_NAME>]

--execution-environment RESOURCE_NAME: Name of a container-instance or devcontainer-instance resource to use as the execution environment for this plan.

The spec takes a RESOURCE_NAME (e.g., local/my-devcontainer or local/api-container) -- a namespaced resource identifier referencing a registered container-instance or devcontainer-instance resource.

Actual Behavior

In src/cleveragents/cli/commands/plan.py (lines 2177-2191 and 2352-2365), the code validates --execution-environment against the ExecutionEnvironment enum:

from cleveragents.domain.models.core.plan import ExecutionEnvironment
try:
    ExecutionEnvironment(execution_environment.lower())
except ValueError as exc:
    valid = ", ".join(e.value for e in ExecutionEnvironment)
    # => "host, container, container_ref"
    raise typer.Abort() from exc

The ExecutionEnvironment enum contains only: host, container, container_ref

A user cannot pass a resource name like local/my-devcontainer -- it will be rejected.

Steps to Reproduce

  1. Register a devcontainer resource: agents resource add devcontainer-instance local/my-devcontainer ...
  2. Try to use it: agents plan use local/my-action my-project --execution-environment local/my-devcontainer
  3. Result: Error: Invalid execution environment: local/my-devcontainer. Valid values: host, container, container_ref
  4. Expected: Plan created with local/my-devcontainer as the execution environment

Impact

Users cannot reference specific container/devcontainer resources by name for plan execution environment. The --execution-environment flag accepts only internal enum values (host, container, container_ref), not the resource name identifiers that the spec describes. Devcontainer integration (ADR-043) cannot be used via agents plan use/execute.


Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## What Was Tested The --execution-environment flag on agents plan use and agents plan execute, specifically whether it accepts arbitrary container/devcontainer resource names as the spec requires. ## Expected Behavior (from Spec) From docs/specification.md (line 331, 12505): agents plan use [--execution-environment <RESOURCE_NAME>] > --execution-environment RESOURCE_NAME: Name of a container-instance or devcontainer-instance resource to use as the execution environment for this plan. The spec takes a RESOURCE_NAME (e.g., local/my-devcontainer or local/api-container) -- a namespaced resource identifier referencing a registered container-instance or devcontainer-instance resource. ## Actual Behavior In src/cleveragents/cli/commands/plan.py (lines 2177-2191 and 2352-2365), the code validates --execution-environment against the ExecutionEnvironment enum: ```python from cleveragents.domain.models.core.plan import ExecutionEnvironment try: ExecutionEnvironment(execution_environment.lower()) except ValueError as exc: valid = ", ".join(e.value for e in ExecutionEnvironment) # => "host, container, container_ref" raise typer.Abort() from exc ``` The ExecutionEnvironment enum contains only: host, container, container_ref A user cannot pass a resource name like `local/my-devcontainer` -- it will be rejected. ## Steps to Reproduce 1. Register a devcontainer resource: `agents resource add devcontainer-instance local/my-devcontainer ...` 2. Try to use it: `agents plan use local/my-action my-project --execution-environment local/my-devcontainer` 3. **Result**: `Error: Invalid execution environment: local/my-devcontainer. Valid values: host, container, container_ref` 4. **Expected**: Plan created with local/my-devcontainer as the execution environment ## Impact Users cannot reference specific container/devcontainer resources by name for plan execution environment. The --execution-environment flag accepts only internal enum values (host, container, container_ref), not the resource name identifiers that the spec describes. Devcontainer integration (ADR-043) cannot be used via agents plan use/execute. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester
HAL9000 added this to the v3.4.0 milestone 2026-04-10 02:06:02 +00:00
HAL9000 self-assigned this 2026-04-10 06:07:14 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#6787
No description provided.