supyagent 0.2.0__tar.gz → 0.2.1__tar.gz

{supyagent-0.2.0 → supyagent-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supyagent
-Version: 0.2.0
+Version: 0.2.1
 Summary: LLM agents powered by supypowers - build AI agents with tool use, multi-agent orchestration, and secure credential management
 Project-URL: Homepage, https://github.com/ergodic-ai/supyagent
 Project-URL: Documentation, https://github.com/ergodic-ai/supyagent#readme
@@ -68,6 +68,9 @@ uv pip install supyagent
 ## Quick Start
 
 ```bash
+# Initialize supyagent (sets up default tools)
+supyagent init
+
 # Set up your API key (stored securely)
 supyagent config set ANTHROPIC_API_KEY
 
@@ -229,6 +232,7 @@ delegates:
 
 | Command | Description |
 |---------|-------------|
+| `supyagent init` | Initialize project with default tools |
 | `supyagent new <name>` | Create a new agent |
 | `supyagent list` | List all agents |
 | `supyagent show <name>` | Show agent details |
@@ -281,6 +285,25 @@ While chatting, use these commands:
 | `/clear` | Clear conversation history |
 | `/quit` | Exit the chat |
 
+## Bundled Tools
+
+Running `supyagent init` installs these default tools:
+
+### Shell (`shell.py`)
+- `run_command` - Execute shell commands
+- `run_script` - Run multi-line bash scripts
+- `which` - Find executable paths
+- `get_env` - Get environment variables
+
+### Files (`files.py`)
+- `read_file` / `write_file` - File I/O
+- `list_directory` - List files with glob patterns
+- `copy_file` / `move_file` / `delete_file` - File operations
+- `create_directory` - Create directories
+- `file_info` - Get file metadata
+
+You can add your own tools by creating Python files in `supypowers/`.
+
 ## Project Structure
 
 ```
@@ -290,8 +313,9 @@ your-project/
 │   ├── planner.yaml
 │   └── researcher.yaml
 ├── supypowers/          # Tool definitions (Python)
-│   ├── hello.py
-│   └── web_search.py
+│   ├── shell.py         # Shell commands (bundled)
+│   ├── files.py         # File operations (bundled)
+│   └── my_tools.py      # Your custom tools
 └── .supyagent/          # Runtime data (gitignore this)
     ├── sessions/        # Conversation history
     ├── credentials/     # Encrypted secrets

{supyagent-0.2.0 → supyagent-0.2.1}/README.md

@@ -32,6 +32,9 @@ uv pip install supyagent
 ## Quick Start
 
 ```bash
+# Initialize supyagent (sets up default tools)
+supyagent init
+
 # Set up your API key (stored securely)
 supyagent config set ANTHROPIC_API_KEY
 
@@ -193,6 +196,7 @@ delegates:
 
 | Command | Description |
 |---------|-------------|
+| `supyagent init` | Initialize project with default tools |
 | `supyagent new <name>` | Create a new agent |
 | `supyagent list` | List all agents |
 | `supyagent show <name>` | Show agent details |
@@ -245,6 +249,25 @@ While chatting, use these commands:
 | `/clear` | Clear conversation history |
 | `/quit` | Exit the chat |
 
+## Bundled Tools
+
+Running `supyagent init` installs these default tools:
+
+### Shell (`shell.py`)
+- `run_command` - Execute shell commands
+- `run_script` - Run multi-line bash scripts
+- `which` - Find executable paths
+- `get_env` - Get environment variables
+
+### Files (`files.py`)
+- `read_file` / `write_file` - File I/O
+- `list_directory` - List files with glob patterns
+- `copy_file` / `move_file` / `delete_file` - File operations
+- `create_directory` - Create directories
+- `file_info` - Get file metadata
+
+You can add your own tools by creating Python files in `supypowers/`.
+
 ## Project Structure
 
 ```
@@ -254,8 +277,9 @@ your-project/
 │   ├── planner.yaml
 │   └── researcher.yaml
 ├── supypowers/          # Tool definitions (Python)
-│   ├── hello.py
-│   └── web_search.py
+│   ├── shell.py         # Shell commands (bundled)
+│   ├── files.py         # File operations (bundled)
+│   └── my_tools.py      # Your custom tools
 └── .supyagent/          # Runtime data (gitignore this)
     ├── sessions/        # Conversation history
     ├── credentials/     # Encrypted secrets

{supyagent-0.2.0 → supyagent-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "supyagent"
-version = "0.2.0"
+version = "0.2.1"
 description = "LLM agents powered by supypowers - build AI agents with tool use, multi-agent orchestration, and secure credential management"
 readme = "README.md"
 requires-python = ">=3.11"

{supyagent-0.2.0 → supyagent-0.2.1}/supyagent/cli/main.py

@@ -21,13 +21,14 @@ from supyagent.core.config import ConfigManager, load_config
 from supyagent.core.executor import ExecutionRunner
 from supyagent.core.registry import AgentRegistry
 from supyagent.core.session_manager import SessionManager
+from supyagent.default_tools import install_default_tools, list_default_tools
 from supyagent.models.agent_config import AgentNotFoundError, load_agent_config
 
 console = Console()
 
 
 @click.group()
-@click.version_option(version="0.2.0", prog_name="supyagent")
+@click.version_option(version="0.2.1", prog_name="supyagent")
 def cli():
     """
     Supyagent - LLM agents powered by supypowers.
@@ -37,12 +38,82 @@ def cli():
     Quick start:
 
     \b
+        supyagent init            # Set up default tools
+        supyagent config set      # Configure API keys
         supyagent new myagent     # Create an agent
         supyagent chat myagent    # Start chatting
     """
     pass
 
 
+@cli.command()
+@click.option(
+    "--tools-dir",
+    "-t",
+    default="supypowers",
+    help="Directory for tools (default: supypowers/)",
+)
+@click.option(
+    "--force",
+    "-f",
+    is_flag=True,
+    help="Overwrite existing files",
+)
+def init(tools_dir: str, force: bool):
+    """
+    Initialize supyagent in the current directory.
+
+    This sets up:
+    - Default tools in supypowers/ (shell commands, file operations)
+    - agents/ directory for agent configurations
+
+    \b
+    Examples:
+        supyagent init
+        supyagent init --tools-dir my_tools
+    """
+    console.print("[bold]Initializing supyagent...[/bold]")
+    console.print()
+
+    # Create agents directory
+    agents_dir = Path("agents")
+    if not agents_dir.exists():
+        agents_dir.mkdir(parents=True)
+        console.print(f"  [green]✓[/green] Created {agents_dir}/")
+    else:
+        console.print(f"  [dim]○[/dim] {agents_dir}/ already exists")
+
+    # Install default tools
+    tools_path = Path(tools_dir)
+
+    if force:
+        # Remove and reinstall
+        import shutil
+
+        if tools_path.exists():
+            shutil.rmtree(tools_path)
+
+    if tools_path.exists() and any(tools_path.glob("*.py")):
+        console.print(f"  [dim]○[/dim] {tools_dir}/ already has tools")
+    else:
+        count = install_default_tools(tools_path)
+        console.print(
+            f"  [green]✓[/green] Installed {count} default tools to {tools_dir}/"
+        )
+
+    # Show available tools
+    console.print()
+    console.print("[bold]Available tools:[/bold]")
+    for tool in list_default_tools():
+        console.print(f"  • [cyan]{tool['name']}[/cyan]: {tool['description']}")
+
+    console.print()
+    console.print("[bold]Next steps:[/bold]")
+    console.print("  1. Configure your API key:  [cyan]supyagent config set[/cyan]")
+    console.print("  2. Create an agent:         [cyan]supyagent new myagent[/cyan]")
+    console.print("  3. Start chatting:          [cyan]supyagent chat myagent[/cyan]")
+
+
 @cli.command()
 @click.argument("name")
 @click.option(

supyagent-0.2.1/supyagent/default_tools/__init__.py

@@ -0,0 +1,74 @@
+"""
+Default supypowers tools bundled with supyagent.
+
+These tools are copied to the user's project when running `supyagent init`.
+"""
+
+import shutil
+from pathlib import Path
+
+# Path to the bundled default tools
+TOOLS_DIR = Path(__file__).parent
+
+
+def get_bundled_tools() -> list[Path]:
+    """Get list of bundled tool files."""
+    return [f for f in TOOLS_DIR.glob("*.py") if f.name != "__init__.py"]
+
+
+def install_default_tools(target_dir: Path | str = "supypowers") -> int:
+    """
+    Install default tools to a target directory.
+
+    Args:
+        target_dir: Directory to install tools to (default: supypowers/)
+
+    Returns:
+        Number of files installed
+    """
+    target = Path(target_dir)
+    target.mkdir(parents=True, exist_ok=True)
+
+    installed = 0
+    for tool_file in get_bundled_tools():
+        dest = target / tool_file.name
+        if not dest.exists():
+            shutil.copy(tool_file, dest)
+            installed += 1
+
+    # Create __init__.py if not exists
+    init_file = target / "__init__.py"
+    if not init_file.exists():
+        init_file.write_text('"""Supypowers tools for this project."""\n')
+        installed += 1
+
+    return installed
+
+
+def list_default_tools() -> list[dict]:
+    """
+    List available default tools.
+
+    Returns:
+        List of tool info dicts
+    """
+    tools = []
+    for tool_file in get_bundled_tools():
+        # Read first docstring
+        content = tool_file.read_text()
+        description = ""
+        if '"""' in content:
+            start = content.find('"""') + 3
+            end = content.find('"""', start)
+            if end > start:
+                description = content[start:end].strip().split("\n")[0]
+
+        tools.append(
+            {
+                "name": tool_file.stem,
+                "file": tool_file.name,
+                "description": description,
+            }
+        )
+
+    return tools