composio-strale 0.1.4__tar.gz

composio_strale-0.1.4/.gitignore

@@ -0,0 +1,20 @@
+node_modules/
+dist/
+.env
+.env.local
+.env.production
+*.log
+.DS_Store
+.turbo
+coverage/
+__pycache__/
+*.pyc
+*.egg-info/
+.venv/
+build/
+*.whl
+*.tar.gz
+strale-frontend/
+
+# Claude Code settings (contains local API keys)
+.claude/

composio_strale-0.1.4/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: composio-strale
+Version: 0.1.4
+Summary: Composio integration for Strale — 270+ business capabilities as agent tools
+Project-URL: Homepage, https://strale.dev
+Project-URL: Repository, https://github.com/strale-io/strale/tree/main/packages/composio-strale
+Project-URL: Documentation, https://strale.dev/docs
+Author-email: Strale <hello@strale.io>
+License-Expression: MIT
+Keywords: agent,ai,capabilities,compliance,composio,mcp,strale,tools,web3
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: composio>=0.7.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# composio-strale
+
+[Composio](https://composio.dev) integration for [Strale](https://strale.dev) — 270+ quality-scored API capabilities as Composio custom tools.
+
+## Install
+
+```bash
+pip install composio-strale
+```
+
+## Quick start
+
+```python
+from composio import Composio
+from composio_strale import register_strale_tools
+
+composio = Composio()
+register_strale_tools(composio, api_key="sk_live_...")
+
+# Search for capabilities
+result = composio.tools.execute(
+    user_id="default",
+    slug="STRALE_SEARCH",
+    arguments={"query": "sanctions screening"},
+)
+
+# Execute a capability
+result = composio.tools.execute(
+    user_id="default",
+    slug="STRALE_EXECUTE",
+    arguments={
+        "capability_slug": "sanctions-check",
+        "inputs": {"name": "Acme Corp"},
+    },
+)
+```
+
+## Use with an agent
+
+```python
+from composio import Composio
+from composio_openai import OpenAIProvider
+from composio_strale import register_strale_tools
+
+composio = Composio(provider=OpenAIProvider())
+register_strale_tools(composio)
+
+tools = composio.tools.get(user_id="default", toolkits=["strale"])
+
+from openai import OpenAI
+client = OpenAI()
+response = client.chat.completions.create(
+    model="gpt-4o",
+    tools=tools,
+    messages=[{"role": "user", "content": "Run a sanctions check on 'Acme Corp'"}],
+)
+```
+
+## What's included
+
+Three tools registered under the `strale` toolkit:
+
+| Tool | Description |
+|------|-------------|
+| `STRALE_SEARCH` | Search 270+ capabilities by keyword or category |
+| `STRALE_EXECUTE` | Execute any capability with structured input |
+| `STRALE_BALANCE` | Check your wallet balance |
+
+## Get an API key
+
+Sign up at [strale.dev](https://strale.dev) — new accounts get €2.00 trial credits, no card required.
+
+## x402 pay-per-use access
+
+All Strale capabilities are also available via [x402](https://x402.org) — the HTTP-native payment protocol for AI agents. Pay per request with USDC on Base mainnet. No signup or API key needed.
+
+- Catalog: https://api.strale.io/x402/catalog
+- Protocol: USDC on Base (eip155:8453)
+- Discovery: https://api.strale.io/.well-known/x402.json
+
+## Resources
+
+- [Documentation](https://strale.dev/docs)
+- [Examples](https://github.com/strale-io/strale-examples)
+- [Pricing](https://strale.dev/pricing)
+- [Quality methodology](https://strale.dev/methodology)

composio_strale-0.1.4/README.md

@@ -0,0 +1,86 @@
+# composio-strale
+
+[Composio](https://composio.dev) integration for [Strale](https://strale.dev) — 270+ quality-scored API capabilities as Composio custom tools.
+
+## Install
+
+```bash
+pip install composio-strale
+```
+
+## Quick start
+
+```python
+from composio import Composio
+from composio_strale import register_strale_tools
+
+composio = Composio()
+register_strale_tools(composio, api_key="sk_live_...")
+
+# Search for capabilities
+result = composio.tools.execute(
+    user_id="default",
+    slug="STRALE_SEARCH",
+    arguments={"query": "sanctions screening"},
+)
+
+# Execute a capability
+result = composio.tools.execute(
+    user_id="default",
+    slug="STRALE_EXECUTE",
+    arguments={
+        "capability_slug": "sanctions-check",
+        "inputs": {"name": "Acme Corp"},
+    },
+)
+```
+
+## Use with an agent
+
+```python
+from composio import Composio
+from composio_openai import OpenAIProvider
+from composio_strale import register_strale_tools
+
+composio = Composio(provider=OpenAIProvider())
+register_strale_tools(composio)
+
+tools = composio.tools.get(user_id="default", toolkits=["strale"])
+
+from openai import OpenAI
+client = OpenAI()
+response = client.chat.completions.create(
+    model="gpt-4o",
+    tools=tools,
+    messages=[{"role": "user", "content": "Run a sanctions check on 'Acme Corp'"}],
+)
+```
+
+## What's included
+
+Three tools registered under the `strale` toolkit:
+
+| Tool | Description |
+|------|-------------|
+| `STRALE_SEARCH` | Search 270+ capabilities by keyword or category |
+| `STRALE_EXECUTE` | Execute any capability with structured input |
+| `STRALE_BALANCE` | Check your wallet balance |
+
+## Get an API key
+
+Sign up at [strale.dev](https://strale.dev) — new accounts get €2.00 trial credits, no card required.
+
+## x402 pay-per-use access
+
+All Strale capabilities are also available via [x402](https://x402.org) — the HTTP-native payment protocol for AI agents. Pay per request with USDC on Base mainnet. No signup or API key needed.
+
+- Catalog: https://api.strale.io/x402/catalog
+- Protocol: USDC on Base (eip155:8453)
+- Discovery: https://api.strale.io/.well-known/x402.json
+
+## Resources
+
+- [Documentation](https://strale.dev/docs)
+- [Examples](https://github.com/strale-io/strale-examples)
+- [Pricing](https://strale.dev/pricing)
+- [Quality methodology](https://strale.dev/methodology)

composio_strale-0.1.4/composio_strale/__init__.py

@@ -0,0 +1,5 @@
+"""composio-strale — 270+ Strale capabilities as Composio custom tools."""
+
+from .toolkit import register_strale_tools, StraleToolkit
+
+__all__ = ["register_strale_tools", "StraleToolkit"]

composio_strale-0.1.4/composio_strale/toolkit.py

@@ -0,0 +1,178 @@
+"""Register Strale capabilities as Composio custom tools."""
+
+from __future__ import annotations
+
+import os
+from typing import Any, Optional
+
+import httpx
+from pydantic import BaseModel, Field
+
+
+_BASE_URL = "https://api.strale.io"
+
+
+class StraleSearchInput(BaseModel):
+    query: str = Field(..., description="Search keyword (e.g., 'sanctions', 'IBAN', 'company data')")
+    category: Optional[str] = Field(
+        None,
+        description="Filter by category: compliance, validation, web3, company-data, finance, developer-tools",
+    )
+
+
+class StraleExecuteInput(BaseModel):
+    capability_slug: str = Field(
+        ...,
+        description="Capability slug from strale_search results (e.g., 'sanctions-check', 'iban-validate')",
+    )
+    inputs: dict = Field(
+        ...,
+        description="Input parameters matching the capability's required fields",
+    )
+    max_price_cents: int = Field(
+        200,
+        description="Maximum price in EUR cents. Default: 200 (€2.00). Execution fails if capability costs more.",
+    )
+
+
+class StraleBalanceInput(BaseModel):
+    pass
+
+
+class StraleToolkit:
+    """Registers Strale tools with a Composio instance.
+
+    Usage::
+
+        from composio import Composio
+        from composio_strale import StraleToolkit
+
+        composio = Composio()
+        toolkit = StraleToolkit(api_key="sk_live_...")
+        toolkit.register(composio)
+
+        # Now use composio.tools.get() or composio.tools.execute() with Strale tools
+        result = composio.tools.execute(
+            user_id="default",
+            slug="STRALE_EXECUTE",
+            arguments={
+                "capability_slug": "iban-validate",
+                "inputs": {"iban": "DE89370400440532013000"},
+            },
+        )
+    """
+
+    def __init__(
+        self,
+        api_key: str | None = None,
+        base_url: str = _BASE_URL,
+    ):
+        self.api_key = api_key or os.environ.get("STRALE_API_KEY", "")
+        self.base_url = base_url.rstrip("/")
+
+    def _headers(self) -> dict[str, str]:
+        h: dict[str, str] = {"Content-Type": "application/json", "Accept": "application/json"}
+        if self.api_key:
+            h["Authorization"] = f"Bearer {self.api_key}"
+        return h
+
+    def register(self, composio: Any) -> None:
+        """Register all Strale tools with the given Composio instance."""
+        toolkit = self  # capture for closures
+
+        @composio.tools.custom_tool(toolkit="strale")
+        def strale_search(request: StraleSearchInput) -> dict:
+            """Search Strale's 270+ API capabilities. Returns matching capabilities with slugs, descriptions, and pricing. Use this first to discover available capabilities, then use strale_execute to run one."""
+            params = {"q": request.query, "limit": "10"}
+            if request.category:
+                params["category"] = request.category
+            resp = httpx.get(
+                f"{toolkit.base_url}/v1/suggest/typeahead",
+                params=params,
+                headers=toolkit._headers(),
+                timeout=10,
+            )
+            if resp.status_code == 200:
+                data = resp.json()
+                return {
+                    "capabilities": [
+                        {
+                            "slug": c.get("slug"),
+                            "name": c.get("name"),
+                            "description": c.get("description", "")[:120],
+                            "price_cents": c.get("price_cents"),
+                            "category": c.get("category"),
+                        }
+                        for c in data.get("suggestions", data.get("capabilities", []))
+                    ]
+                }
+            # Fallback to keyword search
+            resp2 = httpx.get(
+                f"{toolkit.base_url}/v1/capabilities",
+                params={"search": request.query},
+                headers={"Accept": "application/json"},
+                timeout=10,
+            )
+            if resp2.status_code != 200:
+                return {"error": f"Search failed: HTTP {resp2.status_code}"}
+            caps = resp2.json().get("capabilities", [])
+            return {
+                "capabilities": [
+                    {
+                        "slug": c["slug"],
+                        "name": c["name"],
+                        "description": c.get("description", "")[:120],
+                        "price_cents": c.get("price_cents"),
+                    }
+                    for c in caps[:10]
+                ]
+            }
+
+        @composio.tools.custom_tool(toolkit="strale")
+        def strale_execute(request: StraleExecuteInput) -> dict:
+            """Execute a Strale capability. Pass the slug from strale_search and the required inputs. Returns structured output with quality score, latency, and data provenance."""
+            if not toolkit.api_key:
+                return {"error": "STRALE_API_KEY required. Get one at https://strale.dev/signup (€2 free credits)."}
+            resp = httpx.post(
+                f"{toolkit.base_url}/v1/do",
+                json={
+                    "capability_slug": request.capability_slug,
+                    "inputs": request.inputs,
+                    "max_price_cents": request.max_price_cents,
+                },
+                headers=toolkit._headers(),
+                timeout=30,
+            )
+            return resp.json()
+
+        @composio.tools.custom_tool(toolkit="strale")
+        def strale_balance(request: StraleBalanceInput) -> dict:
+            """Check your Strale wallet balance in EUR cents."""
+            if not toolkit.api_key:
+                return {"error": "STRALE_API_KEY required."}
+            resp = httpx.get(
+                f"{toolkit.base_url}/v1/wallet/balance",
+                headers=toolkit._headers(),
+                timeout=10,
+            )
+            return resp.json()
+
+
+def register_strale_tools(
+    composio: Any,
+    api_key: str | None = None,
+    base_url: str = _BASE_URL,
+) -> StraleToolkit:
+    """Convenience function: create a StraleToolkit and register it.
+
+    Usage::
+
+        from composio import Composio
+        from composio_strale import register_strale_tools
+
+        composio = Composio()
+        register_strale_tools(composio, api_key="sk_live_...")
+    """
+    toolkit = StraleToolkit(api_key=api_key, base_url=base_url)
+    toolkit.register(composio)
+    return toolkit

composio_strale-0.1.4/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "composio-strale"
+version = "0.1.4"
+description = "Composio integration for Strale — 270+ business capabilities as agent tools"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Strale", email = "hello@strale.io" },
+]
+keywords = [
+    "composio",
+    "strale",
+    "ai",
+    "agent",
+    "tools",
+    "capabilities",
+    "compliance",
+    "web3",
+    "mcp",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "composio>=0.7.0",
+    "httpx>=0.24.0",
+    "pydantic>=2.0.0",
+]
+
+[project.urls]
+Homepage = "https://strale.dev"
+Repository = "https://github.com/strale-io/strale/tree/main/packages/composio-strale"
+Documentation = "https://strale.dev/docs"

composio_strale-0.1.4/tests/test_toolkit.py

@@ -0,0 +1,33 @@
+"""Basic import and structure tests for composio-strale."""
+
+import os
+import unittest
+
+
+class TestImport(unittest.TestCase):
+    def test_import(self):
+        from composio_strale import StraleToolkit, register_strale_tools
+        assert StraleToolkit is not None
+        assert register_strale_tools is not None
+
+    def test_toolkit_init(self):
+        from composio_strale import StraleToolkit
+        toolkit = StraleToolkit(api_key="sk_test_123")
+        assert toolkit.api_key == "sk_test_123"
+        assert toolkit.base_url == "https://api.strale.io"
+
+    def test_toolkit_env_key(self):
+        from composio_strale import StraleToolkit
+        os.environ["STRALE_API_KEY"] = "sk_env_test"
+        toolkit = StraleToolkit()
+        assert toolkit.api_key == "sk_env_test"
+        del os.environ["STRALE_API_KEY"]
+
+    def test_toolkit_custom_url(self):
+        from composio_strale import StraleToolkit
+        toolkit = StraleToolkit(api_key="test", base_url="http://localhost:3000")
+        assert toolkit.base_url == "http://localhost:3000"
+
+
+if __name__ == "__main__":
+    unittest.main()