feat(docs): update context window management documentation

- Refactor system message structure to combine system prompt and topology info using template variables
- Update token calculation process with merged system message approach
- Clarify priority order for message retention during context window management
- Add detailed token counting implementation using tiktoken library
- Include boundary case handling for system message exceeding budget
- Add SPDX license headers to tool files for proper licensing documentation

gns3server/agent/gns3_copilot/__init__.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3-Copilot - AI-powered network automation assistant for GNS3.
 
 This package provides a command-line interface for launching the GNS3-Copilot

gns3server/agent/gns3_copilot/agent/__init__.py

@@ -1,7 +1,33 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
 GNS3-Copilot Agent Package
 
-This package contains the main GNS3-Copilot agent implementation for network automation tasks.
+This package contains the main GNS3-Copilot agent implementation for
+network automation tasks using LangGraph workflow orchestration.
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 from .gns3_copilot import agent_builder

gns3server/agent/gns3_copilot/agent/context_manager.py

@@ -1,19 +1,39 @@
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-License-Identifier: GPL-3.0-or-later
 #
-# Context Window Manager for GNS3-Copilot
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
 #
-# This module manages context window limits for different LLM models,
-# implementing intelligent message trimming and token counting strategies.
 
 """
 Context Window Manager for GNS3-Copilot
 
-This module provides context window management for different LLM models,
+This module provides intelligent context window management for LLM models,
 including:
 - Model-specific context window limits
-- Token counting for messages
-- Message trimming strategies
+- Accurate token counting using tiktoken
+- Message trimming strategies (conservative/balanced/aggressive)
 - System message preservation
+- Tool definition token estimation
+- Template variable injection for topology info
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 import json
@@ -26,11 +46,24 @@ from langchain_core.messages import (
     SystemMessage,
     ToolMessage,
 )
-from langchain_core.messages.utils import trim_messages
 
 logger = logging.getLogger(__name__)
 
 
+# ============================================================================
+# Constants
+# ============================================================================
+
+# Context strategy ratios
+CONTEXT_STRATEGY_RATIOS = {
+    "conservative": 0.60,  # 60% for input, 40% reserved for output
+    "balanced": 0.75,      # 75% for input, 25% reserved for output
+    "aggressive": 0.85,    # 85% for input, 15% reserved for output
+}
+
+DEFAULT_CONTEXT_STRATEGY = "balanced"
+
+
 # ============================================================================
 # Token Counting - Using tiktoken for accuracy
 # ============================================================================
@@ -176,6 +209,10 @@ def estimate_tool_tokens(tools: list[Any]) -> int:
     return total_tokens
 
 
+# ============================================================================
+# Model Context Limits
+# ============================================================================
+
 # NOTE: Built-in model context limits have been removed.
 # Model providers frequently update context limits, and maintaining this list is not sustainable.
 # Users MUST configure context_limit explicitly in their LLM model configurations.
@@ -243,7 +280,7 @@ def get_model_context_limit(
 
 def calculate_max_tokens(
     model_limit: int,
-    strategy: Literal["conservative", "balanced", "aggressive"] = "balanced"
+    strategy: Literal["conservative", "balanced", "aggressive"] = DEFAULT_CONTEXT_STRATEGY
 ) -> int:
     """
     Calculate the maximum tokens to use, reserving space for output.
@@ -258,13 +295,7 @@ def calculate_max_tokens(
     Returns:
         int: Maximum tokens for input messages
     """
-    ratios = {
-        "conservative": 0.60,
-        "balanced": 0.75,
-        "aggressive": 0.85,
-    }
-
-    ratio = ratios.get(strategy, 0.75)
+    ratio = CONTEXT_STRATEGY_RATIOS.get(strategy, CONTEXT_STRATEGY_RATIOS[DEFAULT_CONTEXT_STRATEGY])
     max_tokens = int(model_limit * ratio)
 
     logger.debug(
@@ -275,11 +306,15 @@ def calculate_max_tokens(
     return max_tokens
 
 
+# ============================================================================
+# Message Trimming
+# ============================================================================
+
 def trim_messages_for_context(
     messages: list[Any],
     model_name: str,
     llm_config: dict[str, Any] | None = None,
-    strategy: Literal["conservative", "balanced", "aggressive"] = "balanced",
+    strategy: Literal["conservative", "balanced", "aggressive"] = DEFAULT_CONTEXT_STRATEGY,
     preserve_system: bool = True,
     tool_tokens: int = 0,
 ) -> list[Any]:
@@ -313,7 +348,7 @@ def trim_messages_for_context(
     if not messages:
         return messages
 
-    # Get model's context limit (from database or built-in defaults)
+    # Get model's context limit (from database config)
     model_limit = get_model_context_limit(model_name, llm_config)
 
     # Calculate usable tokens (reserve space for output)
@@ -414,6 +449,10 @@ def _trim_to_token_limit(messages: list[Any], max_tokens: int) -> list[Any]:
     return trimmed
 
 
+# ============================================================================
+# Token Usage Summary
+# ============================================================================
+
 def get_token_usage_summary(
     messages: list[Any],
     model_name: str,
@@ -466,7 +505,10 @@ def get_token_usage_summary(
     }
 
 
-# Convenience function for GNS3-Copilot integration
+# ============================================================================
+# Main Entry Point - Context Preparation with Template Injection
+# ============================================================================
+
 def prepare_context_messages(
     state_messages: list[Any],
     system_prompt: str,
@@ -479,11 +521,17 @@ def prepare_context_messages(
     Prepare full context messages for LLM call with automatic trimming.
 
     This is the main entry point for GNS3-Copilot to prepare messages
-    before calling the LLM.
+    before calling the LLM. It injects topology info into the system prompt
+    using template variables and performs intelligent message trimming.
+
+    Template Variable Injection:
+        The system_prompt must contain the {{topology_info}} placeholder.
+        This function will replace it with actual topology information or
+        a placeholder message if topology is not available.
 
     Args:
         state_messages: Message history from conversation state
-        system_prompt: System prompt text
+        system_prompt: System prompt text (must contain {{topology_info}} placeholder)
         topology_context: Optional topology information string
         model_name: Name of the LLM model
         llm_config: Optional LLM config dict from database (may contain context_limit and context_strategy)
@@ -495,51 +543,50 @@ def prepare_context_messages(
     Examples:
         >>> messages = prepare_context_messages(
         ...     state_messages=[HumanMessage("Help me")],
-        ...     system_prompt="You are a helpful assistant",
+        ...     system_prompt="You are a helpful assistant\\n\\n{{topology_info}}",
         ...     topology_context=None,
         ...     model_name="gpt-4o"
         ... )
         >>> len(messages)
         2  # System message + Human message
     """
-    # Get trimming strategy from config (default: "balanced")
-    trim_strategy = "balanced"
+    # Step 1: Get trimming strategy from config
+    trim_strategy = DEFAULT_CONTEXT_STRATEGY
     if llm_config and "context_strategy" in llm_config:
         strategy = llm_config["context_strategy"]
-        if strategy in ["conservative", "balanced", "aggressive"]:
+        if strategy in CONTEXT_STRATEGY_RATIOS:
             trim_strategy = strategy
             logger.debug("Using context_strategy from config: %s", trim_strategy)
         else:
-            logger.warning("Invalid context_strategy '%s', using 'balanced'", strategy)
+            logger.warning("Invalid context_strategy '%s', using '%s'", strategy, DEFAULT_CONTEXT_STRATEGY)
 
-    # Estimate tool tokens (tools are sent with each LLM call)
+    # Step 2: Estimate tool tokens (tools are sent with each LLM call)
     tool_tokens = estimate_tool_tokens(tools) if tools else 0
 
-    # Inject topology info into system prompt using template variable
+    # Step 3: Inject topology info into system prompt using template variable
     # The system_prompt contains {{topology_info}} placeholder
     if topology_context:
         topology_formatted = f"Current Topology:\n{topology_context}"
         formatted_prompt = system_prompt.replace("{{topology_info}}", topology_formatted)
     else:
-        # If no topology, remove the placeholder
+        # If no topology, use placeholder
         formatted_prompt = system_prompt.replace("{{topology_info}}", "(No topology information available)")
 
-    # Calculate token breakdown
+    # Step 4: Calculate token breakdown
     system_prompt_tokens = count_tokens_accurately(system_prompt)
     topology_tokens = count_tokens_accurately(topology_formatted) if topology_context else 0
     formatted_tokens = count_tokens_accurately(formatted_prompt)
 
-    # Build context messages (single system message with topology injected)
+    # Step 5: Build context messages (single system message with topology injected)
     context_messages = [SystemMessage(content=formatted_prompt)]
 
-    # Calculate conversation history tokens
+    # Step 6: Calculate conversation history tokens
     history_tokens = count_messages_tokens(state_messages)
-    total_context_tokens = system_prompt_tokens + topology_tokens + history_tokens
 
-    # Combine with conversation history
+    # Step 7: Combine with conversation history
     full_messages = context_messages + state_messages
 
-    # Trim if needed
+    # Step 8: Trim if needed
     trimmed_messages = trim_messages_for_context(
         full_messages,
         model_name=model_name,
@@ -549,11 +596,10 @@ def prepare_context_messages(
         tool_tokens=tool_tokens,  # Account for tool definitions
     )
 
-    # Recalculate after trimming
+    # Step 9: Recalculate after trimming
     trimmed_history_tokens = count_messages_tokens([m for m in trimmed_messages if not isinstance(m, SystemMessage)])
-    trimmed_total_tokens = system_prompt_tokens + topology_tokens + trimmed_history_tokens
 
-    # Log summary with detailed breakdown
+    # Step 10: Log summary with detailed breakdown
     model_limit_k = get_model_context_limit(model_name, llm_config) // 1000
 
     if trimmed_history_tokens < history_tokens:
@@ -589,16 +635,26 @@ def prepare_context_messages(
     return trimmed_messages
 
 
+# ============================================================================
+# Module Test
+# ============================================================================
+
 if __name__ == "__main__":
     # Simple test
     test_messages = [
         HumanMessage(f"Message {i}") for i in range(100)
     ]
 
-    result = trim_messages_for_context(
-        test_messages,
+    # Test with mock llm_config
+    mock_config = {"context_limit": 8, "context_strategy": "conservative"}
+
+    result = prepare_context_messages(
+        state_messages=test_messages,
+        system_prompt="You are GNS3 Copilot.\n\n{{topology_info}}",
+        topology_context='{"project_id": "test", "nodes": 5}',
         model_name="gpt-4o",
-        strategy="balanced"
+        llm_config=mock_config,
+        tools=None
     )
 
     print(f"Original: {len(test_messages)} messages")

gns3server/agent/gns3_copilot/agent/gns3_copilot.py

@@ -1,36 +1,42 @@
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-License-Identifier: GPL-3.0-or-later
 #
-# This file is part of GNS3-Copilot.
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
 #
 # GNS3-Copilot is free software: you can redistribute it and/or modify it
-# under the terms of the GNU Affero General Public License as published by the
+# under the terms of the GNU General Public License as published by the
 # Free Software Foundation, either version 3 of the License, or (at your
 # option) any later version.
 #
 # GNS3-Copilot is distributed in the hope that it will be useful, but
 # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
-# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
 # for more details.
 #
-# You should have received a copy of the GNU Affero General Public License along
-# with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 
 # mypy: ignore-errors
 
 """
-GNS3 Network Automation Assistant
+GNS3 Network Automation Assistant - LangGraph Agent
 
-This module implements an AI-powered assistant for GNS3 network automation and management.
-It uses LangChain for agent orchestration and DeepSeek LLM for natural language processing.
-The assistant provides comprehensive GNS3 topology management capabilities including:
-- Reading and analyzing GNS3 project topologies
-- Creating and managing network nodes and links
-- Executing network configuration and display commands on multiple devices
-- Managing VPCS (Virtual PC Simulator) commands
-- Starting and controlling GNS3 nodes
+This module implements the core LangGraph agent workflow for GNS3-Copilot,
+an AI-powered assistant for GNS3 network automation and management.
 
-The assistant integrates with various tools to provide a complete network automation
-solution for GNS3 environments.
+The agent provides:
+- LangGraph-based state management and workflow
+- Tool orchestration for GNS3 operations
+- Context-aware conversation handling
+- Automatic conversation title generation
+- Integration with GNS3 topology management
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 import operator

gns3server/agent/gns3_copilot/agent/model_factory.py

@@ -1,8 +1,33 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
 Model Factory for GNS3-Copilot Agent
 
 This module provides factory functions to create fresh LLM model instances.
-Configuration is passed directly from the API layer.
+Configuration is passed directly from the database.
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 import logging

gns3server/agent/gns3_copilot/agent_service.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3 Copilot Agent Service
 
 Provides project-level Agent instances with SQLite checkpoint management.

gns3server/agent/gns3_copilot/chat_sessions_repository.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 Chat Sessions Repository for managing chat session data.
 
 Provides CRUD operations for the chat_sessions table in the project's

gns3server/agent/gns3_copilot/gns3_client/__init__.py

@@ -1,8 +1,30 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
 GNS3 Client Package
 
 This package provides a Python interface for interacting with GNS3 servers.
-It's adapted from the upstream gns3fy project with modifications for compatibility
+Adapted from the upstream gns3fy project with modifications for compatibility
 with langchain and reduced dependency conflicts.
 
 Main classes:
@@ -11,13 +33,18 @@ Main classes:
 - Node: GNS3 Node management
 - Link: GNS3 Link management
 - GNS3TopologyTool: GNS3 topology reading tool
-- GNS3UpdateDrawingTool: GNS3 drawing update tool
+- GNS3ProjectInfoTool: GNS3 project info tool
 
 Main functions:
-- get_gns3_connector: Factory function to create Gns3Connector from environment
-- get_gns3_connector_with_llm_config: Factory function to create connector AND retrieve LLM config
+- get_gns3_connector: Factory function to create Gns3Connector
+- get_gns3_connector_with_llm_config: Create connector AND retrieve LLM config
 - get_gns3_server_host: Get GNS3 server hostname from Controller or Config
 - get_llm_config: Get LLM model configuration for a user
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
+
+Upstream gns3fy: https://github.com/davidban77/gns3fy
 """
 
 from .connector_factory import (

gns3server/agent/gns3_copilot/gns3_client/connector_factory.py

@@ -1,29 +1,39 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
 GNS3 Connector Factory Module
 
-This module provides factory functions for creating Gns3Connector instances.
-It creates appropriately configured connectors using JWT token authentication.
+This module provides factory functions for creating Gns3Connector instances
+with JWT token authentication and context-aware configuration management.
 
-The URL resolution strategy follows a priority order:
-1. Explicitly provided URL parameter
-2. Runtime configuration from Controller.instance().compute("local")
-3. Static configuration from Config.instance().settings.Server
-4. Fallback to localhost:3080
+Features:
+- Context variable based request-scoped data management (JWT tokens, LLM config)
+- Auto-detection of GNS3 server URL from Controller/Config
+- Fallback URL strategy for flexible deployment
+- LLM configuration retrieval for users
 
-Main Functions:
-    get_gns3_connector: Create a Gns3Connector with JWT token
-
-Example:
-    from gns3server.agent.gns3_copilot.gns3_client import get_gns3_connector
-
-    # Auto-detect URL from Controller or Config
-    connector = get_gns3_connector(jwt_token="your_token")
-    if connector:
-        # Use connector to interact with GNS3 server
-        projects = connector.projects
-
-Authentication:
-    - JWT token based authentication
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 import logging

gns3server/agent/gns3_copilot/gns3_client/custom_gns3fy.py

@@ -1,14 +1,44 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
-Adapted gns3fy module for gns3-copilot.
+Adapted gns3fy module for GNS3-Copilot
 
 This module is based on the upstream gns3fy project (https://github.com/davidban77/gns3fy).
-Modifications made for this repository:
-- Adjusted some pydantic usages and dataclass configuration to reduce dependency conflicts
-  with langchain (pydantic version/api differences).
-- Kept the original API surface where possible but simplified validators/config to improve compatibility.
-- Please review any pydantic-specific code if upgrading langchain or pydantic in the future.
 
-Note: This file is adapted - not the untouched upstream source. See repository README for details.
+Modifications made for GNS3-Copilot:
+- Adjusted pydantic usages and dataclass configuration to reduce dependency conflicts
+  with langchain (pydantic version/api differences)
+- Kept the original API surface where possible but simplified validators/config
+- Added JWT token authentication support
+- Integrated with context-aware connector factory
+
+Note: This file is adapted from upstream gns3fy for compatibility with
+GNS3-Copilot's architecture.
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
+
+Upstream: https://github.com/davidban77/gns3fy
 """
 
 import os

gns3server/agent/gns3_copilot/gns3_client/gns3_project_info.py

@@ -1,6 +1,34 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
+GNS3 Project Info Tool
+
 This module provides a LangChain BaseTool to retrieve basic information of a
-specific GNS3 project by project ID.
+specific GNS3 project by project ID. Returns project name, status, node count,
+and link count.
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 import logging

gns3server/agent/gns3_copilot/gns3_client/gns3_topology_reader.py

@@ -1,6 +1,33 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
+GNS3 Topology Reader Tool
+
 This module provides a LangChain BaseTool to retrieve the topology of a
- specific GNS3 project by project ID.
+specific GNS3 project by project ID. Returns nodes, links, and project metadata.
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 import copy

gns3server/agent/gns3_copilot/project_agent_manager.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 Project Agent Manager
 
 Manages AgentService instances for GNS3 projects using a singleton pattern.

gns3server/agent/gns3_copilot/prompts/__init__.py

@@ -1,8 +1,33 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
-Prompts module for GNS3 Copilot.
+Prompts Module for GNS3-Copilot
 
 This package contains system prompts and prompt loading utilities for
-the GNS3 Copilot AI agent.
+the GNS3-Copilot AI agent.
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 from .base_prompt import SYSTEM_PROMPT

gns3server/agent/gns3_copilot/prompts/base_prompt.py

@@ -1,10 +1,35 @@
-"""
-System prompt for GNS3 Network Lab Teaching Assistant
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 
-This module contains the system prompt used by the LangChain v1.0 agent
+"""
+System Prompt for GNS3 Network Lab Teaching Assistant
+
+This module contains the system prompt used by the LangGraph agent
 to guide network diagnostics and teaching activities.
 
 CRITICAL: This assistant has DIAGNOSIS permissions only, NO configuration permissions.
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 # System prompt for LangChain v1.0 agent

gns3server/agent/gns3_copilot/prompts/prompt_loader.py

@@ -1,7 +1,34 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
+
 """
-Prompt loader for GNS3 Copilot.
+Prompt Loader for GNS3-Copilot
 
 This module provides utilities for loading system prompts.
+Can be extended to support multiple prompt variants based on
+environment variables (e.g., ENGLISH_LEVEL).
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 import logging
@@ -14,7 +41,7 @@ logger = logging.getLogger(__name__)
 
 def load_system_prompt() -> str:
     """
-    Load the system prompt for GNS3 Copilot.
+    Load the system prompt for GNS3-Copilot.
 
     In the future, this can be extended to support multiple prompt variants
     based on environment variables (e.g., ENGLISH_LEVEL).

gns3server/agent/gns3_copilot/prompts/title_prompt.py

@@ -1,7 +1,33 @@
-"""
-Prompt template for generating conversation titles.
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 
+"""
+Title Generation Prompt for GNS3-Copilot
+
+Prompt template for generating conversation titles.
 Generates concise Chinese or English titles based on conversation language.
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 """
 
 TITLE_PROMPT = """

gns3server/agent/gns3_copilot/tools_v2/__init__.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3-Copilot Tools Package
 
 This package provides various tools for interacting with GNS3 network simulator, including:

gns3server/agent/gns3_copilot/tools_v2/config_tools_nornir.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 This module provides a tool to execute configuration commands on multiple devices
  in a GNS3 topology using Nornir.
 """

gns3server/agent/gns3_copilot/tools_v2/display_tools_nornir.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 This module provides a tool to execute display commands on multiple devices
  in a GNS3 topology using Nornir.
 """

gns3server/agent/gns3_copilot/tools_v2/gns3_create_link.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3 link creation tool for connecting network nodes.
 
 Provides functionality to create links between nodes in GNS3 projects

gns3server/agent/gns3_copilot/tools_v2/gns3_create_node.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3 node creation tool for network topology building.
 
 Provides functionality to create multiple nodes in GNS3 projects

gns3server/agent/gns3_copilot/tools_v2/gns3_get_node_temp.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3 template retrieval tool for device discovery.
 
 Provides functionality to retrieve all available device templates

gns3server/agent/gns3_copilot/tools_v2/gns3_start_node.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3 node startup tool for network device activation.
 
 Provides functionality to start one or multiple nodes in GNS3 projects

gns3server/agent/gns3_copilot/tools_v2/gns3_update_node_name.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3 node name update tool for renaming network devices.
 
 Provides functionality to update the name of one or multiple nodes in GNS3 projects.

gns3server/agent/gns3_copilot/tools_v2/vpcs_tools_telnetlib3.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 Multi-device VPCS command execution tool using telnetlib3 with threading.
 Supports concurrent execution of multiple command groups across multiple VPCS devices.
 """

gns3server/agent/gns3_copilot/utils/__init__.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 GNS3-Copilot Public Model Package
 
 This package provides reusable public models and utilities for GNS3 network automation tasks.

gns3server/agent/gns3_copilot/utils/get_gns3_device_port.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 Public module for getting device port information from GNS3 topology
 """
 

gns3server/agent/gns3_copilot/utils/gns3_drawing_utils.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 Drawing utility functions for GNS3 area annotations.
 
 Calculates drawing parameters and generates SVG content for network area annotations.

gns3server/agent/gns3_copilot/utils/llm_config_helper.py

@@ -1,4 +1,28 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 LLM Model Configuration Helper for GNS3 Copilot
 
 This module provides utility functions to retrieve LLM model configurations

gns3server/agent/gns3_copilot/utils/message_converters.py

@@ -1,4 +1,4 @@
-# SPDX-License-Identifier: AGPL-3.0-or-later
+# SPDX-License-Identifier: GPL-3.0-or-later
 #
 # This file is part of GNS3 Server.
 #
@@ -16,6 +16,9 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 """
+
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
 Message format converters for OpenAI-compatible message format.
 Converts between LangChain messages and OpenAI-compatible format.
 """

gns3server/agent/gns3_copilot/utils/parse_tool_content.py

@@ -1,3 +1,24 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# GNS3-Copilot - AI-powered Network Lab Assistant for GNS3
+#
+# This file is part of GNS3-Copilot project.
+#
+# GNS3-Copilot is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# GNS3-Copilot is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with GNS3-Copilot. If not, see <https://www.gnu.org/licenses/>.
+#
+# Project Home: https://github.com/yueguobin/gns3-copilot
+#
 """
 Public module for parsing tool execution results
 
@@ -39,6 +60,9 @@ Standard Tool Response Format:
 Author: Guobin Yue
 """
 
+This module is part of the GNS3-Copilot project.
+GitHub: https://github.com/yueguobin/gns3-copilot
+
 import ast
 import json
 import logging