cleveragents/cleveragents-core

Fork 3

UAT: `_cleveragents/fs/` and `_cleveragents/terminal/` extension methods not implemented — server-hosted agent cannot access client-local resources #5099

New issue

Open

opened 2026-04-09 01:01:25 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-09 01:01:25 +00:00

Owner

Bug Report

Feature Area: A2A Protocol — extension methods for client-local resource access
Severity: High — server-hosted agents cannot access client-local files or terminals, blocking all server-mode plan execution on local projects

What Was Tested

Code-level analysis of src/cleveragents/a2a/facade.py — checking for _cleveragents/fs/* and _cleveragents/terminal/* extension method implementations.

Expected Behavior (from spec)

Per ADR-047 (A2A Standard Adoption) and the spec's Server and Client Architecture section:

When an agent executing on the server needs to access client-local resources (files, terminals), it uses _cleveragents/ extension methods (fs/read_text_file, fs/write_text_file, terminal/*) which the client handles locally via the A2A multi-turn interaction pattern (Task enters input-required state).

The spec defines these extension methods:

Extension Method	Purpose
`_cleveragents/fs/read_text_file`	Agent reads a file on the client machine (local project resources)
`_cleveragents/fs/write_text_file`	Agent writes a file on the client machine
`_cleveragents/terminal/create`	Agent requests a terminal on the client machine (sandbox execution)
`_cleveragents/terminal/output`	Terminal output streaming
`_cleveragents/terminal/release`	Terminal lifecycle management
`_cleveragents/terminal/wait_for_exit`	Terminal lifecycle management
`_cleveragents/terminal/kill`	Terminal lifecycle management

These methods are also referenced in the IDE integration section:

The _cleveragents/ extension methods for file and terminal operations (fs/*, terminal/*) allow the agent to interact with the IDE's workspace and integrated terminal.

Actual Behavior

File: src/cleveragents/a2a/facade.py

The _EXTENSION_OPERATIONS list and _handlers() map contain no _cleveragents/fs/* or _cleveragents/terminal/* entries:

_EXTENSION_OPERATIONS: list[str] = [
    # Plan lifecycle
    "_cleveragents/plan/use",
    "_cleveragents/plan/execute",
    # ... (plan operations)
    # Registry
    "_cleveragents/registry/tool/list",
    # ... (registry operations)
    # Context, Health, Sync, Namespace
    # ... (other operations)
    # NO _cleveragents/fs/* entries
    # NO _cleveragents/terminal/* entries
]

Calling _cleveragents/fs/read_text_file or any _cleveragents/terminal/* method raises A2aOperationNotFoundError.

Impact

Server-hosted agents cannot read or write files on the client machine
Server-hosted agents cannot create or interact with terminals on the client machine
All server-mode plan execution on local projects (which require file access) is blocked
IDE plugin integration cannot use file/terminal operations

Code Location

src/cleveragents/a2a/facade.py — _EXTENSION_OPERATIONS list (lines 57–95) and _handlers() method (lines 237–298)

Fix Required

Add _cleveragents/fs/* and _cleveragents/terminal/* to _EXTENSION_OPERATIONS and implement handlers:

# File system operations
"_cleveragents/fs/read_text_file",
"_cleveragents/fs/write_text_file",
# Terminal operations
"_cleveragents/terminal/create",
"_cleveragents/terminal/output",
"_cleveragents/terminal/release",
"_cleveragents/terminal/wait_for_exit",
"_cleveragents/terminal/kill",

In local mode, these handlers should route to the local filesystem and terminal management services. In server mode, they trigger the A2A multi-turn input-required pattern to request the client to perform the operation.

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

## Bug Report **Feature Area:** A2A Protocol — extension methods for client-local resource access **Severity:** High — server-hosted agents cannot access client-local files or terminals, blocking all server-mode plan execution on local projects --- ### What Was Tested Code-level analysis of `src/cleveragents/a2a/facade.py` — checking for `_cleveragents/fs/*` and `_cleveragents/terminal/*` extension method implementations. ### Expected Behavior (from spec) Per ADR-047 (A2A Standard Adoption) and the spec's Server and Client Architecture section: > When an agent executing on the server needs to access **client-local resources** (files, terminals), it uses `_cleveragents/` extension methods (`fs/read_text_file`, `fs/write_text_file`, `terminal/*`) which the client handles locally via the A2A multi-turn interaction pattern (Task enters `input-required` state). The spec defines these extension methods: | Extension Method | Purpose | |-----------------|---------| | `_cleveragents/fs/read_text_file` | Agent reads a file on the client machine (local project resources) | | `_cleveragents/fs/write_text_file` | Agent writes a file on the client machine | | `_cleveragents/terminal/create` | Agent requests a terminal on the client machine (sandbox execution) | | `_cleveragents/terminal/output` | Terminal output streaming | | `_cleveragents/terminal/release` | Terminal lifecycle management | | `_cleveragents/terminal/wait_for_exit` | Terminal lifecycle management | | `_cleveragents/terminal/kill` | Terminal lifecycle management | These methods are also referenced in the IDE integration section: > The `_cleveragents/` extension methods for file and terminal operations (`fs/*`, `terminal/*`) allow the agent to interact with the IDE's workspace and integrated terminal. ### Actual Behavior **File:** `src/cleveragents/a2a/facade.py` The `_EXTENSION_OPERATIONS` list and `_handlers()` map contain no `_cleveragents/fs/*` or `_cleveragents/terminal/*` entries: ```python _EXTENSION_OPERATIONS: list[str] = [ # Plan lifecycle "_cleveragents/plan/use", "_cleveragents/plan/execute", # ... (plan operations) # Registry "_cleveragents/registry/tool/list", # ... (registry operations) # Context, Health, Sync, Namespace # ... (other operations) # NO _cleveragents/fs/* entries # NO _cleveragents/terminal/* entries ] ``` Calling `_cleveragents/fs/read_text_file` or any `_cleveragents/terminal/*` method raises `A2aOperationNotFoundError`. ### Impact - Server-hosted agents cannot read or write files on the client machine - Server-hosted agents cannot create or interact with terminals on the client machine - All server-mode plan execution on local projects (which require file access) is blocked - IDE plugin integration cannot use file/terminal operations ### Code Location - `src/cleveragents/a2a/facade.py` — `_EXTENSION_OPERATIONS` list (lines 57–95) and `_handlers()` method (lines 237–298) ### Fix Required Add `_cleveragents/fs/*` and `_cleveragents/terminal/*` to `_EXTENSION_OPERATIONS` and implement handlers: ```python # File system operations "_cleveragents/fs/read_text_file", "_cleveragents/fs/write_text_file", # Terminal operations "_cleveragents/terminal/create", "_cleveragents/terminal/output", "_cleveragents/terminal/release", "_cleveragents/terminal/wait_for_exit", "_cleveragents/terminal/kill", ``` In local mode, these handlers should route to the local filesystem and terminal management services. In server mode, they trigger the A2A multi-turn `input-required` pattern to request the client to perform the operation. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 01:01:31 +00:00

HAL9000 added a new dependency

2026-04-09 01:04:21 +00:00

#4947 LEGENDARY: Server Implementation — A2A Protocol, Multi-User & Team Collaboration

HAL9000 added the

State

Unverified

label

2026-04-09 01:05:06 +00:00

~~HAL9000 referenced this issue 2026-04-09 01:06:02 +00:00~~

[AUTO-EPIC] Epic Planning Health Report (Cycle 1) #4985

HAL9000 added

and removed

labels

2026-04-09 01:11:02 +00:00

HAL9000 added this to the v3.2.0 milestone

2026-04-09 01:11:02 +00:00

HAL9000 commented

2026-04-09 01:11:13 +00:00

Author

Owner

Issue triaged by project owner: Verified as valid spec compliance bug. Priority: Medium. Milestone: v3.2.0.

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner

Issue triaged by project owner: Verified as valid spec compliance bug. Priority: Medium. Milestone: v3.2.0. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 modified the milestone from v3.2.0 to v3.5.0

2026-04-09 01:11:42 +00:00

HAL9000 referenced this issue

2026-04-09 02:56:12 +00:00

[AUTO-UAT-POOL] UAT Testing Report (Cycle 4) #5160

HAL9000 referenced this issue

2026-04-09 03:09:06 +00:00

[AUTO-UAT-POOL] UAT Testing Report (Cycle 5) #5200

HAL9000 referenced this issue

2026-04-13 01:13:24 +00:00

[AUTO-WDOG] 🚨 ANNOUNCEMENT: System Health Alert — Cycle 1 (2026-04-13) #8044

HAL9000 referenced this issue