agentstr 0.1.11__py3-none-any.whl → 0.1.13__py3-none-any.whl

agentstr/nostr.pyi

@@ -0,0 +1,96 @@
+"""
+Type stubs for the Nostr module.
+
+This file provides type annotations for the Nostr module, enabling better
+type checking and autocompletion in IDEs. It defines the expected types
+for classes, functions, and variables used within the Nostr module.
+
+Note: This is a type stub file and does not contain any executable code.
+"""
+
+from logging import Logger
+from pathlib import Path
+from typing import ClassVar, List, Optional
+
+from nostr_sdk import (  # type: ignore
+    Client,
+    Event,
+    EventBuilder,
+    EventId,
+    Events,
+    Keys,
+    Kind,
+    Metadata,
+    NostrSigner,
+    ProductData,
+    PublicKey,
+    ShippingCost,
+    ShippingMethod,
+    StallData,
+    Timestamp,
+)
+
+from agentstr.models import MerchantProduct, MerchantStall, NostrProfile
+
+# Re-export all needed types
+__all__ = [
+    "Event",
+    "EventBuilder",
+    "Events",
+    "EventId",
+    "Keys",
+    "Kind",
+    "Metadata",
+    "ProductData",
+    "PublicKey",
+    "ShippingCost",
+    "ShippingMethod",
+    "StallData",
+    "Timestamp",
+]
+
+class NostrClient:
+    """
+    NostrClient implements the set of Nostr utilities required for higher level functions
+    implementations like the Marketplace.
+    """
+
+    logger: ClassVar[Logger]
+    relay: str
+    keys: Keys
+    nostr_signer: NostrSigner
+    client: Client
+
+    def __init__(self, relay: str, nsec: str) -> None: ...
+    def delete_event(
+        self, event_id: EventId, reason: Optional[str] = None
+    ) -> EventId: ...
+    def publish_event(self, event_builder: EventBuilder) -> EventId: ...
+    def publish_note(self, text: str) -> EventId: ...
+    def publish_product(self, product: MerchantProduct) -> EventId: ...
+    def publish_profile(self, name: str, about: str, picture: str) -> EventId: ...
+    def publish_stall(self, stall: MerchantStall) -> EventId: ...
+    def retrieve_products_from_seller(
+        self, seller: PublicKey
+    ) -> List[MerchantProduct]: ...
+    def retrieve_profile(self, public_key: PublicKey) -> NostrProfile: ...
+    def retrieve_stalls_from_seller(self, seller: PublicKey) -> List[StallData]: ...
+    def retrieve_sellers(self) -> set[NostrProfile]: ...
+    @classmethod
+    def set_logging_level(cls, logging_level: int) -> None: ...
+    async def _async_connect(self) -> None: ...
+    async def _async_publish_event(self, event_builder: EventBuilder) -> EventId: ...
+    async def _async_publish_note(self, text: str) -> EventId: ...
+    async def _async_publish_product(self, product: MerchantProduct) -> EventId: ...
+    async def _async_publish_profile(
+        self, name: str, about: str, picture: str
+    ) -> EventId: ...
+    async def _async_publish_stall(self, stall: MerchantStall) -> EventId: ...
+    async def _async_retrieve_all_stalls(self) -> Events: ...
+    async def _async_retrieve_products_from_seller(
+        self, seller: PublicKey
+    ) -> Events: ...
+    async def _async_retrieve_profile(self, author: PublicKey) -> NostrProfile: ...
+    async def _async_retrieve_stalls_from_seller(self, seller: PublicKey) -> Events: ...
+
+def generate_and_save_keys(env_var: str, env_path: Optional[Path] = None) -> Keys: ...

{agentstr-0.1.11.dist-info → agentstr-0.1.13.dist-info}/METADATA

@@ -1,8 +1,8 @@
 Metadata-Version: 2.2
 Name: agentstr
-Version: 0.1.11
-Summary: Nostr extension for Phidata AI agents
-Author-email: Synvya <info@synvya.com>
+Version: 0.1.13
+Summary: Tools for a Nostr agentic ecosystem
+Author-email: Synvya <synvya@synvya.com>
 License: MIT
 Project-URL: Homepage, https://www.synvya.com
 Project-URL: Repository, https://github.com/synvya/agentstr
@@ -11,21 +11,27 @@ Project-URL: BugTracker, https://github.com/synvya/agentstr/issues
 Requires-Python: <3.13,>=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: phidata>=2.7.0
+Requires-Dist: agno>=1.1.1
 Requires-Dist: openai>=1.50.0
-Requires-Dist: packaging>=24.0
-Requires-Dist: nostr-sdk>=0.38.0
+Requires-Dist: nostr_sdk>=0.39.0
 Requires-Dist: pydantic>=2.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.5; extra == "dev"
 Requires-Dist: black>=23.0; extra == "dev"
 Requires-Dist: isort>=5.0; extra == "dev"
 Requires-Dist: mypy>=1.0; extra == "dev"
-Requires-Dist: python-dotenv>=1.0; extra == "dev"
+Requires-Dist: pylint>=3.0; extra == "dev"
+Provides-Extra: examples
+Requires-Dist: python-dotenv>=1.0; extra == "examples"
+Requires-Dist: cassandra-driver>=3.29.2; extra == "examples"
+Requires-Dist: cassio>=0.1.10; extra == "examples"
+Requires-Dist: fastapi>=0.110.0; extra == "examples"
+Requires-Dist: uvicorn>=0.30.0; extra == "examples"
 
 # AgentStr
 
-AgentStr is an extension of [Phidata](https://www.phidata.com) AI agents that enables peer-to-peer agent communication using the Nostr protocol.
+AgentStr is an extension of [Agno](https://www.agno.ai) AI agents that enables peer-to-peer agent communication using the Nostr protocol.
 
 ## Overview
 
@@ -41,8 +47,15 @@ agentstr/
 ├── src/              # Source code
 │   └── agentstr/
 │       ├── __init__.py
-│       ├── marketplace.py
-│       └── nostr.py
+│       ├── buyer.py
+│       ├── buyer.pyi
+│       ├── merchant.py
+│       ├── merchant.pyi
+│       ├── models.py
+│       ├── models.pyi
+│       ├── nostr.py
+│       ├── nostr.pyi
+│       └── py.typed
 ├── tests/            # Test files
 ├── docs/             # Documentation
 ├── examples/         # Example implementations
@@ -52,17 +65,19 @@ agentstr/
 ## Features
 
 ### Current Features
-- Create Merchant agents with Nostr identities
-- Publish and manage merchant products using [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) marketplace protocol
-- Create merchant stalls to organize products
-- Handle shipping zones and costs
-- Secure communication using Nostr keys
+- Create Merchant agents with Nostr identities:
+  - Publish and manage merchant products using [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) marketplace protocol
+  - Create merchant stalls to organize products
+  - Handle shipping zones and costs
+  - Secure communication using Nostr keys
+- Create Buyer agents:
+  - Retrieve a list of sellers from the relay using [NIP-15](https://github.com/nostr-protocol/nips/blob/master/15.md) marketplace protocol
+  - Find an specific seller by name or public key
+  - Refresh the list of sellers from the relay
 
 ### Roadmap
 - [ ] Create marketplace with stalls
-- [ ] Create Buyer agents
-- [ ] Enable merchants to define products
-- [ ] Add customer toolkit for buyers
+- [ ] Expand buyer agent to include more features
 - [ ] Support additional Nostr NIPs
 - [ ] Add more agent interaction patterns
 
@@ -82,46 +97,13 @@ pip install agentstr
 
 You can find example code in the [examples](https://github.com/Synvya/agentstr/tree/main/examples/) directory.
 
-### Instaling the examples
-1. **Clone the repository**
-```bash
-git clone https://github.com/Synvya/agentstr.git
-```
-
-### Basic CLI Example
-A simple command-line interface demonstrating agentstr's merchant capabilities:
-
-
-- [Basic CLI Agent](https://github.com/Synvya/agentstr/tree/main/src/agentstr/examples/basic_cli/main.py) - A complete example showing:
-  - Setting up merchant profiles
-  - Creating stalls with shipping methods
-  - Defining products with shipping costs
-  - Configuring the agent with the merchant toolkit
-  - Running an interactive CLI application
-
-1. ** Create a virtual environment**
-```bash
-cd agentstr/examples/basic_cli
-python3 -m venv venv
-source venv/bin/activate
-```
+To install the examples clone the repository and navigate to the examples directory:
 
-2. ** Install dependencies**
 ```bash
-pip install -r requirements.txt
-```
-
-3. ** Configure your environment**
-```bash
-cp .env.example .env
-```
-**Edit the .env file with your own API keys and Nostr credentials**
-
-4. ** Run the example**
-```bash
-python main.py
+git clone https://github.com/Synvya/agentstr.git
+cd agentstr/examples/
 ```
-
+Each example has its own README with instructions on how to run it.
 
 ## Documentation
 
@@ -140,7 +122,11 @@ This project is licensed under the MIT License - see the [LICENSE](https://githu
 
 ## Acknowledgments
 
-- [Phidata](https://www.phidata.com) - For their AI agent framework
+- [Agno](https://www.agno.ai) - For their AI agent framework
 - [Rust-Nostr](https://rust-nostr.org) - For their Python Nostr SDK
 - [Nostr Protocol](https://github.com/nostr-protocol/nips) - For the protocol specification
 
+This software includes the following software licensed under the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0):
+- [DataStax Python Driver for Apache Cassandra](https://github.com/datastax/python-driver)
+- [cassIO](https://github.com/CassioML/cassio). This library is not maintained anymore. We will need to replace it with a new library.
+

agentstr-0.1.13.dist-info/RECORD

@@ -0,0 +1,15 @@
+agentstr/__init__.py,sha256=rbFtFOldBSbeDX_8Xva3YHRC9c3nPFA9mJXS3UZhJ4s,1294
+agentstr/buyer.py,sha256=I1tApMjlq0Bg5Qk7twcAbF2rf_L5I2L9qzQO5sKv2RE,9912
+agentstr/buyer.pyi,sha256=AqdKa7nQWohxHaoKHjCNpOpDB6rsWGWAlASNhwEw45g,1219
+agentstr/merchant.py,sha256=3Fz4hrxyb5m7Kk47RodNC-Vyjm9iV7bI4ncPF8EMkhw,35078
+agentstr/merchant.pyi,sha256=mqak--H7D_b7o8JNQlQRmov2An-defyBGRJNhMNchXQ,1437
+agentstr/models.py,sha256=lEoopEQYIqI0egVxoXhBLlBh35C0WQmR_oBKm5Sexwk,11423
+agentstr/models.pyi,sha256=k1_D-afE17gybHhtQMqA6cx7H5lYh7Fg0gbXclxyP4A,2857
+agentstr/nostr.py,sha256=u2jDwQDmg01UCThDy1WW9lOPvAHyI1WMbtxFFi_2q08,22703
+agentstr/nostr.pyi,sha256=nlBdOOI6vPboACjBvrQZKHy3BtCjboaClG9ZVD2X8XQ,3118
+agentstr/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentstr-0.1.13.dist-info/LICENSE,sha256=20H0yoEDN5XO1xPXyZCyJjvSTP0YiarRMKWPfiaBhQY,1063
+agentstr-0.1.13.dist-info/METADATA,sha256=JBXZQ5tw7lPrir_3TKkbYYXpLMqHlMofkfdwXKTP6Gk,4667
+agentstr-0.1.13.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+agentstr-0.1.13.dist-info/top_level.txt,sha256=KZObFRHppZvKUGYB_m9w5HhLwps7jj7w6Xrw73dH2ss,9
+agentstr-0.1.13.dist-info/RECORD,,

agentstr-0.1.11.dist-info/RECORD

@@ -1,8 +0,0 @@
-agentstr/__init__.py,sha256=bPXCN4fDtqII9UtDCwhWhkR6bi1LR4w0rR0vGeKPNoI,567
-agentstr/marketplace.py,sha256=CavX0WQaCiz1sQhVs-PaHZ4YYUdcabW5V5eXrhtbT5A,40406
-agentstr/nostr.py,sha256=PId6477VuShPq7nKgansgyJhJNNy9S8ycCf_3niizg4,11242
-agentstr-0.1.11.dist-info/LICENSE,sha256=20H0yoEDN5XO1xPXyZCyJjvSTP0YiarRMKWPfiaBhQY,1063
-agentstr-0.1.11.dist-info/METADATA,sha256=Vd8WUSeuBXcLgutM8deaNa4mxb4tESgAKgjD6gFLJ40,4314
-agentstr-0.1.11.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-agentstr-0.1.11.dist-info/top_level.txt,sha256=KZObFRHppZvKUGYB_m9w5HhLwps7jj7w6Xrw73dH2ss,9
-agentstr-0.1.11.dist-info/RECORD,,