refactor: ruff autofixes

gns3server/agent/mcp/appliances.py

@@ -28,8 +28,10 @@ log = logging.getLogger(__name__)
 
 # ── Helper ─────────────────────────────────────────────────────────────────
 
+
 def _get_connector(gns3_ctx: dict[str, Any]):
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],
@@ -41,12 +43,32 @@ def _get_connector(gns3_ctx: dict[str, Any]):
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
 VALID_APPLIANCE_FIELDS = {
-    "appliance_id", "name", "category", "description", "vendor_name",
-    "vendor_url", "product_name", "product_url", "documentation_url",
-    "status", "availability", "maintainer", "usage", "symbol",
-    "images", "versions", "tags", "builtin",
-    "first_port_name", "port_name_format", "port_segment_size",
-    "linked_clone", "docker", "iou", "dynamips", "qemu",
+    "appliance_id",
+    "name",
+    "category",
+    "description",
+    "vendor_name",
+    "vendor_url",
+    "product_name",
+    "product_url",
+    "documentation_url",
+    "status",
+    "availability",
+    "maintainer",
+    "usage",
+    "symbol",
+    "images",
+    "versions",
+    "tags",
+    "builtin",
+    "first_port_name",
+    "port_name_format",
+    "port_segment_size",
+    "linked_clone",
+    "docker",
+    "iou",
+    "dynamips",
+    "qemu",
 }
 
 
@@ -56,7 +78,7 @@ def get_appliances_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) ->
     fields = params.get("fields")
     if fields:
         if not isinstance(fields, list):
-            return {"error": "fields must be a list, e.g. [\"name\", \"category\"]"}
+            return {"error": 'fields must be a list, e.g. ["name", "category"]'}
         invalid = [f for f in fields if f not in VALID_APPLIANCE_FIELDS]
         if invalid:
             return {

gns3server/agent/mcp/computes.py

@@ -27,6 +27,7 @@ log = logging.getLogger(__name__)
 
 def _get_connector(gns3_ctx: dict[str, Any]):
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],

gns3server/agent/mcp/device_config.py

@@ -81,6 +81,7 @@ def _render_template(template: str, device_configs: list[dict], commands_field:
 
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
+
 def device_config_send_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> list[dict[str, Any]]:
     """Send configuration commands to network devices via console."""
     project_id = params.get("project_id")
@@ -97,10 +98,12 @@ def device_config_send_handler(params: dict[str, Any], gns3_ctx: dict[str, Any])
     from gns3server.agent.gns3_copilot.tools_v2.config_tools_nornir import ExecuteMultipleDeviceConfigCommands
 
     tool = ExecuteMultipleDeviceConfigCommands()
-    input_data = json.dumps({
-        "project_id": project_id,
-        "device_configs": device_configs,
-    })
+    input_data = json.dumps(
+        {
+            "project_id": project_id,
+            "device_configs": device_configs,
+        }
+    )
     return tool._run(
         input_data,
         jwt_token=gns3_ctx["jwt_token"],
@@ -114,7 +117,12 @@ def device_show_run_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) ->
     device_configs = params.get("device_configs")
     template = params.get("template")
     if not project_id or not device_configs:
-        return [{"status": "failed", "error": "project_id and device_configs (list of {device_name, commands}) are required"}]
+        return [
+            {
+                "status": "failed",
+                "error": "project_id and device_configs (list of {device_name, commands}) are required",
+            }
+        ]
 
     if template:
         device_configs = _render_template(template, device_configs, commands_field="commands")
@@ -124,10 +132,12 @@ def device_show_run_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) ->
     from gns3server.agent.gns3_copilot.tools_v2.display_tools_nornir import ExecuteMultipleDeviceCommands
 
     tool = ExecuteMultipleDeviceCommands()
-    input_data = json.dumps({
-        "project_id": project_id,
-        "device_configs": device_configs,
-    })
+    input_data = json.dumps(
+        {
+            "project_id": project_id,
+            "device_configs": device_configs,
+        }
+    )
     return tool._run(
         input_data,
         jwt_token=gns3_ctx["jwt_token"],
@@ -145,10 +155,12 @@ def vpcs_config_set_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) ->
     from gns3server.agent.gns3_copilot.tools_v2.vpcs_tools_netmiko import VPCSCommands
 
     tool = VPCSCommands()
-    input_data = json.dumps({
-        "project_id": project_id,
-        "device_configs": device_configs,
-    })
+    input_data = json.dumps(
+        {
+            "project_id": project_id,
+            "device_configs": device_configs,
+        }
+    )
     return tool._run(
         input_data,
         jwt_token=gns3_ctx["jwt_token"],

gns3server/agent/mcp/drawings.py

@@ -28,8 +28,10 @@ log = logging.getLogger(__name__)
 
 # ── Helper ─────────────────────────────────────────────────────────────────
 
+
 def _get_connector(gns3_ctx: dict[str, Any]):
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],
@@ -40,6 +42,7 @@ def _get_connector(gns3_ctx: dict[str, Any]):
 
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
+
 def get_drawings_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> dict[str, Any]:
     project_id = params.get("project_id")
     if not project_id:

gns3server/agent/mcp/images.py

@@ -28,8 +28,10 @@ log = logging.getLogger(__name__)
 
 # ── Helper ─────────────────────────────────────────────────────────────────
 
+
 def _get_connector(gns3_ctx: dict[str, Any]):
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],
@@ -40,6 +42,7 @@ def _get_connector(gns3_ctx: dict[str, Any]):
 
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
+
 def get_images_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> dict[str, Any]:
     conn = _get_connector(gns3_ctx)
     images = conn.http_call("get", f"{conn.base_url}/images").json()

gns3server/agent/mcp/projects.py

@@ -31,9 +31,11 @@ log = logging.getLogger(__name__)
 
 # ── Helper ─────────────────────────────────────────────────────────────────
 
+
 def _get_connector(gns3_ctx: dict[str, Any]):
     """Create a Gns3Connector from the GNS3 context dict."""
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],
@@ -44,6 +46,7 @@ def _get_connector(gns3_ctx: dict[str, Any]):
 
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
+
 def list_projects_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> dict[str, Any]:
     conn = _get_connector(gns3_ctx)
     projects = conn.http_call("get", f"{conn.base_url}/projects").json()
@@ -141,7 +144,12 @@ def get_project_readme_handler(params: dict[str, Any], gns3_ctx: dict[str, Any])
         return {"project_id": project_id, "file": "README.txt", "content": content}
     except Exception as e:
         if "404" in str(e):
-            return {"project_id": project_id, "file": "README.txt", "content": None, "message": "README.txt does not exist yet"}
+            return {
+                "project_id": project_id,
+                "file": "README.txt",
+                "content": None,
+                "message": "README.txt does not exist yet",
+            }
         raise
 
 
@@ -286,7 +294,10 @@ PROJECT_TOOLS = [
                 "show_grid": {"type": "boolean", "description": "Show the grid on the drawing area"},
                 "grid_size": {"type": "integer", "description": "Grid size for the drawing area for nodes"},
                 "drawing_grid_size": {"type": "integer", "description": "Grid size for the drawing area for drawings"},
-                "show_interface_labels": {"type": "boolean", "description": "Show interface labels on the drawing area"},
+                "show_interface_labels": {
+                    "type": "boolean",
+                    "description": "Show interface labels on the drawing area",
+                },
             },
             "required": ["project_id"],
         },

gns3server/agent/mcp/server.py

@@ -28,8 +28,10 @@ log = logging.getLogger(__name__)
 
 # ── Helper ─────────────────────────────────────────────────────────────────
 
+
 def _get_connector(gns3_ctx: dict[str, Any]):
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],
@@ -40,6 +42,7 @@ def _get_connector(gns3_ctx: dict[str, Any]):
 
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
+
 def get_version_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> dict[str, Any]:
     conn = _get_connector(gns3_ctx)
     return conn.http_call("get", f"{conn.base_url}/version").json()

gns3server/agent/mcp/snapshots.py

@@ -28,8 +28,10 @@ log = logging.getLogger(__name__)
 
 # ── Helper ─────────────────────────────────────────────────────────────────
 
+
 def _get_connector(gns3_ctx: dict[str, Any]):
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],
@@ -40,6 +42,7 @@ def _get_connector(gns3_ctx: dict[str, Any]):
 
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
+
 def get_snapshots_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> dict[str, Any]:
     project_id = params.get("project_id")
     if not project_id:

gns3server/agent/mcp/symbols.py

@@ -30,8 +30,10 @@ log = logging.getLogger(__name__)
 
 # ── Helper ─────────────────────────────────────────────────────────────────
 
+
 def _get_connector(gns3_ctx: dict[str, Any]):
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],
@@ -42,6 +44,7 @@ def _get_connector(gns3_ctx: dict[str, Any]):
 
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
+
 def get_symbols_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> dict[str, Any]:
     conn = _get_connector(gns3_ctx)
     symbols = conn.http_call("get", f"{conn.base_url}/symbols").json()
@@ -57,9 +60,11 @@ def get_symbol_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> dict
     username = gns3_ctx.get("jwt_username")
     # short-lived ticket bound to this exact path — LLM clients retyping curl
     # commands corrupted the long Bearer JWT this used to embed
-    ticket = access_ticket_service.mint(
-        username, token_version=gns3_ctx.get("jwt_token_version", 0), path=path
-    ) if username else None
+    ticket = (
+        access_ticket_service.mint(username, token_version=gns3_ctx.get("jwt_token_version", 0), path=path)
+        if username
+        else None
+    )
     if ticket:
         download_url += f"?token={ticket}"
     result = {
@@ -68,7 +73,7 @@ def get_symbol_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) -> dict
         "note": "Symbol files are SVG images.",
     }
     if ticket:
-        safe_name = symbol_id.replace(':', '').replace('/', '_')
+        safe_name = symbol_id.replace(":", "").replace("/", "_")
         result["curl_command"] = f"curl -L -o '{safe_name}.svg' '{download_url}'"
         result["note"] += " The download URL includes a 10-minute ticket."
     return result

gns3server/agent/mcp/templates.py

@@ -31,8 +31,10 @@ log = logging.getLogger(__name__)
 
 # ── Helper ─────────────────────────────────────────────────────────────────
 
+
 def _get_connector(gns3_ctx: dict[str, Any]):
     from gns3server.agent.gns3_copilot.gns3_client.connector import Gns3Connector
+
     return Gns3Connector(
         url=gns3_ctx["server_url"],
         jwt_token=gns3_ctx["jwt_token"],
@@ -44,9 +46,19 @@ def _get_connector(gns3_ctx: dict[str, Any]):
 # ── Tool handlers ──────────────────────────────────────────────────────────
 
 VALID_TEMPLATE_FIELDS = {
-    "template_id", "name", "version", "category", "default_name_format",
-    "symbol", "template_type", "compute_id", "usage", "tags", "builtin",
-    "created_at", "updated_at",
+    "template_id",
+    "name",
+    "version",
+    "category",
+    "default_name_format",
+    "symbol",
+    "template_type",
+    "compute_id",
+    "usage",
+    "tags",
+    "builtin",
+    "created_at",
+    "updated_at",
 }
 
 TEMPLATE_DEFAULT_FIELDS = ["template_id", "name", "template_type", "category", "default_name_format"]
@@ -67,7 +79,7 @@ def list_templates_handler(params: dict[str, Any], gns3_ctx: dict[str, Any]) ->
     fields = params.get("fields")
     if fields:
         if not isinstance(fields, list):
-            return {"error": "fields must be a list, e.g. [\"template_id\", \"name\"]"}
+            return {"error": 'fields must be a list, e.g. ["template_id", "name"]'}
         invalid = [f for f in fields if f not in VALID_TEMPLATE_FIELDS]
         if invalid:
             return {