feat(tools): implement ContainerToolRunner wrapping Docker/Podman execution #10150

Open
opened 2026-04-17 03:57:41 +00:00 by HAL9000 · 0 comments
Owner

Background

Container-based tool execution provides security isolation and reproducibility for tool runs. The ContainerToolRunner wraps existing tool execution in Docker or Podman containers, allowing tools to run in controlled environments with specific images, volumes, and environment variables without modifying the tool implementation itself.

Acceptance Criteria

  • ContainerToolRunner class implemented wrapping tool execution in Docker/Podman
  • Supports both Docker and Podman runtimes (auto-detected or configurable)
  • Container image pulled automatically if not present locally
  • Tool stdout/stderr captured from container and returned as tool output
  • Test coverage >= 97%

Metadata

  • Commit Message: feat(tools): implement ContainerToolRunner wrapping Docker/Podman execution
  • Branch: feature/v3.6.0/container-tool-runner
  • Milestone: v3.6.0
  • Ref: #5504 EPIC: Container Tool Execution — Docker/Podman Tool Runner (v3.6.0)

Subtasks

  • Define ContainerToolRunner class and container configuration model
  • Implement Docker runtime adapter with image pull and container run
  • Implement Podman runtime adapter
  • Implement stdout/stderr capture from container execution
  • Write unit tests with mocked Docker/Podman subprocess calls

Definition of Done

  • Implementation complete and all acceptance criteria met
  • Tests written and passing (coverage >= 97%)
  • PR reviewed and merged
  • Parent epic updated

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor

## Background Container-based tool execution provides security isolation and reproducibility for tool runs. The ContainerToolRunner wraps existing tool execution in Docker or Podman containers, allowing tools to run in controlled environments with specific images, volumes, and environment variables without modifying the tool implementation itself. ## Acceptance Criteria - [ ] `ContainerToolRunner` class implemented wrapping tool execution in Docker/Podman - [ ] Supports both Docker and Podman runtimes (auto-detected or configurable) - [ ] Container image pulled automatically if not present locally - [ ] Tool stdout/stderr captured from container and returned as tool output - [ ] Test coverage >= 97% ## Metadata - **Commit Message**: `feat(tools): implement ContainerToolRunner wrapping Docker/Podman execution` - **Branch**: `feature/v3.6.0/container-tool-runner` - **Milestone**: v3.6.0 - **Ref**: #5504 EPIC: Container Tool Execution — Docker/Podman Tool Runner (v3.6.0) ## Subtasks - [ ] Define `ContainerToolRunner` class and container configuration model - [ ] Implement Docker runtime adapter with image pull and container run - [ ] Implement Podman runtime adapter - [ ] Implement stdout/stderr capture from container execution - [ ] Write unit tests with mocked Docker/Podman subprocess calls ## Definition of Done - Implementation complete and all acceptance criteria met - Tests written and passing (coverage >= 97%) - PR reviewed and merged - Parent epic updated --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
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#10150
No description provided.