devpy-cli 1.0.2__tar.gz → 1.0.3__tar.gz

{devpy_cli-1.0.2 → devpy_cli-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devpy-cli
-Version: 1.0.2
+Version: 1.0.3
 Summary: AI-powered DevOps CLI Assistant for local and remote Docker management
 Author-email: Eddy Ortega <atrox390@gmail.com>
 License: MIT
@@ -283,6 +283,49 @@ The permission log still records what *would* have been executed.
 
 ---
 
+### Built-in Tools
+
+DevPy CLI exposes a set of Docker-focused tools that the agent can call to fulfill your requests:
+
+- **check_resource**  
+  Shows CPU, memory, and disk usage of the local host.
+
+- **get_docker_logs**  
+  Retrieves the last logs of a container (`tail` configurable).
+
+- **list_containers**  
+  Lists active Docker containers with their current status.
+
+- **inspect_container**  
+  Returns low-level attributes and configuration of a container.
+
+- **restart_docker_container**  
+  Restarts a container, going through the permission system before execution.
+
+- **create_container**  
+  Creates and starts a new container from a given image and name.  
+  If the image is not present locally, it is automatically pulled first.
+
+- **delete_container**  
+  Stops and removes the specified container (with confirmation).
+
+- **stop_container**  
+  Gracefully stops a running container.
+
+- **start_monitoring**  
+  Starts a background memory monitor for a container and alerts if usage crosses a threshold.
+
+- **exec_command**  
+  Executes a shell command inside a container. Commands are sanitized to block chaining and substitution.
+
+- **download_image**  
+  Downloads (pulls) a Docker image from a registry.
+
+- **delete_image**  
+  Deletes a Docker image if it exists, behind the same permission and logging layer.
+
+---
+
 ## Authentication and Security
 
 - **LLM API Authentication**

{devpy_cli-1.0.2 → devpy_cli-1.0.3}/README.md

@@ -258,6 +258,49 @@ The permission log still records what *would* have been executed.
 
 ---
 
+### Built-in Tools
+
+DevPy CLI exposes a set of Docker-focused tools that the agent can call to fulfill your requests:
+
+- **check_resource**  
+  Shows CPU, memory, and disk usage of the local host.
+
+- **get_docker_logs**  
+  Retrieves the last logs of a container (`tail` configurable).
+
+- **list_containers**  
+  Lists active Docker containers with their current status.
+
+- **inspect_container**  
+  Returns low-level attributes and configuration of a container.
+
+- **restart_docker_container**  
+  Restarts a container, going through the permission system before execution.
+
+- **create_container**  
+  Creates and starts a new container from a given image and name.  
+  If the image is not present locally, it is automatically pulled first.
+
+- **delete_container**  
+  Stops and removes the specified container (with confirmation).
+
+- **stop_container**  
+  Gracefully stops a running container.
+
+- **start_monitoring**  
+  Starts a background memory monitor for a container and alerts if usage crosses a threshold.
+
+- **exec_command**  
+  Executes a shell command inside a container. Commands are sanitized to block chaining and substitution.
+
+- **download_image**  
+  Downloads (pulls) a Docker image from a registry.
+
+- **delete_image**  
+  Deletes a Docker image if it exists, behind the same permission and logging layer.
+
+---
+
 ## Authentication and Security
 
 - **LLM API Authentication**

{devpy_cli-1.0.2 → devpy_cli-1.0.3}/backend.py

@@ -233,9 +233,34 @@ def restart_docker_container(container_name: str) -> str:
   )
 
 
+@tool
+def download_image(image_name: str) -> str:
+  """Downloads a Docker image from a registry"""
+  command_preview = build_command_preview(['docker', 'pull', image_name])
+
+  def action():
+    client = get_docker_client()
+    client.images.pull(image_name)
+    return f'Image {image_name} downloaded'
+
+  return permission_manager.execute(
+    operation='download_image',
+    fn=action,
+    fn_kwargs={},
+    command_preview=command_preview,
+    impact='Downloads a Docker image',
+    command_key=f'download:{image_name}',
+    prompt_func=permission_prompt,
+  )
+
+
 @tool
 def create_container(container_image: str, container_name: str) -> str:
   """Creates and starts a new Docker container with given image and name"""
+  images = get_docker_client().images.list()
+  if container_image not in [img.tags[0] for img in images]:
+    download_image(container_image)
+
   command_preview = build_command_preview(['docker', 'run', '-d', '--name', container_name, container_image])
 
   def action():
@@ -383,6 +408,34 @@ def exec_command(container_name: str, command: str) -> str:
   )
 
 
+@tool
+def delete_image(image_name: str) -> str:
+  """Deletes a Docker image if it exists"""
+  images = get_docker_client().images.list()
+  if image_name not in [img.tags[0] for img in images]:
+    return f'Image {image_name} not found'
+
+  command_preview = build_command_preview(['docker', 'rmi', image_name])
+
+  def action():
+    client = get_docker_client()
+    try:
+      client.images.remove(image_name)
+      return f'Image {image_name} deleted'
+    except docker.errors.ImageNotFound:
+      return f'Image {image_name} not found'
+
+  return permission_manager.execute(
+    operation='delete_image',
+    fn=action,
+    fn_kwargs={},
+    command_preview=command_preview,
+    impact='Deletes the specified Docker image if it exists',
+    command_key=f'delete_image:{image_name}',
+    prompt_func=permission_prompt,
+  )
+
+
 tools = [
   check_resource,
   get_docker_logs,
@@ -394,6 +447,8 @@ tools = [
   stop_container,
   start_monitoring,
   exec_command,
+  download_image,
+  delete_image,
 ]
 
 

{devpy_cli-1.0.2 → devpy_cli-1.0.3}/devpy_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devpy-cli
-Version: 1.0.2
+Version: 1.0.3
 Summary: AI-powered DevOps CLI Assistant for local and remote Docker management
 Author-email: Eddy Ortega <atrox390@gmail.com>
 License: MIT
@@ -283,6 +283,49 @@ The permission log still records what *would* have been executed.
 
 ---
 
+### Built-in Tools
+
+DevPy CLI exposes a set of Docker-focused tools that the agent can call to fulfill your requests:
+
+- **check_resource**  
+  Shows CPU, memory, and disk usage of the local host.
+
+- **get_docker_logs**  
+  Retrieves the last logs of a container (`tail` configurable).
+
+- **list_containers**  
+  Lists active Docker containers with their current status.
+
+- **inspect_container**  
+  Returns low-level attributes and configuration of a container.
+
+- **restart_docker_container**  
+  Restarts a container, going through the permission system before execution.
+
+- **create_container**  
+  Creates and starts a new container from a given image and name.  
+  If the image is not present locally, it is automatically pulled first.
+
+- **delete_container**  
+  Stops and removes the specified container (with confirmation).
+
+- **stop_container**  
+  Gracefully stops a running container.
+
+- **start_monitoring**  
+  Starts a background memory monitor for a container and alerts if usage crosses a threshold.
+
+- **exec_command**  
+  Executes a shell command inside a container. Commands are sanitized to block chaining and substitution.
+
+- **download_image**  
+  Downloads (pulls) a Docker image from a registry.
+
+- **delete_image**  
+  Deletes a Docker image if it exists, behind the same permission and logging layer.
+
+---
+
 ## Authentication and Security
 
 - **LLM API Authentication**

{devpy_cli-1.0.2 → devpy_cli-1.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devpy-cli"
-version = "1.0.2"
+version = "1.0.3"
 description = "AI-powered DevOps CLI Assistant for local and remote Docker management"
 readme = "README.md"
 authors = [{ name = "Eddy Ortega", email = "atrox390@gmail.com" }]