Skip to content

Agent Zero AI framework

Apply Launcher scope changes before routing

Alessandro02e1a9860421
diff --git a/plugins/_a0_connector/AGENTS.md b/plugins/_a0_connector/AGENTS.md
index 63230523d..ae5e17580 100644
--- a/plugins/_a0_connector/AGENTS.md
+++ b/plugins/_a0_connector/AGENTS.md
@@ -35,8 +35,10 @@
master state, complete scope replacement, and Disconnect
(`emergency_disconnect` on the wire). Protected
WebUI mutations require CSRF, await the matching acknowledgement, and return
- refreshed status. Never let the WebUI select a host folder or personal
- browser profile.
+ refreshed status. Apply acknowledged master and scope state to remote file
+ and execution routing before resolving the control request; the follow-up
+ `connector_hello` only reconciles metadata. Never let the WebUI select a host
+ folder or personal browser profile.
- Launcher gateway scopes expose file reading and writing separately. File
writing depends on reading, and Code execution depends on file writing. Keep
older gateway declarations without `file_write` read/write compatible.
diff --git a/plugins/_a0_connector/helpers/ws_runtime.py b/plugins/_a0_connector/helpers/ws_runtime.py
index ee4a2e325..4126c5f2d 100644
--- a/plugins/_a0_connector/helpers/ws_runtime.py
+++ b/plugins/_a0_connector/helpers/ws_runtime.py
@@ -1085,7 +1085,23 @@ def resolve_pending_gateway_control(
) -> bool:
gateway = payload.get("gateway")
if isinstance(gateway, dict):
- store_sid_launcher_gateway_metadata(sid, gateway)
+ stored = store_sid_launcher_gateway_metadata(sid, gateway)
+ if stored is not None:
+ active = stored.master_enabled and stored.state != "disconnected"
+ files_enabled = active and stored.scopes["files"]
+ writes_enabled = files_enabled and stored.scopes["file_write"]
+ store_sid_remote_file_metadata(
+ sid,
+ {
+ "enabled": files_enabled,
+ "write_enabled": writes_enabled,
+ "mode": "read_write" if writes_enabled else "read_only",
+ },
+ )
+ store_sid_remote_exec_metadata(
+ sid,
+ {"enabled": active and stored.scopes["code_execution"]},
+ )
return _resolve_pending(_pending_gateway_controls, request_id, sid=sid, payload=payload)
diff --git a/tests/test_a0_connector_launcher_gateway.py b/tests/test_a0_connector_launcher_gateway.py
index 417b5e78c..4c9eb11c8 100644
--- a/tests/test_a0_connector_launcher_gateway.py
+++ b/tests/test_a0_connector_launcher_gateway.py
@@ -274,6 +274,50 @@ def test_gateway_control_requires_csrf_and_waits_for_ack(monkeypatch) -> None:
ws_runtime.unregister_sid(sid)
+def test_gateway_scope_ack_updates_file_routing_before_follow_up_hello(monkeypatch) -> None:
+ sid = _sid("scope-transition")
+ ws_runtime.register_sid(sid)
+ ws_runtime.store_sid_launcher_gateway_metadata(sid, _gateway("installation-a"))
+ ws_runtime.store_sid_remote_file_metadata(
+ sid,
+ {"enabled": True, "write_enabled": True, "mode": "read_write"},
+ )
+ ws_runtime.store_sid_remote_exec_metadata(sid, {"enabled": True})
+
+ class FakeManager:
+ async def emit_to(self, _namespace, target_sid, _event, data, **_kwargs):
+ assert target_sid == sid
+ updated = _gateway("installation-a", file_write=False)
+ ws_runtime.resolve_pending_gateway_control(
+ data["request_id"],
+ sid=sid,
+ payload={
+ "request_id": data["request_id"],
+ "ok": True,
+ "gateway": updated,
+ },
+ )
+
+ monkeypatch.setattr(launcher_gateway_control, "get_shared_ws_manager", lambda: FakeManager())
+ handler = launcher_gateway_control.LauncherGatewayControl(None, None)
+ try:
+ result = asyncio.run(
+ handler.process(
+ {
+ "action": "replace_scopes",
+ "scopes": _gateway("installation-a", file_write=False)["scopes"],
+ },
+ None,
+ )
+ )
+ assert result["ok"] is True
+ assert ws_runtime.select_remote_file_target_sid("ctx", require_writes=False) == sid
+ assert ws_runtime.select_remote_file_target_sid("ctx", require_writes=True) is None
+ assert ws_runtime.select_remote_exec_target_sid("ctx") is None
+ finally:
+ ws_runtime.unregister_sid(sid)
+
+
def test_gateway_scope_control_requires_explicit_file_write() -> None:
handler = launcher_gateway_control.LauncherGatewayControl(None, None)
result = asyncio.run(