PyPI - agentman-mcp - Versions diffs - 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl - Mend

agentman-mcp 0.1.3py3-none-any.whl → 0.1.5py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

agentman/__init__.py +2 -0
agentman/agent_builder.py +90 -26
agentman/agentfile_parser.py +51 -16
agentman/cli.py +56 -19
agentman/common.py +8 -0
agentman/version.py +7 -2
agentman_mcp-0.1.5.dist-info/METADATA +592 -0
agentman_mcp-0.1.5.dist-info/RECORD +13 -0
agentman_mcp-0.1.3.dist-info/METADATA +0 -434
agentman_mcp-0.1.3.dist-info/RECORD +0 -13
{agentman_mcp-0.1.3.dist-info → agentman_mcp-0.1.5.dist-info}/WHEEL +0 -0
{agentman_mcp-0.1.3.dist-info → agentman_mcp-0.1.5.dist-info}/entry_points.txt +0 -0
{agentman_mcp-0.1.3.dist-info → agentman_mcp-0.1.5.dist-info}/licenses/LICENSE +0 -0
{agentman_mcp-0.1.3.dist-info → agentman_mcp-0.1.5.dist-info}/top_level.txt +0 -0

agentman/__init__.py CHANGED Viewed

@@ -1,3 +1,5 @@
+"""Agentman package for building MCP agents from Agentfiles."""
 import sys
 from agentman.cli import HelpException, init_cli, print_version

agentman/agent_builder.py CHANGED Viewed

@@ -1,37 +1,55 @@
+"""Agent builder module for generating files from Agentfile configuration."""
+import json
+import subprocess
 from pathlib import Path
 import yaml
-from agentman.agentfile_parser import AgentfileConfig
+from agentman.agentfile_parser import AgentfileConfig, AgentfileParser
 class AgentBuilder:
     """Builds agent files from Agentfile configuration."""
-    def __init__(self, config: AgentfileConfig, output_dir: str = "output"):
+    def __init__(self, config: AgentfileConfig, output_dir: str = "output", source_dir: str = "."):
         self.config = config
         self.output_dir = Path(output_dir)
+        self.source_dir = Path(source_dir)
+        # Check if prompt.txt exists in the source directory
+        self.prompt_file_path = self.source_dir / "prompt.txt"
+        self.has_prompt_file = self.prompt_file_path.exists()
     def build_all(self):
         """Build all generated files."""
         self._ensure_output_dir()
+        self._copy_prompt_file()
         self._generate_python_agent()
         self._generate_config_yaml()
         self._generate_secrets_yaml()
         self._generate_dockerfile()
         self._generate_requirements_txt()
         self._generate_dockerignore()
+        self._validate_output()
     def _ensure_output_dir(self):
         """Ensure output directory exists."""
         self.output_dir.mkdir(exist_ok=True)
+    def _copy_prompt_file(self):
+        """Copy prompt.txt to output directory if it exists."""
+        if self.has_prompt_file:
+            import shutil
+            dest_path = self.output_dir / "prompt.txt"
+            shutil.copy2(self.prompt_file_path, dest_path)
     def _generate_python_agent(self):
         """Generate the main Python agent file."""
         content = self._build_python_content()
         agent_file = self.output_dir / "agent.py"
-        with open(agent_file, 'w') as f:
+        with open(agent_file, 'w', encoding='utf-8') as f:
             f.write(content)
     def _build_python_content(self) -> str:
@@ -71,7 +89,32 @@ class AgentBuilder:
             [
                 "async def main() -> None:",
                 "    async with fast.run() as agent:",
-                "        await agent()",
+            ]
+        )
+        # Check if prompt.txt exists and add prompt loading
+        if self.has_prompt_file:
+            lines.extend(
+                [
+                    "        # Check if prompt.txt exists and load its content",
+                    "        import os",
+                    "        prompt_file = 'prompt.txt'",
+                    "        if os.path.exists(prompt_file):",
+                    "            with open(prompt_file, 'r', encoding='utf-8') as f:",
+                    "                prompt_content = f.read().strip()",
+                    "            if prompt_content:",
+                    "                await agent(prompt_content)",
+                    "            else:",
+                    "                await agent()",
+                    "        else:",
+                    "            await agent()",
+                ]
+            )
+        else:
+            lines.extend(["        await agent()"])
+        lines.extend(
+            [
                 "",
                 "",
                 'if __name__ == "__main__":',
@@ -100,7 +143,7 @@ class AgentBuilder:
             }
         config_file = self.output_dir / "fastagent.config.yaml"
-        with open(config_file, 'w') as f:
+        with open(config_file, 'w', encoding='utf-8') as f:
             yaml.dump(config_data, f, default_flow_style=False, sort_keys=False)
     def _generate_secrets_yaml(self):
@@ -125,11 +168,12 @@ class AgentBuilder:
             secrets_data["mcp"] = {"servers": mcp_servers_env}
         secrets_file = self.output_dir / "fastagent.secrets.yaml"
-        with open(secrets_file, 'w') as f:
+        with open(secrets_file, 'w', encoding='utf-8') as f:
             f.write("# FastAgent Secrets Configuration\n")
             f.write("# WARNING: Keep this file secure and never commit to version control\n\n")
             f.write(
-                "# Alternatively set OPENAI_API_KEY and ANTHROPIC_API_KEY environment variables. Config file takes precedence.\n\n"
+                "# Alternatively set OPENAI_API_KEY and ANTHROPIC_API_KEY "
+                "environment variables. Config file takes precedence.\n\n"
             )
             yaml.dump(secrets_data, f, default_flow_style=False, sort_keys=False)
@@ -240,7 +284,10 @@ class AgentBuilder:
                 lines.append(instruction.to_dockerfile_line())
         # Add a blank line if we have custom instructions
-        if any(inst.instruction not in ["FROM", "EXPOSE", "CMD"] for inst in self.config.dockerfile_instructions):
+        custom_instructions = [
+            inst for inst in self.config.dockerfile_instructions if inst.instruction not in ["FROM", "EXPOSE", "CMD"]
+        ]
+        if custom_instructions:
             lines.append("")
         # Set working directory if not already set by custom instructions
@@ -249,15 +296,19 @@ class AgentBuilder:
             lines.extend(["WORKDIR /app", ""])
         # Copy application files
-        lines.extend(
-            [
-                "# Copy application files",
-                "COPY agent.py .",
-                "COPY fastagent.config.yaml .",
-                "COPY fastagent.secrets.yaml .",
-                "",
-            ]
-        )
+        copy_lines = [
+            "# Copy application files",
+            "COPY agent.py .",
+            "COPY fastagent.config.yaml .",
+            "COPY fastagent.secrets.yaml .",
+        ]
+        # Add prompt.txt copy if it exists
+        if self.has_prompt_file:
+            copy_lines.append("COPY prompt.txt .")
+        copy_lines.append("")
+        lines.extend(copy_lines)
         # Add EXPOSE instructions from custom dockerfile instructions first
         expose_instructions = [inst for inst in self.config.dockerfile_instructions if inst.instruction == "EXPOSE"]
@@ -279,19 +330,17 @@ class AgentBuilder:
                 lines.append(instruction.to_dockerfile_line())
         elif self.config.cmd:
             # Default command from config
-            import json
             cmd_str = json.dumps(self.config.cmd)
             lines.append(f"CMD {cmd_str}")
         dockerfile = self.output_dir / "Dockerfile"
-        with open(dockerfile, 'w') as f:
+        with open(dockerfile, 'w', encoding='utf-8') as f:
             f.write("\n".join(lines))
     def _generate_requirements_txt(self):
         """Generate the requirements.txt file."""
         requirements = [
-            "fast-agent-mcp>=0.2.30",
+            "fast-agent-mcp>=0.2.31",
             "deprecated>=1.2.18",
         ]
@@ -312,7 +361,7 @@ class AgentBuilder:
         requirements = sorted(list(set(requirements)))
         req_file = self.output_dir / "requirements.txt"
-        with open(req_file, 'w') as f:
+        with open(req_file, 'w', encoding='utf-8') as f:
             f.write("\n".join(requirements) + "\n")
     def _generate_dockerignore(self):
@@ -367,18 +416,29 @@ class AgentBuilder:
         ]
         dockerignore = self.output_dir / ".dockerignore"
-        with open(dockerignore, 'w') as f:
+        with open(dockerignore, 'w', encoding='utf-8') as f:
             f.write("\n".join(ignore_patterns))
+    def _validate_output(self):
+        """Validate that all required files were generated."""
+        # Skip validation in test environments or when fast-agent is not available
+        try:
+            subprocess.run(["fast-agent", "check"], check=True, cwd=self.output_dir, capture_output=True)
+        except (subprocess.CalledProcessError, FileNotFoundError) as e:
+            # If fast-agent is not available or validation fails, just warn but don't fail
+            print(f"⚠️  Validation skipped: {e}")
+            pass
 def build_from_agentfile(agentfile_path: str, output_dir: str = "output") -> None:
     """Build agent files from an Agentfile."""
-    from agentman.agentfile_parser import AgentfileParser
     parser = AgentfileParser()
     config = parser.parse_file(agentfile_path)
-    builder = AgentBuilder(config, output_dir)
+    # Extract source directory from agentfile path
+    source_dir = Path(agentfile_path).parent
+    builder = AgentBuilder(config, output_dir, source_dir)
     builder.build_all()
     print(f"✅ Generated agent files in {output_dir}/")
@@ -388,3 +448,7 @@ def build_from_agentfile(agentfile_path: str, output_dir: str = "output") -> Non
     print("   - Dockerfile")
     print("   - requirements.txt")
     print("   - .dockerignore")
+    # Check if prompt.txt was copied
+    if builder.has_prompt_file:
+        print("   - prompt.txt")

agentman/agentfile_parser.py CHANGED Viewed

@@ -1,3 +1,6 @@
+"""Agentfile parser module for parsing Agentfile configurations."""
+import json
 from dataclasses import dataclass, field
 from typing import Any, Dict, List, Optional, Union
@@ -39,6 +42,7 @@ class Agent:
     model: Optional[str] = None
     use_history: bool = True
     human_input: bool = False
+    default: bool = False
     def to_decorator_string(self, default_model: Optional[str] = None) -> str:
         """Generate the @fast.agent decorator string."""
@@ -57,6 +61,9 @@ class Agent:
         if self.human_input:
             params.append("human_input=True")
+        if self.default:
+            params.append("default=True")
         return "@fast.agent(\n    " + ",\n    ".join(params) + "\n)"
@@ -68,6 +75,7 @@ class Router:
     agents: List[str] = field(default_factory=list)
     model: Optional[str] = None
     instruction: Optional[str] = None
+    default: bool = False
     def to_decorator_string(self, default_model: Optional[str] = None) -> str:
         """Generate the @fast.router decorator string."""
@@ -83,6 +91,9 @@ class Router:
         if self.instruction:
             params.append(f'instruction="""{self.instruction}"""')
+        if self.default:
+            params.append("default=True")
         return "@fast.router(\n    " + ",\n    ".join(params) + "\n)"
@@ -95,6 +106,7 @@ class Chain:
     instruction: Optional[str] = None
     cumulative: bool = False
     continue_with_final: bool = True
+    default: bool = False
     def to_decorator_string(self) -> str:
         """Generate the @fast.chain decorator string."""
@@ -113,6 +125,9 @@ class Chain:
         if not self.continue_with_final:
             params.append("continue_with_final=False")
+        if self.default:
+            params.append("default=True")
         return "@fast.chain(\n    " + ",\n    ".join(params) + "\n)"
@@ -127,6 +142,7 @@ class Orchestrator:
     plan_type: str = "full"
     plan_iterations: int = 5
     human_input: bool = False
+    default: bool = False
     def to_decorator_string(self, default_model: Optional[str] = None) -> str:
         """Generate the @fast.orchestrator decorator string."""
@@ -153,6 +169,9 @@ class Orchestrator:
         if self.human_input:
             params.append("human_input=True")
+        if self.default:
+            params.append("default=True")
         return "@fast.orchestrator(\n    " + ",\n    ".join(params) + "\n)"
@@ -187,8 +206,6 @@ class DockerfileInstruction:
         """Convert to Dockerfile line format."""
         if self.instruction in ["CMD", "ENTRYPOINT"] and len(self.args) > 1:
             # Handle array format for CMD/ENTRYPOINT
-            import json
             args_str = json.dumps(self.args)
             return f"{self.instruction} {args_str}"
         return f"{self.instruction} {' '.join(self.args)}"
@@ -221,7 +238,7 @@ class AgentfileParser:
     def parse_file(self, filepath: str) -> AgentfileConfig:
         """Parse an Agentfile and return the configuration."""
-        with open(filepath, 'r') as f:
+        with open(filepath, 'r', encoding='utf-8') as f:
             content = f.read()
         return self.parse_content(content)
@@ -273,7 +290,7 @@ class AgentfileParser:
             try:
                 self._parse_line(line)
             except Exception as e:
-                raise ValueError(f"Error parsing line {line_num}: {line}\n{str(e)}")
+                raise ValueError(f"Error parsing line {line_num}: {line}\n{str(e)}") from e
         return self.config
@@ -353,6 +370,7 @@ class AgentfileParser:
             "CUMULATIVE",
             "API_KEY",
             "BASE_URL",
+            "DEFAULT",
         ]:
             self._handle_sub_instruction(instruction, parts)
         # Handle ENV - could be Dockerfile instruction or sub-instruction
@@ -364,7 +382,8 @@ class AgentfileParser:
                 # It's a Dockerfile instruction
                 self._handle_dockerfile_instruction(instruction, parts)
         else:
-            # Unknown instruction - treat as potential Dockerfile instruction for forward compatibility
+            # Unknown instruction - treat as potential Dockerfile instruction
+            # for forward compatibility
             self._handle_dockerfile_instruction(instruction, parts)
     def _split_respecting_quotes(self, line: str) -> List[str]:
@@ -500,8 +519,9 @@ class AgentfileParser:
                 self.current_context = "secret"
                 self.current_item = secret_name
             else:
-                # Create a new secret context - this will be used if subsequent lines contain key-value pairs
-                # If no key-value pairs follow, it will be treated as a simple reference
+                # Create a new secret context - this will be used if subsequent
+                # lines contain key-value pairs. If no key-value pairs follow,
+                # it will be treated as a simple reference
                 secret = SecretContext(name=secret_name)
                 self.config.secrets.append(secret)
                 self.current_context = "secret"
@@ -526,7 +546,7 @@ class AgentfileParser:
         # Handle key-value pairs like: API_KEY your_key_here
         if len(parts) >= 2:
-            key = parts[0].upper()
+            key = instruction.upper()
             value = ' '.join(parts[1:])
             secret_context.values[key] = self._unquote(value)
         else:
@@ -540,8 +560,8 @@ class AgentfileParser:
             port = int(parts[1])
             if port not in self.config.expose_ports:
                 self.config.expose_ports.append(port)
-        except ValueError:
-            raise ValueError(f"Invalid port number: {parts[1]}")
+        except ValueError as exc:
+            raise ValueError(f"Invalid port number: {parts[1]}") from exc
         self.current_context = None
     def _handle_cmd(self, parts: List[str]):
@@ -586,16 +606,15 @@ class AgentfileParser:
     def _handle_sub_instruction(self, instruction: str, parts: List[str]):
         """Handle sub-instructions that modify the current context item."""
         if not self.current_context:
-            # Special case: if we're not in a context but this looks like a key-value pair
-            # for a secret context, try to handle it
+            # Special case: if we're not in a context but this looks like
+            # a key-value pair for a secret context, try to handle it
             if self.current_item and any(
                 isinstance(s, SecretContext) and s.name == self.current_item for s in self.config.secrets
             ):
                 self.current_context = "secret"
                 self._handle_secret_sub_instruction(instruction, parts)
                 return
-            else:
-                raise ValueError(f"{instruction} can only be used within a context (SERVER, AGENT, etc.)")
+            raise ValueError(f"{instruction} can only be used within a context (SERVER, AGENT, etc.)")
         if self.current_context == "server":
             self._handle_server_sub_instruction(instruction, parts)
@@ -679,6 +698,10 @@ class AgentfileParser:
             if len(parts) < 2:
                 raise ValueError("HUMAN_INPUT requires true/false")
             agent.human_input = self._unquote(parts[1]).lower() in ['true', '1', 'yes']
+        elif instruction == "DEFAULT":
+            if len(parts) < 2:
+                raise ValueError("DEFAULT requires true/false")
+            agent.default = self._unquote(parts[1]).lower() in ['true', '1', 'yes']
     def _handle_router_sub_instruction(self, instruction: str, parts: List[str]):
         """Handle sub-instructions for ROUTER context."""
@@ -696,6 +719,10 @@ class AgentfileParser:
             if len(parts) < 2:
                 raise ValueError("INSTRUCTION requires instruction text")
             router.instruction = self._unquote(' '.join(parts[1:]))
+        elif instruction == "DEFAULT":
+            if len(parts) < 2:
+                raise ValueError("DEFAULT requires true/false")
+            router.default = self._unquote(parts[1]).lower() in ['true', '1', 'yes']
     def _handle_chain_sub_instruction(self, instruction: str, parts: List[str]):
         """Handle sub-instructions for CHAIN context."""
@@ -717,6 +744,10 @@ class AgentfileParser:
             if len(parts) < 2:
                 raise ValueError("CONTINUE_WITH_FINAL requires true/false")
             chain.continue_with_final = self._unquote(parts[1]).lower() in ['true', '1', 'yes']
+        elif instruction == "DEFAULT":
+            if len(parts) < 2:
+                raise ValueError("DEFAULT requires true/false")
+            chain.default = self._unquote(parts[1]).lower() in ['true', '1', 'yes']
     def _handle_orchestrator_sub_instruction(self, instruction: str, parts: List[str]):
         """Handle sub-instructions for ORCHESTRATOR context."""
@@ -746,9 +777,13 @@ class AgentfileParser:
                 raise ValueError("PLAN_ITERATIONS requires a number")
             try:
                 orchestrator.plan_iterations = int(parts[1])
-            except ValueError:
-                raise ValueError(f"Invalid number for PLAN_ITERATIONS: {parts[1]}")
+            except ValueError as exc:
+                raise ValueError(f"Invalid number for PLAN_ITERATIONS: {parts[1]}") from exc
         elif instruction == "HUMAN_INPUT":
             if len(parts) < 2:
                 raise ValueError("HUMAN_INPUT requires true/false")
             orchestrator.human_input = self._unquote(parts[1]).lower() in ['true', '1', 'yes']
+        elif instruction == "DEFAULT":
+            if len(parts) < 2:
+                raise ValueError("DEFAULT requires true/false")
+            orchestrator.default = self._unquote(parts[1]).lower() in ['true', '1', 'yes']

agentman/cli.py CHANGED Viewed

@@ -1,3 +1,5 @@
+"""Command-line interface for Agentman."""
 import argparse
 import errno
 import subprocess
@@ -10,7 +12,19 @@ from agentman.version import print_version
 class HelpException(Exception):
-    pass
+    """Exception raised to trigger help display."""
+class BuildArgs:
+    """Arguments for the build command.
+    This class serves as a placeholder for build-related arguments
+    and may be expanded in the future to include argument validation
+    and processing logic.
+    """
+    def __init__(self):
+        """Initialize BuildArgs."""
 def resolve_context_path(path):
@@ -37,12 +51,15 @@ def safe_subprocess_run(cmd_args, check=True):
 class ArgumentParserWithDefaults(argparse.ArgumentParser):
-    def add_argument(self, *args, help=None, default=None, completer=None, **kwargs):
-        if help is not None:
-            kwargs['help'] = help
+    """Argument parser with default value handling."""
+    def add_argument(self, *args, help_text=None, default=None, completer=None, **kwargs):
+        """Add an argument with help text and default value."""
+        if help_text is not None:
+            kwargs['help'] = help_text
         if default is not None and args[0] != '-h':
             kwargs['default'] = default
-            if help is not None and help != "==SUPPRESS==":
+            if help_text is not None and help_text != "==SUPPRESS==":
                 kwargs['help'] += f' (default: {default})'
         action = super().add_argument(*args, **kwargs)
         if completer is not None:
@@ -51,6 +68,7 @@ class ArgumentParserWithDefaults(argparse.ArgumentParser):
 def get_description():
+    """Get the description for the CLI tool."""
     return """\
 A tool for building and managing AI agents
 """
@@ -68,6 +86,7 @@ def configure_arguments(parser):
 def create_argument_parser(description):
+    """Create and configure the argument parser."""
     parser = ArgumentParserWithDefaults(
         prog="agentman",
         description=description,
@@ -78,15 +97,24 @@ def create_argument_parser(description):
 def runtime_options(parser, command):
-    """Configure runtime options for commands."""
-    # TODO: Implement runtime options configuration
-    pass
+    """Configure runtime options for commands.
+    Args:
+        parser: The argument parser to add options to
+        command: The command name (currently unused but reserved for future use)
+    """
+    # Runtime options are not yet implemented but reserved for future use
+    # when we need command-specific runtime configurations
 def post_parse_setup(args):
-    """Perform post-parse setup operations."""
-    # TODO: Implement post-parse setup
-    pass
+    """Perform post-parse setup operations.
+    Args:
+        args: Parsed command line arguments (currently unused but reserved)
+    """
+    # Post-parse setup is not yet implemented but reserved for future use
+    # when we need to perform operations after argument parsing
 def build_cli(args):
@@ -116,12 +144,13 @@ def build_cli(args):
             safe_subprocess_run(docker_cmd, check=True)
             print(f"✅ Docker image built: {args.tag}")
-    except Exception as e:
+    except (subprocess.CalledProcessError, IOError, ValueError) as e:
         perror(f"Build failed: {e}")
         sys.exit(1)
 def build_parser(subparsers):
+    """Configure the build subcommand parser."""
     parser = subparsers.add_parser("build", help="Build an image from a Agentfile")
     parser.add_argument("-f", "--file", default="Agentfile", help="Name of the Agentfile")
     parser.add_argument("-o", "--output", help="Output directory for generated files (default: agent)")
@@ -194,7 +223,7 @@ def run_cli(args):
             safe_subprocess_run(run_cmd, check=True)
-        except Exception as e:
+        except (subprocess.CalledProcessError, IOError, ValueError) as e:
             perror(f"Run failed: {e}")
             sys.exit(1)
     else:
@@ -230,32 +259,35 @@ def run_cli(args):
         try:
             safe_subprocess_run(run_cmd, check=True)
-        except Exception as e:
+        except (subprocess.CalledProcessError, IOError, ValueError) as e:
             perror(f"Run failed: {e}")
             sys.exit(1)
 def run_parser(subparsers):
+    """Configure the run subcommand parser."""
     parser = subparsers.add_parser("run", help="Create and run a new container from an agent")
     parser.add_argument("-f", "--file", default="Agentfile", help="Name of the Agentfile (when building from source)")
     parser.add_argument(
-        "-o", "--output", help="Output directory for generated files (default: agent, when building from source)"
+        "-o", "--output", help="Output directory for generated files " "(default: agent, when building from source)"
     )
     parser.add_argument("-t", "--tag", default="agent:latest", help="Name and optionally a tag for the Docker image")
     parser.add_argument(
         "--from-agentfile",
         action="store_true",
-        help="Build from Agentfile and then run (default is to run existing image)",
+        help="Build from Agentfile and then run " "(default is to run existing image)",
     )
-    parser.add_argument("--path", default=".", help="Build context (directory or URL) when building from Agentfile")
+    parser.add_argument("--path", default=".", help="Build context (directory or URL) " "when building from Agentfile")
     parser.add_argument("-i", "--interactive", action="store_true", help="Run container interactively")
     parser.add_argument(
         "--rm", dest="remove", action="store_true", help="Automatically remove the container when it exits"
     )
     parser.add_argument(
-        "-p", "--port", action="append", help="Publish container port(s) to the host (can be used multiple times)"
+        "-p", "--port", action="append", help="Publish container port(s) to the host " "(can be used multiple times)"
+    )
+    parser.add_argument(
+        "-e", "--env", action="append", help="Set environment variables " "(can be used multiple times)"
     )
-    parser.add_argument("-e", "--env", action="append", help="Set environment variables (can be used multiple times)")
     parser.add_argument("-v", "--volume", action="append", help="Bind mount volumes (can be used multiple times)")
     parser.add_argument("command", nargs="*", help="Command to run in the container (overrides default)")
     runtime_options(parser, "run")
@@ -263,15 +295,18 @@ def run_parser(subparsers):
 def version_parser(subparsers):
+    """Configure the version subcommand parser."""
     parser = subparsers.add_parser("version", help="Show the Agentman version information")
     parser.set_defaults(func=print_version)
 def help_cli(args):
+    """Handle the help command by raising HelpException."""
     raise HelpException()
 def help_parser(subparsers):
+    """Configure the help subcommand parser."""
     parser = subparsers.add_parser("help")
     # Do not run in a container
     parser.set_defaults(func=help_cli)
@@ -293,6 +328,7 @@ def parse_arguments(parser):
 def init_cli():
+    """Initialize the CLI by setting up argument parser and parsing arguments."""
     description = get_description()
     parser = create_argument_parser(description)
     configure_subcommands(parser)
@@ -302,6 +338,7 @@ def init_cli():
 def main():
+    """Main entry point for the CLI application."""
     parser, args = init_cli()
     def eprint(e, exit_code):

agentman/common.py CHANGED Viewed

@@ -1,5 +1,13 @@
+"""Common utilities for Agentman."""
 import sys
 def perror(*args, **kwargs):
+    """Print error message to stderr.
+    Args:
+        *args: Arguments to pass to print()
+        **kwargs: Keyword arguments to pass to print()
+    """
     print(*args, file=sys.stderr, **kwargs)

agentman/version.py CHANGED Viewed

@@ -1,9 +1,14 @@
+"""Version information for Agentman."""
 def version():
-    return "0.1.3"
+    """Return the current version of Agentman."""
+    return "0.1.5"
 def print_version(args):
+    """Print the version information."""
     if args.quiet:
         print(version())
     else:
-        print("agentman version %s" % version())
+        print(f"agentman version {version()}")

agentman-mcp 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl

agentman-mcp 0.1.3py3-none-any.whl → 0.1.5py3-none-any.whl