merge and move logic to framework abstraction

Author: bboynton97

.github/workflows/codecov.yml

@@ -31,7 +31,7 @@ jobs:
         pip install tox
 
     - name: Run tests with tox
-      run: tox
+      run: tox -m quick  # quick runs all 3.12 tests and then combines coverage
 
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v5

.github/workflows/compile-llms-txt.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Compile llms.txt
         run: |
           cd docs
-          python compile_llms.py
+          python compile_llms_txt.py
       - name: Commit and push changes
         run: |
           git config --local user.email "action@github.com"

.gitignore

@@ -175,6 +175,8 @@ ex/
 **/ex/
 cookiecutter.json
 
+tests/tmp
+
 examples/tests/
 examples/tests/**/*
 

MANIFEST.in

@@ -1,3 +1,4 @@
 recursive-include agentstack/templates *
+recursive-include agentstack/frameworks/templates *
 recursive-include agentstack/_tools *
 include agentstack.json .env .env.example

README.md

@@ -32,7 +32,7 @@ AgentStack scaffolds your _agent stack_ - the tech stack that collectively is yo
 
 ### Currently Supported Providers
 - **LLMs**: Most all notable LLMs and providers are supported via LiteLLM or LangChain
-- **Framework**: Currently supported frameworks include CrewAI and LangGraph
+- **Framework**: Currently supported frameworks include CrewAI, LangGraph, OpenAI Swarms and LlamaStack
   - Roadmap: Pydantic AI, Eliza, AG2 and Autogen
 - **Tools**: Maintaining the largest repository of framework-agnostic tools! All tools listed [here](https://docs.agentstack.sh/tools/community)
 - **Observability**: AgentOps baked in by default with first-tier support
@@ -145,6 +145,6 @@ AgentStack is open source software [licensed as MIT](LICENSE).
 
 ## How to Contribute
 
-AgentStack is a new project built by passionate AI agent developers! We'd love help making this tool better. Easy first issues are available, create new issues with feature ideas, or chat with us on our [Discord](https://discord.gg/JdWkh9tgTQ).
+AgentStack is a new project built by passionate AI agent developers! We'd love help making this tool better. Easy first issues are available, create new issues with feature ideas, or chat with us on our [Discord](https://discord.gg/JdWkh9tgTQ). Make sure you read our contributor documentation to familiarize yourself with the project at [How to Contribute](https://docs.agentstack.sh/contributing/how-to-contribute).
 
 If you are an Agent Tool developer, feel free to create an issue or even a PR to add your tool to AgentStack. 

agentstack/__init__.py

@@ -9,8 +9,8 @@
 from pathlib import Path
 from agentstack import conf
 from agentstack.utils import get_framework
-from agentstack.agents import get_agent
-from agentstack.tasks import get_task
+from agentstack.agents import get_agent, get_all_agents, get_all_agent_names
+from agentstack.tasks import get_task, get_all_tasks, get_all_task_names
 from agentstack.inputs import get_inputs
 from agentstack import frameworks
 
@@ -22,7 +22,11 @@
     "get_tags", 
     "get_framework", 
     "get_agent", 
+    "get_all_agents",
+    "get_all_agent_names",
     "get_task", 
+    "get_all_tasks",
+    "get_all_task_names",
     "get_inputs", 
 ]
 

agentstack/_tools/file_read/config.json

@@ -3,6 +3,6 @@
   "category": "computer-control",
   "tools": ["read_file"],
   "description": "Read contents of files",
-  "url": "https://github.com/AgentOps-AI/AgentStack/tree/main/agentstack/tools/file_read",
+  "url": "https://docs.agentstack.sh/tools/tool/file_read",
   "dependencies": []
 }

agentstack/_tools/payman/__init__.py

@@ -0,0 +1,209 @@
+import os
+from typing import Dict, List, Optional, Union, Literal
+from paymanai import Paymanai
+
+# Initialize Payman client
+PAYMAN_API_SECRET = os.getenv("PAYMAN_API_SECRET")
+PAYMAN_ENVIRONMENT = os.getenv("PAYMAN_ENVIRONMENT", "sandbox")
+
+client = Paymanai(
+    x_payman_api_secret=PAYMAN_API_SECRET,
+    environment=PAYMAN_ENVIRONMENT
+)
+
+def send_payment(
+    amount_decimal: float,
+    payment_destination_id: str,
+    customer_email: Optional[str] = None,
+    customer_id: Optional[str] = None,
+    customer_name: Optional[str] = None,
+    memo: Optional[str] = None
+) -> Dict:
+    """
+    Send USD from the agent's wallet to a pre-created payment destination.
+    
+    Args:
+        amount_decimal: Amount to send in USD (e.g. 10.00 for $10.00)
+        payment_destination_id: ID of the pre-created payment destination
+        customer_email: Optional email address of the customer
+        customer_id: Optional ID of the customer
+        customer_name: Optional name of the customer
+        memo: Optional note or memo for the payment
+    
+    Returns:
+        Dictionary containing payment details
+    """
+    try:
+        return client.payments.send_payment(
+            amount_decimal=amount_decimal,
+            payment_destination_id=payment_destination_id,
+            customer_email=customer_email,
+            customer_id=customer_id,
+            customer_name=customer_name,
+            memo=memo
+        )
+    except Exception as e:
+        return {"error": f"Failed to send payment: {str(e)}"}
+
+def search_destinations(
+    name: Optional[str] = None,
+    customer_id: Optional[str] = None,
+    contact_email: Optional[str] = None,
+) -> List[Dict]:
+    """
+    Search for existing payment destinations by name, customer, or email.
+    
+    Args:
+        name: Optional name of the payment destination
+        customer_id: Optional customer ID who owns the destination
+        contact_email: Optional contact email to search for
+    
+    Returns:
+        List of matching payment destinations with their IDs
+    """
+    try:
+        return client.payments.search_destinations(
+            name=name,
+            customer_id=customer_id,
+            contact_email=contact_email
+        )
+    except Exception as e:
+        return [{"error": f"Failed to search destinations: {str(e)}"}]
+
+def create_payee(
+    type: Literal["US_ACH", "PAYMAN_AGENT"],
+    name: str,
+    customer_id: Optional[str] = None,
+    account_holder_name: Optional[str] = None,
+    account_holder_type: Optional[Literal["individual", "business"]] = None,
+    account_number: Optional[str] = None,
+    routing_number: Optional[str] = None,
+    account_type: Optional[Literal["checking", "savings"]] = None,
+    payman_agent_id: Optional[str] = None,
+    contact_details: Optional[Dict] = None
+) -> Dict:
+    """
+    Create a new payment destination for future USD payments.
+    
+    Args:
+        type: Type of payment destination ("US_ACH" or "PAYMAN_AGENT")
+        name: Name for the payment destination
+        customer_id: Customer ID who owns this destination (required for US_ACH)
+        account_holder_name: Name of the account holder (required for US_ACH)
+        account_holder_type: Type of account holder ("individual" or "business") (required for US_ACH)
+        account_number: Bank account number (required for US_ACH)
+        routing_number: Bank routing number (required for US_ACH)
+        account_type: Type of bank account ("checking" or "savings") (required for US_ACH)
+        payman_agent_id: The unique ID of the receiving agent (required for PAYMAN_AGENT)
+        contact_details: Optional dictionary containing contact information
+    
+    Returns:
+        Dictionary containing the created payee details
+    """
+    try:
+        params = {
+            "type": type,
+            "name": name,
+            "contact_details": contact_details
+        }
+        
+        if type == "US_ACH":
+            params.update({
+                "customer_id": customer_id,
+                "account_holder_name": account_holder_name,
+                "account_holder_type": account_holder_type,
+                "account_number": account_number,
+                "routing_number": routing_number,
+                "account_type": account_type
+            })
+        elif type == "PAYMAN_AGENT":
+            params.update({
+                "payman_agent_id": payman_agent_id
+            })
+            
+        return client.payments.create_payee(params)
+    except Exception as e:
+        return {"error": f"Failed to create payee: {str(e)}"}
+
+def initiate_customer_deposit(
+    amount_decimal: float,
+    customer_id: str,
+    customer_email: Optional[str] = None,
+    customer_name: Optional[str] = None,
+    fee_mode: Optional[Literal["INCLUDED_IN_AMOUNT", "ADD_TO_AMOUNT"]] = None,
+    memo: Optional[str] = None,
+    wallet_id: Optional[str] = None
+) -> Dict:
+    """
+    Generate a checkout link for customer USD deposits.
+    
+    Args:
+        amount_decimal: Amount to deposit in USD (e.g. 10.00 for $10.00)
+        customer_id: ID of the customer to deposit funds for
+        customer_email: Optional email address of the customer
+        customer_name: Optional name of the customer
+        fee_mode: How to handle processing fees ("INCLUDED_IN_AMOUNT" or "ADD_TO_AMOUNT")
+        memo: Optional memo for the transaction
+        wallet_id: Optional ID of specific wallet to deposit to
+    
+    Returns:
+        Dictionary containing the checkout URL
+    """
+    try:
+        response = client.payments.initiate_customer_deposit(
+            amount_decimal=amount_decimal,
+            customer_id=customer_id,
+            customer_email=customer_email,
+            customer_name=customer_name,
+            fee_mode=fee_mode,
+            memo=memo,
+            wallet_id=wallet_id
+        )
+        return response
+    except Exception as e:
+        return {"error": f"Failed to generate deposit link: {str(e)}"}
+
+def get_customer_balance(
+    customer_id: str,
+    currency: Literal["USD"] = "USD"
+) -> Dict:
+    """
+    Check customer's available USD balance.
+    
+    Args:
+        customer_id: ID of the customer to check balance for
+        currency: Currency code (always USD)
+    
+    Returns:
+        Dictionary containing balance information
+    """
+    try:
+        response = client.balances.get_customer_balance(customer_id, currency)
+        return {
+            "spendable_balance": response,
+            "currency": currency,
+            "customer_id": customer_id
+        }
+    except Exception as e:
+        return {"error": f"Failed to get customer balance: {str(e)}"}
+
+def get_spendable_balance(
+    currency: Literal["USD"] = "USD"
+) -> Dict:
+    """
+    Check agent's available USD balance.
+    
+    Args:
+        currency: Currency code (always USD)
+    
+    Returns:
+        Dictionary containing balance information
+    """
+    try:
+        response = client.balances.get_spendable_balance(currency)
+        return {
+            "spendable_balance": response,
+            "currency": currency
+        }
+    except Exception as e:
+        return {"error": f"Failed to get spendable balance: {str(e)}"}

agentstack/_tools/payman/config.json

@@ -0,0 +1,18 @@
+{
+  "name": "payman",
+  "category": "financial-infra",
+  "tools": [
+    "send_payment",
+    "search_available_payees",
+    "add_payee",
+    "ask_for_money",
+    "get_balance"
+  ],
+  "url": "https://www.paymanai.com",
+  "cta": "Setup your Agents Payman account at https://app.paymanai.com",
+  "env": {
+    "PAYMAN_API_SECRET": null,
+    "PAYMAN_ENVIRONMENT": null
+  },
+  "dependencies": ["paymanai>=2.1.0"]
+}