supyagent 0.2.0__tar.gz → 0.2.2__tar.gz

{supyagent-0.2.0 → supyagent-0.2.2}/.gitignore

@@ -38,6 +38,7 @@ ENV/
 # Environment variables
 .env
 .env.local
+.env.supyagent
 
 # Test artifacts
 .pytest_cache/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: supyagent
-Version: 0.2.0
+Version: 0.2.2
 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.2}/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.2/agents/tester.yaml

@@ -0,0 +1,23 @@
+name: tester
+description: A test agent to verify supyagent works
+version: "1.0"
+type: interactive
+
+model:
+  provider: openrouter/moonshotai/kimi-k2.5
+  temperature: 0.7
+  max_tokens: 4096
+
+system_prompt: |
+  You are a helpful AI assistant for testing supyagent.
+  You have access to shell commands and file operations.
+  
+  When asked to do something, use the available tools.
+  Be concise in your responses.
+
+tools:
+  allow:
+    - "*"
+
+limits:
+  max_tool_calls_per_turn: 10

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

@@ -1,6 +1,6 @@
 [project]
 name = "supyagent"
-version = "0.2.0"
+version = "0.2.2"
 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.2}/supyagent/cli/main.py

@@ -21,13 +21,15 @@ 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()
+console_err = Console(stderr=True)
 
 
 @click.group()
-@click.version_option(version="0.2.0", prog_name="supyagent")
+@click.version_option(version="0.2.2", prog_name="supyagent")
 def cli():
     """
     Supyagent - LLM agents powered by supypowers.
@@ -37,12 +39,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(
@@ -636,15 +708,14 @@ def run(
     try:
         config = load_agent_config(agent_name)
     except AgentNotFoundError as e:
-        console.print(f"[red]Error:[/red] {e}", err=True)
+        console_err.print(f"[red]Error:[/red] {e}")
         sys.exit(1)
 
     # Warn if using interactive agent in execution mode
     if config.type != "execution" and not quiet:
-        console.print(
+        console_err.print(
             f"[yellow]Note:[/yellow] '{agent_name}' is an interactive agent. "
-            "Consider using 'chat' for interactive use.",
-            err=True,
+            "Consider using 'chat' for interactive use."
         )
 
     # Parse secrets
@@ -659,9 +730,7 @@ def run(
         else:
             input_path = Path(input_file)
             if not input_path.exists():
-                console.print(
-                    f"[red]Error:[/red] File not found: {input_file}", err=True
-                )
+                console_err.print(f"[red]Error:[/red] File not found: {input_file}")
                 sys.exit(1)
             task_content = input_path.read_text().strip()
     elif task:
@@ -675,22 +744,21 @@ def run(
         if not sys.stdin.isatty():
             task_content = sys.stdin.read().strip()
         else:
-            console.print(
+            console_err.print(
                 "[red]Error:[/red] No task provided. "
-                "Use positional argument, --input, or pipe to stdin.",
-                err=True,
+                "Use positional argument, --input, or pipe to stdin."
             )
             sys.exit(1)
 
     if not task_content:
-        console.print("[red]Error:[/red] Empty task", err=True)
+        console_err.print("[red]Error:[/red] Empty task")
         sys.exit(1)
 
     # Run the agent
     runner = ExecutionRunner(config)
 
     if not quiet:
-        console.print(f"[dim]Running {agent_name}...[/dim]", err=True)
+        console_err.print(f"[dim]Running {agent_name}...[/dim]")
 
     result = runner.run(task_content, secrets=secrets_dict, output_format=output_format)
 
@@ -700,7 +768,7 @@ def run(
     elif result["ok"]:
         click.echo(result["data"])
     else:
-        console.print(f"[red]Error:[/red] {result['error']}", err=True)
+        console_err.print(f"[red]Error:[/red] {result['error']}")
         sys.exit(1)
 
 
@@ -756,7 +824,7 @@ def batch(
     try:
         config = load_agent_config(agent_name)
     except AgentNotFoundError as e:
-        console.print(f"[red]Error:[/red] {e}", err=True)
+        console_err.print(f"[red]Error:[/red] {e}")
         sys.exit(1)
 
     # Parse secrets

{supyagent-0.2.0 → supyagent-0.2.2}/supyagent/core/llm.py

@@ -4,9 +4,13 @@ LiteLLM wrapper for unified LLM access.
 
 from typing import Any
 
+import litellm
 from litellm import completion
 from litellm.types.utils import ModelResponse
 
+# Suppress LiteLLM debug messages (e.g., "Provider List: ...")
+litellm.suppress_debug_info = True
+
 
 class LLMClient:
     """

{supyagent-0.2.0 → supyagent-0.2.2}/supyagent/core/tools.py

@@ -193,43 +193,61 @@ def supypowers_to_openai_tools(sp_tools: list[dict[str, Any]]) -> list[dict[str,
     Convert supypowers tool definitions to OpenAI function calling format.
 
     Supypowers docs output format:
-    {
-        "script": "hello",
-        "function": "hello",
-        "description": "...",
-        "input_schema": {...}
-    }
+    [
+        {
+            "script": "/path/to/script.py",
+            "functions": [
+                {
+                    "name": "function_name",
+                    "description": "...",
+                    "input_schema": {...}
+                }
+            ]
+        }
+    ]
 
     OpenAI format:
     {
         "type": "function",
         "function": {
-            "name": "hello__hello",
+            "name": "script__function_name",
             "description": "...",
             "parameters": {...}
         }
     }
     """
+    import os
+    
     openai_tools = []
 
-    for sp_tool in sp_tools:
-        script = sp_tool.get("script", "")
-        func = sp_tool.get("function", "")
-        description = sp_tool.get("description", "No description")
-        input_schema = sp_tool.get("input_schema", {"type": "object", "properties": {}})
-
-        # Use double underscore to join script:function (since : isn't allowed in function names)
-        name = f"{script}__{func}"
-
-        openai_tool = {
-            "type": "function",
-            "function": {
-                "name": name,
-                "description": description,
-                "parameters": input_schema,
-            },
-        }
+    for script_entry in sp_tools:
+        script_path = script_entry.get("script", "")
+        functions = script_entry.get("functions", [])
+        
+        # Extract script name from path (e.g., "files" from "/path/to/files.py")
+        script_name = os.path.splitext(os.path.basename(script_path))[0]
+        
+        # Skip __init__ files with no functions
+        if script_name == "__init__" and not functions:
+            continue
+        
+        for func_def in functions:
+            func_name = func_def.get("name", "")
+            description = func_def.get("description", "No description")
+            input_schema = func_def.get("input_schema", {"type": "object", "properties": {}})
+
+            # Use double underscore to join script:function (since : isn't allowed in function names)
+            name = f"{script_name}__{func_name}"
+
+            openai_tool = {
+                "type": "function",
+                "function": {
+                    "name": name,
+                    "description": description,
+                    "parameters": input_schema,
+                },
+            }
 
-        openai_tools.append(openai_tool)
+            openai_tools.append(openai_tool)
 
     return openai_tools

supyagent-0.2.2/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