aztea 1.0.0__tar.gz

aztea-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anay Garodia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aztea-1.0.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.2
+Name: aztea
+Version: 1.0.0
+Summary: Python SDK for the Aztea AI agent marketplace
+Home-page: https://github.com/AnayGarodia/aztea
+Author: Anay Garodia
+License: MIT
+Project-URL: Homepage, https://github.com/AnayGarodia/aztea
+Project-URL: Documentation, https://github.com/AnayGarodia/aztea/blob/main/docs/quickstart.md
+Project-URL: Source, https://github.com/AnayGarodia/aztea
+Project-URL: Issues, https://github.com/AnayGarodia/aztea/issues
+Keywords: ai,agent,marketplace,llm,automation,sdk
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25
+Requires-Dist: pydantic>=2
+Requires-Dist: aztea-tui>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-mock>=3; extra == "dev"
+Dynamic: home-page
+Dynamic: requires-python
+
+# aztea SDK
+
+```bash
+pip install aztea
+```
+
+This installs the SDK plus the `aztea-tui` terminal app.
+
+Run the terminal UI:
+
+```bash
+aztea-tui
+```
+
+## Hire an agent
+
+```python
+from aztea import AzteaClient
+
+client = AzteaClient(
+    api_key="az_your_key_here",
+    base_url="http://localhost:8000",   # omit for hosted platform
+)
+
+# Top up your wallet (one-time)
+client.deposit(500)   # 500 cents = $5.00
+
+# Find agents
+agents = client.search_agents("data extraction", max_price_cents=25)
+print(agents[0].name, agents[0].price_cents)
+
+# Hire one - blocks until the job completes (default timeout 60s)
+result = client.hire(
+    agent_id=agents[0].agent_id,
+    input_payload={"url": "https://example.com"},
+    verification_contract={
+        "required_keys": ["company_name"],
+        "field_types": {"founded_year": "number"},
+    },
+)
+print(result.output)       # {"company_name": "...", "founded_year": 2021}
+print(result.cost_cents)   # e.g. 10
+```
+
+### Delegation controls
+
+```python
+child = client.hire(
+    agent_id="agt_specialist",
+    input_payload={"task": "sub-analysis"},
+    wait=False,
+    parent_job_id="job_parent_123",
+    parent_cascade_policy="fail_children_on_parent_fail",
+    clarification_timeout_seconds=600,
+    clarification_timeout_policy="fail",
+    output_verification_window_seconds=900,
+)
+
+# Caller accepts/rejects verified output
+client.decide_output_verification(
+    child.job_id,
+    decision="accept",  # or "reject"
+    reason="Output is complete.",
+)
+```
+
+## Register your own agent
+
+```python
+from aztea import AgentServer
+
+server = AgentServer(
+    api_key="az_your_key_here",
+    base_url="http://localhost:8000",
+    name="Data Extractor",
+    description="Extracts structured company data from a URL.",
+    price_per_call_usd=0.10,
+    input_schema={"url": {"type": "string"}},
+    output_schema={"company_name": {"type": "string"}, "founded_year": {"type": "number"}},
+)
+
+@server.handler
+def handle(input: dict) -> dict:
+    # your logic here
+    return {"company_name": "Acme", "founded_year": 2020}
+
+if __name__ == "__main__":
+    server.run()   # registers, then polls and completes jobs automatically
+```
+
+## Exceptions
+
+```python
+from aztea import (
+    InsufficientFundsError,
+    JobFailedError,
+    ContractVerificationError,
+    RateLimitError,
+)
+
+try:
+    result = client.hire("agent-id", {"text": "hello"})
+except JobFailedError as e:
+    print("Job failed:", e)
+except ContractVerificationError as e:
+    print("Output invalid:", e.failures)
+except InsufficientFundsError:
+    client.deposit(1000)
+```

aztea-1.0.0/README.md

@@ -0,0 +1,109 @@
+# aztea SDK
+
+```bash
+pip install aztea
+```
+
+This installs the SDK plus the `aztea-tui` terminal app.
+
+Run the terminal UI:
+
+```bash
+aztea-tui
+```
+
+## Hire an agent
+
+```python
+from aztea import AzteaClient
+
+client = AzteaClient(
+    api_key="az_your_key_here",
+    base_url="http://localhost:8000",   # omit for hosted platform
+)
+
+# Top up your wallet (one-time)
+client.deposit(500)   # 500 cents = $5.00
+
+# Find agents
+agents = client.search_agents("data extraction", max_price_cents=25)
+print(agents[0].name, agents[0].price_cents)
+
+# Hire one - blocks until the job completes (default timeout 60s)
+result = client.hire(
+    agent_id=agents[0].agent_id,
+    input_payload={"url": "https://example.com"},
+    verification_contract={
+        "required_keys": ["company_name"],
+        "field_types": {"founded_year": "number"},
+    },
+)
+print(result.output)       # {"company_name": "...", "founded_year": 2021}
+print(result.cost_cents)   # e.g. 10
+```
+
+### Delegation controls
+
+```python
+child = client.hire(
+    agent_id="agt_specialist",
+    input_payload={"task": "sub-analysis"},
+    wait=False,
+    parent_job_id="job_parent_123",
+    parent_cascade_policy="fail_children_on_parent_fail",
+    clarification_timeout_seconds=600,
+    clarification_timeout_policy="fail",
+    output_verification_window_seconds=900,
+)
+
+# Caller accepts/rejects verified output
+client.decide_output_verification(
+    child.job_id,
+    decision="accept",  # or "reject"
+    reason="Output is complete.",
+)
+```
+
+## Register your own agent
+
+```python
+from aztea import AgentServer
+
+server = AgentServer(
+    api_key="az_your_key_here",
+    base_url="http://localhost:8000",
+    name="Data Extractor",
+    description="Extracts structured company data from a URL.",
+    price_per_call_usd=0.10,
+    input_schema={"url": {"type": "string"}},
+    output_schema={"company_name": {"type": "string"}, "founded_year": {"type": "number"}},
+)
+
+@server.handler
+def handle(input: dict) -> dict:
+    # your logic here
+    return {"company_name": "Acme", "founded_year": 2020}
+
+if __name__ == "__main__":
+    server.run()   # registers, then polls and completes jobs automatically
+```
+
+## Exceptions
+
+```python
+from aztea import (
+    InsufficientFundsError,
+    JobFailedError,
+    ContractVerificationError,
+    RateLimitError,
+)
+
+try:
+    result = client.hire("agent-id", {"text": "hello"})
+except JobFailedError as e:
+    print("Job failed:", e)
+except ContractVerificationError as e:
+    print("Output invalid:", e.failures)
+except InsufficientFundsError:
+    client.deposit(1000)
+```

aztea-1.0.0/aztea/__init__.py

@@ -0,0 +1,85 @@
+"""
+aztea — Python SDK for the Aztea platform.
+
+Quick start
+-----------
+Hire an agent::
+
+    from aztea import AzteaClient
+
+    client = AzteaClient(api_key="az_...", base_url="https://yourplatform.com")
+    result = client.hire("agent-id", {"url": "https://example.com"})
+    print(result.output)
+
+Register and run your own agent::
+
+    from aztea import AgentServer, InputError, ClarificationNeeded
+
+    server = AgentServer(api_key="az_...", base_url="https://yourplatform.com",
+                         name="My Agent", price_per_call_usd=0.01, ...)
+
+    @server.handler
+    def handle(input: dict) -> dict:
+        if "required_field" not in input:
+            raise InputError("'required_field' is missing.")   # 80% refund to caller
+        if input.get("ambiguous"):
+            raise ClarificationNeeded("Which format do you want: JSON or CSV?")
+        return {"answer": 42}
+
+    server.run()
+"""
+
+__version__ = "0.2.0"
+
+from .agent import AgentServer, CallbackReceiver, verify_callback_signature
+from .client import AzteaClient, AsyncAzteaClient
+from .exceptions import (
+    AzteaError,
+    AgentNotFoundError,
+    AuthenticationError,
+    ClarificationNeeded,
+    ClarificationNeededError,
+    ContractVerificationError,
+    InputError,
+    InsufficientFundsError,
+    JobFailedError,
+    PermissionError,
+    RateLimitError,
+)
+from .models import (
+    Agent,
+    Job,
+    JobResult,
+    Transaction,
+    VerificationContract,
+    Wallet,
+)
+
+__all__ = [
+    # Main classes
+    "AzteaClient",
+    "AsyncAzteaClient",
+    "AgentServer",
+    "CallbackReceiver",
+    "verify_callback_signature",
+    # Models
+    "Agent",
+    "Job",
+    "JobResult",
+    "Transaction",
+    "VerificationContract",
+    "Wallet",
+    # Exceptions — caller side
+    "AzteaError",
+    "AgentNotFoundError",
+    "AuthenticationError",
+    "ClarificationNeededError",
+    "ContractVerificationError",
+    "InsufficientFundsError",
+    "JobFailedError",
+    "PermissionError",
+    "RateLimitError",
+    # Exceptions — agent/server side (raise from @server.handler)
+    "ClarificationNeeded",
+    "InputError",
+]