fix: document mount paths in execute_hub_tool and inject volumes into persistent sessions

fuzzforge-common/src/fuzzforge_common/hub/client.py

@@ -539,6 +539,7 @@ class HubClient:
     async def start_persistent_session(
         self,
         config: HubServerConfig,
+        extra_volumes: list[str] | None = None,
     ) -> PersistentSession:
         """Start a persistent Docker container and initialise MCP session.
 
@@ -546,6 +547,7 @@ class HubClient:
         called, allowing multiple tool calls on the same session.
 
         :param config: Server configuration (must be Docker type).
+        :param extra_volumes: Additional host:container volume mounts to inject.
         :returns: The created persistent session.
         :raises HubClientError: If the container cannot be started.
 
@@ -590,6 +592,9 @@ class HubClient:
         for volume in config.volumes:
             cmd.extend(["-v", os.path.expanduser(volume)])
 
+        for extra_vol in (extra_volumes or []):
+            cmd.extend(["-v", extra_vol])
+
         for key, value in config.environment.items():
             cmd.extend(["-e", f"{key}={value}"])
 

fuzzforge-common/src/fuzzforge_common/hub/executor.py

@@ -345,13 +345,14 @@ class HubExecutor:
     # Persistent session management
     # ------------------------------------------------------------------
 
-    async def start_persistent_server(self, server_name: str) -> dict[str, Any]:
+    async def start_persistent_server(self, server_name: str, extra_volumes: list[str] | None = None) -> dict[str, Any]:
         """Start a persistent container session for a server.
 
         The container stays running between tool calls, allowing stateful
         interactions (e.g., radare2 sessions, long-running fuzzing).
 
         :param server_name: Name of the hub server to start.
+        :param extra_volumes: Additional host:container volume mounts to inject.
         :returns: Session status dictionary.
         :raises ValueError: If server not found.
 
@@ -362,7 +363,7 @@ class HubExecutor:
             msg = f"Server '{server_name}' not found"
             raise ValueError(msg)
 
-        session = await self._client.start_persistent_session(server.config)
+        session = await self._client.start_persistent_session(server.config, extra_volumes=extra_volumes)
 
         # Auto-discover tools on the new session
         try: