langchain-agentpayment 0.1.0__tar.gz

langchain_agentpayment-0.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: langchain-agentpayment
+Version: 0.1.0
+Summary: LangChain tools for AgentPayment Network — autonomous agent-to-agent payments
+Home-page: https://github.com/SuryaRaut/agent-payment-network
+Author: AgentPayment Network
+Author-email: support@agentpayment.network
+Keywords: langchain,ai,agents,payments,crypto,autonomous
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: langchain-core>=0.1.0
+Requires-Dist: agent-payment-sdk>=0.4.5
+Requires-Dist: pydantic>=2.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# langchain-agentpayment
+
+LangChain tools for [AgentPayment Network](https://agentpayment.network) — autonomous agent-to-agent payments across crypto, card, and ACH.
+
+## Installation
+```bash
+pip install langchain-agentpayment
+```
+
+## Quick Start
+```python
+from langchain_agentpayment import AgentPaymentToolkit
+from langchain_openai import ChatOpenAI
+from langchain.agents import create_tool_calling_agent, AgentExecutor
+from langchain_core.prompts import ChatPromptTemplate
+
+# Initialize toolkit
+toolkit = AgentPaymentToolkit(api_key="apn_your_key_here")
+tools   = toolkit.get_tools()
+
+# Create agent
+llm    = ChatOpenAI(model="gpt-4o")
+prompt = ChatPromptTemplate.from_messages([
+    ("system", "You are an autonomous agent that can send and receive payments."),
+    ("human", "{input}"),
+    ("placeholder", "{agent_scratchpad}"),
+])
+agent    = create_tool_calling_agent(llm, tools, prompt)
+executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
+
+# Run
+executor.invoke({"input": "Create an invoice for agent_abc for $5 for API usage"})
+executor.invoke({"input": "Set a billing rule to auto-pay up to $10 from provider_xyz via crypto"})
+executor.invoke({"input": "Set a circuit breaker with max $100/day spend limit"})
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_invoice` | Bill a consumer agent for services rendered |
+| `approve_invoice` | Manually approve and pay a pending invoice |
+| `set_billing_rule` | Auto-approve invoices from a provider |
+| `check_invoice_status` | Check status of an invoice |
+| `list_invoices` | List sent/received invoices |
+| `create_recurring_billing` | Set up recurring billing (Model A or B) |
+| `set_circuit_breaker` | Set daily spend/transaction limits |
+
+## Pricing
+
+Volume-based, dual-sided:
+- 0–10k requests/month: 1% consumer + 1% provider
+- 10k–20k: 0.9% each side
+- 20k+: 0.8% each side
+
+## Links
+
+- [Docs](https://agentpayment.network/docs)
+- [PyPI](https://pypi.org/project/agent-payment-sdk/)
+- [GitHub](https://github.com/SuryaRaut/agent-payment-network)

langchain_agentpayment-0.1.0/README.md

@@ -0,0 +1,60 @@
+# langchain-agentpayment
+
+LangChain tools for [AgentPayment Network](https://agentpayment.network) — autonomous agent-to-agent payments across crypto, card, and ACH.
+
+## Installation
+```bash
+pip install langchain-agentpayment
+```
+
+## Quick Start
+```python
+from langchain_agentpayment import AgentPaymentToolkit
+from langchain_openai import ChatOpenAI
+from langchain.agents import create_tool_calling_agent, AgentExecutor
+from langchain_core.prompts import ChatPromptTemplate
+
+# Initialize toolkit
+toolkit = AgentPaymentToolkit(api_key="apn_your_key_here")
+tools   = toolkit.get_tools()
+
+# Create agent
+llm    = ChatOpenAI(model="gpt-4o")
+prompt = ChatPromptTemplate.from_messages([
+    ("system", "You are an autonomous agent that can send and receive payments."),
+    ("human", "{input}"),
+    ("placeholder", "{agent_scratchpad}"),
+])
+agent    = create_tool_calling_agent(llm, tools, prompt)
+executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
+
+# Run
+executor.invoke({"input": "Create an invoice for agent_abc for $5 for API usage"})
+executor.invoke({"input": "Set a billing rule to auto-pay up to $10 from provider_xyz via crypto"})
+executor.invoke({"input": "Set a circuit breaker with max $100/day spend limit"})
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_invoice` | Bill a consumer agent for services rendered |
+| `approve_invoice` | Manually approve and pay a pending invoice |
+| `set_billing_rule` | Auto-approve invoices from a provider |
+| `check_invoice_status` | Check status of an invoice |
+| `list_invoices` | List sent/received invoices |
+| `create_recurring_billing` | Set up recurring billing (Model A or B) |
+| `set_circuit_breaker` | Set daily spend/transaction limits |
+
+## Pricing
+
+Volume-based, dual-sided:
+- 0–10k requests/month: 1% consumer + 1% provider
+- 10k–20k: 0.9% each side
+- 20k+: 0.8% each side
+
+## Links
+
+- [Docs](https://agentpayment.network/docs)
+- [PyPI](https://pypi.org/project/agent-payment-sdk/)
+- [GitHub](https://github.com/SuryaRaut/agent-payment-network)

langchain_agentpayment-0.1.0/langchain_agentpayment/__init__.py

@@ -0,0 +1,23 @@
+from .tools import (
+    CreateInvoiceTool,
+    ApproveInvoiceTool,
+    SetBillingRuleTool,
+    CheckInvoiceStatusTool,
+    ListInvoicesTool,
+    CreateRecurringBillingTool,
+    SetCircuitBreakerTool,
+    AgentPaymentToolkit,
+)
+
+__all__ = [
+    "CreateInvoiceTool",
+    "ApproveInvoiceTool",
+    "SetBillingRuleTool",
+    "CheckInvoiceStatusTool",
+    "ListInvoicesTool",
+    "CreateRecurringBillingTool",
+    "SetCircuitBreakerTool",
+    "AgentPaymentToolkit",
+]
+
+__version__ = "0.1.0"

langchain_agentpayment-0.1.0/langchain_agentpayment/tools.py

@@ -0,0 +1,256 @@
+"""
+LangChain tools for AgentPayment Network.
+Enables LangChain agents to autonomously send and receive payments.
+
+Usage:
+    from langchain_agentpayment import AgentPaymentToolkit
+    from langchain_openai import ChatOpenAI
+    from langchain.agents import create_tool_calling_agent, AgentExecutor
+
+    toolkit = AgentPaymentToolkit(api_key="apn_...")
+    tools   = toolkit.get_tools()
+
+    llm      = ChatOpenAI(model="gpt-4o")
+    agent    = create_tool_calling_agent(llm, tools, prompt)
+    executor = AgentExecutor(agent=agent, tools=tools)
+    executor.invoke({"input": "Pay agent_abc $5 for API usage"})
+"""
+from typing import Optional, Type, List
+from pydantic import BaseModel, Field
+from langchain_core.tools import BaseTool
+from agent_payment_sdk import AgentPaymentClient
+
+
+class CreateInvoiceInput(BaseModel):
+    to_agent_id  : str   = Field(description="Consumer agent ID to bill")
+    amount       : float = Field(description="Invoice amount in USD")
+    description  : str   = Field(description="Description of service rendered")
+    payment_rail : str   = Field(default="crypto", description="Payment rail: crypto, card, or ach")
+
+class ApproveInvoiceInput(BaseModel):
+    invoice_id: str = Field(description="Invoice ID to approve and pay")
+
+class SetBillingRuleInput(BaseModel):
+    approved_provider_id : str   = Field(description="Provider agent ID to auto-approve payments from")
+    max_invoice_amount   : float = Field(description="Maximum invoice amount to auto-approve in USD")
+    preferred_rail       : str   = Field(default="crypto", description="Payment rail: crypto, card, or ach")
+
+class CheckInvoiceInput(BaseModel):
+    invoice_id: str = Field(description="Invoice ID to check status of")
+
+class ListInvoicesInput(BaseModel):
+    role : str = Field(default="all", description="Filter: all, sent (as provider), received (as consumer)")
+    limit: int = Field(default=10, description="Maximum number of invoices to return")
+
+class CreateRecurringBillingInput(BaseModel):
+    consumer_id   : str            = Field(description="Consumer agent ID to bill recurringly")
+    frequency     : str            = Field(description="Billing frequency: 30m, 1h, 6h, 1d, 7d, 30d")
+    payment_rail  : str            = Field(default="crypto", description="Payment rail: crypto, card, or ach")
+    callback_url  : Optional[str]  = Field(default=None, description="Model A: webhook URL to receive billing notifications")
+    usage_endpoint: Optional[str]  = Field(default=None, description="Model B: endpoint platform pulls usage from autonomously")
+    max_per_period: Optional[float]= Field(default=None, description="Safety cap — max amount per billing cycle in USD")
+    description   : Optional[str]  = Field(default=None, description="Description for invoices")
+
+class SetCircuitBreakerInput(BaseModel):
+    max_spend_per_day        : Optional[float] = Field(default=None, description="Maximum USD to spend per day")
+    max_transactions_per_day : Optional[int]   = Field(default=None, description="Maximum number of transactions per day")
+    notify_email             : bool            = Field(default=True, description="Send email when circuit breaker triggers")
+
+
+class CreateInvoiceTool(BaseTool):
+    name       : str = "create_invoice"
+    description: str = (
+        "Create an invoice to charge a consumer agent for services rendered. "
+        "If the consumer has an auto-approval billing rule, payment is instant. "
+        "Use this when your agent has completed work and needs to get paid."
+    )
+    args_schema: Type[BaseModel] = CreateInvoiceInput
+    client     : AgentPaymentClient
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def _run(self, to_agent_id: str, amount: float, description: str, payment_rail: str = "crypto") -> str:
+        try:
+            result = self.client.create_invoice(
+                to_agent_id=to_agent_id, amount=amount,
+                description=description, payment_rail=payment_rail
+            )
+            status     = result.get("status", "unknown")
+            invoice_id = result.get("invoice_id", "")
+            if status == "PAID":
+                return f"Invoice paid instantly. ID: {invoice_id}. Amount: ${amount} via {payment_rail}."
+            return f"Invoice created (status: {status}). ID: {invoice_id}. Awaiting consumer approval."
+        except Exception as e:
+            return f"Failed to create invoice: {str(e)}"
+
+
+class ApproveInvoiceTool(BaseTool):
+    name       : str = "approve_invoice"
+    description: str = "Approve and pay a pending invoice by its ID."
+    args_schema: Type[BaseModel] = ApproveInvoiceInput
+    client     : AgentPaymentClient
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def _run(self, invoice_id: str) -> str:
+        try:
+            result = self.client.approve_invoice(invoice_id)
+            return f"Invoice {invoice_id} paid. Status: {result.get('status')}."
+        except Exception as e:
+            return f"Failed to approve invoice: {str(e)}"
+
+
+class SetBillingRuleTool(BaseTool):
+    name       : str = "set_billing_rule"
+    description: str = (
+        "Set an auto-approval billing rule to automatically pay invoices "
+        "from a specific provider without manual approval. "
+        "Enables fully autonomous payments."
+    )
+    args_schema: Type[BaseModel] = SetBillingRuleInput
+    client     : AgentPaymentClient
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def _run(self, approved_provider_id: str, max_invoice_amount: float, preferred_rail: str = "crypto") -> str:
+        try:
+            result = self.client.set_billing_rule(
+                approved_provider_id=approved_provider_id,
+                max_invoice_amount=max_invoice_amount,
+                preferred_rail=preferred_rail
+            )
+            return (
+                f"Billing rule set. Auto-approving up to ${max_invoice_amount} "
+                f"from {approved_provider_id} via {preferred_rail}."
+            )
+        except Exception as e:
+            return f"Failed to set billing rule: {str(e)}"
+
+
+class CheckInvoiceStatusTool(BaseTool):
+    name       : str = "check_invoice_status"
+    description: str = "Check the status of an invoice by its ID."
+    args_schema: Type[BaseModel] = CheckInvoiceInput
+    client     : AgentPaymentClient
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def _run(self, invoice_id: str) -> str:
+        try:
+            result = self.client.get_invoice_pay_info(invoice_id)
+            return (
+                f"Invoice {invoice_id}: amount=${result.get('amount')}, "
+                f"status={result.get('status', 'unknown')}"
+            )
+        except Exception as e:
+            return f"Failed to check invoice: {str(e)}"
+
+
+class ListInvoicesTool(BaseTool):
+    name       : str = "list_invoices"
+    description: str = "List invoices. Role: sent (as provider), received (as consumer), all."
+    args_schema: Type[BaseModel] = ListInvoicesInput
+    client     : AgentPaymentClient
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def _run(self, role: str = "all", limit: int = 10) -> str:
+        try:
+            result   = self.client.list_invoices(agent_id="me", role=role, limit=limit)
+            invoices = result.get("invoices", [])
+            if not invoices:
+                return f"No {role} invoices found."
+            lines = [
+                f"- {inv.get('invoice_id','')[:8]}... ${inv.get('amount')} {inv.get('status')} via {inv.get('payment_rail')}"
+                for inv in invoices[:limit]
+            ]
+            return f"Found {len(invoices)} {role} invoice(s):\n" + "\n".join(lines)
+        except Exception as e:
+            return f"Failed to list invoices: {str(e)}"
+
+
+class CreateRecurringBillingTool(BaseTool):
+    name       : str = "create_recurring_billing"
+    description: str = (
+        "Set up recurring billing for a consumer agent at a set interval. "
+        "Model A (callback_url): platform notifies you, you create the invoice. "
+        "Model B (usage_endpoint): platform pulls usage and creates invoice automatically."
+    )
+    args_schema: Type[BaseModel] = CreateRecurringBillingInput
+    client     : AgentPaymentClient
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def _run(self, consumer_id: str, frequency: str, payment_rail: str = "crypto",
+             callback_url: Optional[str] = None, usage_endpoint: Optional[str] = None,
+             max_per_period: Optional[float] = None, description: Optional[str] = None) -> str:
+        try:
+            body = {"consumer_id": consumer_id, "frequency": frequency, "payment_rail": payment_rail.upper()}
+            if callback_url:   body["callback_url"]    = callback_url
+            if usage_endpoint: body["usage_endpoint"]  = usage_endpoint
+            if max_per_period: body["max_per_period"]  = max_per_period
+            if description:    body["description"]     = description
+            result = self.client._request("POST", "/api/v1/recurring-billing", json=body)
+            return (
+                f"Recurring billing set (Model {result.get('model','A')}). "
+                f"Frequency: {frequency}. Next: {result.get('next_billing_at','')}."
+            )
+        except Exception as e:
+            return f"Failed to create recurring billing: {str(e)}"
+
+
+class SetCircuitBreakerTool(BaseTool):
+    name       : str = "set_circuit_breaker"
+    description: str = (
+        "Set spending limits to protect your agent. "
+        "Blocks all outgoing payments if daily spend or transaction count exceeds the limit."
+    )
+    args_schema: Type[BaseModel] = SetCircuitBreakerInput
+    client     : AgentPaymentClient
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    def _run(self, max_spend_per_day: Optional[float] = None,
+             max_transactions_per_day: Optional[int] = None, notify_email: bool = True) -> str:
+        try:
+            body = {"notify_email": notify_email}
+            if max_spend_per_day:         body["max_spend_per_day"]         = max_spend_per_day
+            if max_transactions_per_day:  body["max_transactions_per_day"]  = max_transactions_per_day
+            result = self.client._request("POST", "/api/v1/circuit-breaker", json=body)
+            parts  = []
+            if max_spend_per_day:        parts.append(f"max ${max_spend_per_day}/day")
+            if max_transactions_per_day: parts.append(f"max {max_transactions_per_day} txns/day")
+            return f"Circuit breaker set: {', '.join(parts)}."
+        except Exception as e:
+            return f"Failed to set circuit breaker: {str(e)}"
+
+
+class AgentPaymentToolkit:
+    """
+    LangChain toolkit for AgentPayment Network.
+
+    Usage:
+        toolkit = AgentPaymentToolkit(api_key="apn_...")
+        tools   = toolkit.get_tools()
+        agent   = create_tool_calling_agent(llm, tools, prompt)
+    """
+    def __init__(self, api_key: str, base_url: str = "https://agentpayment.network"):
+        self.client = AgentPaymentClient(api_key=api_key, base_url=base_url)
+
+    def get_tools(self) -> List[BaseTool]:
+        return [
+            CreateInvoiceTool(client=self.client),
+            ApproveInvoiceTool(client=self.client),
+            SetBillingRuleTool(client=self.client),
+            CheckInvoiceStatusTool(client=self.client),
+            ListInvoicesTool(client=self.client),
+            CreateRecurringBillingTool(client=self.client),
+            SetCircuitBreakerTool(client=self.client),
+        ]

langchain_agentpayment-0.1.0/langchain_agentpayment.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: langchain-agentpayment
+Version: 0.1.0
+Summary: LangChain tools for AgentPayment Network — autonomous agent-to-agent payments
+Home-page: https://github.com/SuryaRaut/agent-payment-network
+Author: AgentPayment Network
+Author-email: support@agentpayment.network
+Keywords: langchain,ai,agents,payments,crypto,autonomous
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: langchain-core>=0.1.0
+Requires-Dist: agent-payment-sdk>=0.4.5
+Requires-Dist: pydantic>=2.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# langchain-agentpayment
+
+LangChain tools for [AgentPayment Network](https://agentpayment.network) — autonomous agent-to-agent payments across crypto, card, and ACH.
+
+## Installation
+```bash
+pip install langchain-agentpayment
+```
+
+## Quick Start
+```python
+from langchain_agentpayment import AgentPaymentToolkit
+from langchain_openai import ChatOpenAI
+from langchain.agents import create_tool_calling_agent, AgentExecutor
+from langchain_core.prompts import ChatPromptTemplate
+
+# Initialize toolkit
+toolkit = AgentPaymentToolkit(api_key="apn_your_key_here")
+tools   = toolkit.get_tools()
+
+# Create agent
+llm    = ChatOpenAI(model="gpt-4o")
+prompt = ChatPromptTemplate.from_messages([
+    ("system", "You are an autonomous agent that can send and receive payments."),
+    ("human", "{input}"),
+    ("placeholder", "{agent_scratchpad}"),
+])
+agent    = create_tool_calling_agent(llm, tools, prompt)
+executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
+
+# Run
+executor.invoke({"input": "Create an invoice for agent_abc for $5 for API usage"})
+executor.invoke({"input": "Set a billing rule to auto-pay up to $10 from provider_xyz via crypto"})
+executor.invoke({"input": "Set a circuit breaker with max $100/day spend limit"})
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_invoice` | Bill a consumer agent for services rendered |
+| `approve_invoice` | Manually approve and pay a pending invoice |
+| `set_billing_rule` | Auto-approve invoices from a provider |
+| `check_invoice_status` | Check status of an invoice |
+| `list_invoices` | List sent/received invoices |
+| `create_recurring_billing` | Set up recurring billing (Model A or B) |
+| `set_circuit_breaker` | Set daily spend/transaction limits |
+
+## Pricing
+
+Volume-based, dual-sided:
+- 0–10k requests/month: 1% consumer + 1% provider
+- 10k–20k: 0.9% each side
+- 20k+: 0.8% each side
+
+## Links
+
+- [Docs](https://agentpayment.network/docs)
+- [PyPI](https://pypi.org/project/agent-payment-sdk/)
+- [GitHub](https://github.com/SuryaRaut/agent-payment-network)

langchain_agentpayment-0.1.0/langchain_agentpayment.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+setup.py
+langchain_agentpayment/__init__.py
+langchain_agentpayment/tools.py
+langchain_agentpayment.egg-info/PKG-INFO
+langchain_agentpayment.egg-info/SOURCES.txt
+langchain_agentpayment.egg-info/dependency_links.txt
+langchain_agentpayment.egg-info/requires.txt
+langchain_agentpayment.egg-info/top_level.txt

langchain_agentpayment-0.1.0/langchain_agentpayment.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

langchain_agentpayment-0.1.0/langchain_agentpayment.egg-info/requires.txt

@@ -0,0 +1,3 @@
+langchain-core>=0.1.0
+agent-payment-sdk>=0.4.5
+pydantic>=2.0.0

langchain_agentpayment-0.1.0/langchain_agentpayment.egg-info/top_level.txt

@@ -0,0 +1 @@
+langchain_agentpayment

langchain_agentpayment-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

langchain_agentpayment-0.1.0/setup.py

@@ -0,0 +1,27 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="langchain-agentpayment",
+    version="0.1.0",
+    description="LangChain tools for AgentPayment Network — autonomous agent-to-agent payments",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="AgentPayment Network",
+    author_email="support@agentpayment.network",
+    url="https://github.com/SuryaRaut/agent-payment-network",
+    packages=find_packages(),
+    install_requires=[
+        "langchain-core>=0.1.0",
+        "agent-payment-sdk>=0.4.5",
+        "pydantic>=2.0.0",
+    ],
+    python_requires=">=3.9",
+    keywords=["langchain", "ai", "agents", "payments", "crypto", "autonomous"],
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Topic :: Software Development :: Libraries",
+    ],
+)