simple-agents-py 0.1.0__tar.gz → 0.1.2__tar.gz

{simple_agents_py-0.1.0 → simple_agents_py-0.1.2}/Cargo.lock

@@ -2023,12 +2023,27 @@ dependencies = [
  "libc",
 ]
 
+[[package]]
+name = "simple-agent-type"
+version = "0.1.2"
+dependencies = [
+ "async-trait",
+ "blake3",
+ "futures-core",
+ "rand 0.8.5",
+ "serde",
+ "serde_json",
+ "subtle",
+ "thiserror 1.0.69",
+ "tokio",
+]
+
 [[package]]
 name = "simple-agents-cache"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "async-trait",
- "simple-agents-types",
+ "simple-agent-type",
  "tokio",
 ]
 
@@ -2040,10 +2055,10 @@ dependencies = [
  "serde",
  "serde_json",
  "serde_yaml",
+ "simple-agent-type",
  "simple-agents-core",
  "simple-agents-providers",
  "simple-agents-router",
- "simple-agents-types",
  "thiserror 1.0.69",
  "tokio",
  "toml",
@@ -2051,15 +2066,15 @@ dependencies = [
 
 [[package]]
 name = "simple-agents-core"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "async-trait",
  "serde",
  "serde_json",
+ "simple-agent-type",
  "simple-agents-cache",
  "simple-agents-healing",
  "simple-agents-router",
- "simple-agents-types",
  "tokio",
 ]
 
@@ -2070,9 +2085,9 @@ dependencies = [
  "dotenv",
  "futures-util",
  "serde_json",
+ "simple-agent-type",
  "simple-agents-healing",
  "simple-agents-providers",
- "simple-agents-types",
  "tokio",
 ]
 
@@ -2081,9 +2096,9 @@ name = "simple-agents-ffi"
 version = "0.1.0"
 dependencies = [
  "async-trait",
+ "simple-agent-type",
  "simple-agents-core",
  "simple-agents-providers",
- "simple-agents-types",
  "tokio",
 ]
 
@@ -2096,8 +2111,8 @@ dependencies = [
  "regex",
  "serde",
  "serde_json",
+ "simple-agent-type",
  "simple-agents-macros",
- "simple-agents-types",
  "thiserror 1.0.69",
  "tokio",
  "tracing",
@@ -2111,7 +2126,7 @@ dependencies = [
  "quote",
  "serde",
  "serde_json",
- "simple-agents-types",
+ "simple-agent-type",
  "syn",
 ]
 
@@ -2121,9 +2136,9 @@ version = "0.1.0"
 dependencies = [
  "napi",
  "napi-derive",
+ "simple-agent-type",
  "simple-agents-core",
  "simple-agents-providers",
- "simple-agents-types",
  "tokio",
 ]
 
@@ -2140,13 +2155,14 @@ dependencies = [
  "governor",
  "metrics",
  "metrics-exporter-prometheus",
+ "pin-project-lite",
  "reqwest",
  "serde",
  "serde_json",
+ "simple-agent-type",
  "simple-agents-cache",
  "simple-agents-healing",
  "simple-agents-macros",
- "simple-agents-types",
  "thiserror 2.0.17",
  "tokio",
  "tokio-test",
@@ -2156,38 +2172,23 @@ dependencies = [
 
 [[package]]
 name = "simple-agents-py"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "pyo3",
+ "simple-agent-type",
  "simple-agents-core",
  "simple-agents-providers",
- "simple-agents-types",
  "tokio",
 ]
 
 [[package]]
 name = "simple-agents-router"
-version = "0.1.0"
-dependencies = [
- "async-trait",
- "rand 0.8.5",
- "serde_json",
- "simple-agents-types",
- "tokio",
-]
-
-[[package]]
-name = "simple-agents-types"
-version = "0.1.0"
+version = "0.1.2"
 dependencies = [
  "async-trait",
- "blake3",
- "futures-core",
  "rand 0.8.5",
- "serde",
  "serde_json",
- "subtle",
- "thiserror 1.0.69",
+ "simple-agent-type",
  "tokio",
 ]
 

{simple_agents_py-0.1.0 → simple_agents_py-0.1.2}/Cargo.toml

@@ -3,11 +3,14 @@ members = ["crates/*"]
 resolver = "2"
 
 [workspace.package]
-version = "0.1.0"
+version = "0.1.2"
 edition = "2021"
 rust-version = "1.75"
 authors = ["SimpleAgents Contributors"]
 license = "MIT OR Apache-2.0"
+repository = "https://github.com/rishub/simple-agents"
+homepage = "https://github.com/rishub/simple-agents"
+documentation = "https://docs.rs/simple-agent-type"
 
 [workspace.dependencies]
 serde = { version = "1.0", features = ["derive"] }

simple_agents_py-0.1.2/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: simple-agents-py
+Version: 0.1.2
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Dist: pytest>=8.0 ; extra == 'dev'
+Provides-Extra: dev
+Summary: Python bindings for SimpleAgents
+License: MIT OR Apache-2.0
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# simple-agents-py
+
+[![PyPI](https://img.shields.io/pypi/v/simple-agents-py)](https://pypi.org/project/simple-agents-py/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/simple-agents-py)](https://pypi.org/project/simple-agents-py/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/simple-agents-py)](https://pypi.org/project/simple-agents-py/)
+[![License](https://img.shields.io/pypi/l/simple-agents-py)](https://pypi.org/project/simple-agents-py/)
+
+Python bindings for SimpleAgents (PyO3-based).
+
+## Installation
+
+Install from [PyPI](https://pypi.org/project/simple-agents-py/):
+
+```sh
+pip install simple-agents-py
+```
+
+Or with uv:
+
+```sh
+uv pip install simple-agents-py
+```
+
+## Build from Source
+
+```sh
+uv build
+```
+
+## Publish
+
+```sh
+uv publish
+```
+
+Set `UV_PUBLISH_TOKEN` or pass `--token` to publish to PyPI.
+
+## Usage
+
+```python
+from simple_agents_py import Client
+
+client = Client("openai")
+response = client.complete("gpt-4", "Hello from Python!", max_tokens=128, temperature=0.7)
+print(response)
+```
+
+## Examples
+
+OpenAI with a short prompt:
+
+```python
+from simple_agents_py import Client
+
+client = Client("openai")
+text = client.complete("gpt-4o-mini", "Summarize this in one sentence.")
+print(text)
+```
+
+Anthropic with custom tokens and temperature:
+
+```python
+from simple_agents_py import Client
+
+client = Client("anthropic")
+text = client.complete(
+    "claude-3-5-sonnet-20240620",
+    "Write a friendly welcome message for a new user.",
+    max_tokens=120,
+    temperature=0.5,
+)
+print(text)
+```
+
+OpenRouter with a specific model:
+
+```python
+from simple_agents_py import Client
+
+client = Client("openrouter")
+text = client.complete("openai/gpt-4o-mini", "Give me three project ideas.")
+print(text)
+```
+
+OpenRouter with explicit API base and key:
+
+```python
+from simple_agents_py import Client
+
+client = Client(
+    "openrouter",
+    api_base="https://openrouter.ai/api/v1",
+    api_key="sk-your-openrouter-key",
+)
+text = client.complete("openai/gpt-4o-mini", "Give me three project ideas.")
+print(text)
+```
+
+OpenAI with a custom gateway:
+
+```python
+from simple_agents_py import Client
+
+client = Client(
+    "openai",
+    api_base="http://localhost:4000/v1",
+    api_key="sk-your-openai-key",
+)
+text = client.complete("gpt-4o-mini", "Say hello from a local proxy.")
+print(text)
+```
+
+Basic error handling:
+
+```python
+from simple_agents_py import Client
+
+try:
+    client = Client("openai")
+    print(client.complete("gpt-4o-mini", "Hello!"))
+except RuntimeError as exc:
+    print(f"Request failed: {exc}")
+```
+
+## Notes
+
+- `Client` reads provider configuration from environment variables (e.g. `OPENAI_API_KEY`) when `api_key` is not provided.
+- `api_base` lets you override the default API base URL.
+- `max_tokens` and `temperature` are optional.
+
+## Tests
+
+```sh
+uv pip install -e .[dev]
+uv run pytest
+```
+
+## Package Metrics & Analytics
+
+### Download Statistics
+
+View download statistics on:
+- **PyPI Stats**: [https://pypistats.org/packages/simple-agents-py](https://pypistats.org/packages/simple-agents-py)
+- **PePy**: [https://pepy.tech/project/simple-agents-py](https://pepy.tech/project/simple-agents-py)
+- **PyPI Package Page**: [https://pypi.org/project/simple-agents-py/](https://pypi.org/project/simple-agents-py/)
+
+The badges above automatically track:
+- **Version**: Current version on PyPI
+- **Downloads**: Monthly download count
+- **Python Versions**: Supported Python versions
+- **License**: Package license
+
+### Tracking with shields.io
+
+The badges use [shields.io](https://shields.io/) which automatically fetches data from PyPI. Available metrics:
+- `pypi/v/simple-agents-py` - Latest version
+- `pypi/dm/simple-agents-py` - Monthly downloads
+- `pypi/dw/simple-agents-py` - Weekly downloads
+- `pypi/dd/simple-agents-py` - Daily downloads
+- `pypi/pyversions/simple-agents-py` - Python version support
+- `pypi/l/simple-agents-py` - License
+- `pypi/status/simple-agents-py` - Development status
+- `pypi/format/simple-agents-py` - Package format (wheel/sdist)
+
+### Optional Badges (for future)
+
+Once you set up CI/CD and documentation, you can add:
+
+```markdown
+<!-- GitHub Actions build status -->
+[![Build](https://github.com/yourusername/SimpleAgents/actions/workflows/python.yml/badge.svg)](https://github.com/yourusername/SimpleAgents/actions/workflows/python.yml)
+
+<!-- Documentation -->
+[![Docs](https://img.shields.io/badge/docs-latest-blue)](https://simpleagents.readthedocs.io/)
+
+<!-- Code coverage -->
+[![Coverage](https://codecov.io/gh/yourusername/SimpleAgents/branch/main/graph/badge.svg)](https://codecov.io/gh/yourusername/SimpleAgents)
+
+<!-- GitHub stats -->
+[![GitHub stars](https://img.shields.io/github/stars/yourusername/SimpleAgents?style=social)](https://github.com/yourusername/SimpleAgents)
+[![GitHub forks](https://img.shields.io/github/forks/yourusername/SimpleAgents?style=social)](https://github.com/yourusername/SimpleAgents/fork)
+```
+

simple_agents_py-0.1.2/README.md

@@ -0,0 +1,182 @@
+# simple-agents-py
+
+[![PyPI](https://img.shields.io/pypi/v/simple-agents-py)](https://pypi.org/project/simple-agents-py/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/simple-agents-py)](https://pypi.org/project/simple-agents-py/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/simple-agents-py)](https://pypi.org/project/simple-agents-py/)
+[![License](https://img.shields.io/pypi/l/simple-agents-py)](https://pypi.org/project/simple-agents-py/)
+
+Python bindings for SimpleAgents (PyO3-based).
+
+## Installation
+
+Install from [PyPI](https://pypi.org/project/simple-agents-py/):
+
+```sh
+pip install simple-agents-py
+```
+
+Or with uv:
+
+```sh
+uv pip install simple-agents-py
+```
+
+## Build from Source
+
+```sh
+uv build
+```
+
+## Publish
+
+```sh
+uv publish
+```
+
+Set `UV_PUBLISH_TOKEN` or pass `--token` to publish to PyPI.
+
+## Usage
+
+```python
+from simple_agents_py import Client
+
+client = Client("openai")
+response = client.complete("gpt-4", "Hello from Python!", max_tokens=128, temperature=0.7)
+print(response)
+```
+
+## Examples
+
+OpenAI with a short prompt:
+
+```python
+from simple_agents_py import Client
+
+client = Client("openai")
+text = client.complete("gpt-4o-mini", "Summarize this in one sentence.")
+print(text)
+```
+
+Anthropic with custom tokens and temperature:
+
+```python
+from simple_agents_py import Client
+
+client = Client("anthropic")
+text = client.complete(
+    "claude-3-5-sonnet-20240620",
+    "Write a friendly welcome message for a new user.",
+    max_tokens=120,
+    temperature=0.5,
+)
+print(text)
+```
+
+OpenRouter with a specific model:
+
+```python
+from simple_agents_py import Client
+
+client = Client("openrouter")
+text = client.complete("openai/gpt-4o-mini", "Give me three project ideas.")
+print(text)
+```
+
+OpenRouter with explicit API base and key:
+
+```python
+from simple_agents_py import Client
+
+client = Client(
+    "openrouter",
+    api_base="https://openrouter.ai/api/v1",
+    api_key="sk-your-openrouter-key",
+)
+text = client.complete("openai/gpt-4o-mini", "Give me three project ideas.")
+print(text)
+```
+
+OpenAI with a custom gateway:
+
+```python
+from simple_agents_py import Client
+
+client = Client(
+    "openai",
+    api_base="http://localhost:4000/v1",
+    api_key="sk-your-openai-key",
+)
+text = client.complete("gpt-4o-mini", "Say hello from a local proxy.")
+print(text)
+```
+
+Basic error handling:
+
+```python
+from simple_agents_py import Client
+
+try:
+    client = Client("openai")
+    print(client.complete("gpt-4o-mini", "Hello!"))
+except RuntimeError as exc:
+    print(f"Request failed: {exc}")
+```
+
+## Notes
+
+- `Client` reads provider configuration from environment variables (e.g. `OPENAI_API_KEY`) when `api_key` is not provided.
+- `api_base` lets you override the default API base URL.
+- `max_tokens` and `temperature` are optional.
+
+## Tests
+
+```sh
+uv pip install -e .[dev]
+uv run pytest
+```
+
+## Package Metrics & Analytics
+
+### Download Statistics
+
+View download statistics on:
+- **PyPI Stats**: [https://pypistats.org/packages/simple-agents-py](https://pypistats.org/packages/simple-agents-py)
+- **PePy**: [https://pepy.tech/project/simple-agents-py](https://pepy.tech/project/simple-agents-py)
+- **PyPI Package Page**: [https://pypi.org/project/simple-agents-py/](https://pypi.org/project/simple-agents-py/)
+
+The badges above automatically track:
+- **Version**: Current version on PyPI
+- **Downloads**: Monthly download count
+- **Python Versions**: Supported Python versions
+- **License**: Package license
+
+### Tracking with shields.io
+
+The badges use [shields.io](https://shields.io/) which automatically fetches data from PyPI. Available metrics:
+- `pypi/v/simple-agents-py` - Latest version
+- `pypi/dm/simple-agents-py` - Monthly downloads
+- `pypi/dw/simple-agents-py` - Weekly downloads
+- `pypi/dd/simple-agents-py` - Daily downloads
+- `pypi/pyversions/simple-agents-py` - Python version support
+- `pypi/l/simple-agents-py` - License
+- `pypi/status/simple-agents-py` - Development status
+- `pypi/format/simple-agents-py` - Package format (wheel/sdist)
+
+### Optional Badges (for future)
+
+Once you set up CI/CD and documentation, you can add:
+
+```markdown
+<!-- GitHub Actions build status -->
+[![Build](https://github.com/yourusername/SimpleAgents/actions/workflows/python.yml/badge.svg)](https://github.com/yourusername/SimpleAgents/actions/workflows/python.yml)
+
+<!-- Documentation -->
+[![Docs](https://img.shields.io/badge/docs-latest-blue)](https://simpleagents.readthedocs.io/)
+
+<!-- Code coverage -->
+[![Coverage](https://codecov.io/gh/yourusername/SimpleAgents/branch/main/graph/badge.svg)](https://codecov.io/gh/yourusername/SimpleAgents)
+
+<!-- GitHub stats -->
+[![GitHub stars](https://img.shields.io/github/stars/yourusername/SimpleAgents?style=social)](https://github.com/yourusername/SimpleAgents)
+[![GitHub forks](https://img.shields.io/github/forks/yourusername/SimpleAgents?style=social)](https://github.com/yourusername/SimpleAgents/fork)
+```

{simple_agents_py-0.1.0/crates/simple-agents-types → simple_agents_py-0.1.2/crates/simple-agent-type}/Cargo.toml

@@ -1,10 +1,13 @@
 [package]
-name = "simple-agents-types"
+name = "simple-agent-type"
 version.workspace = true
 edition.workspace = true
 rust-version.workspace = true
 authors.workspace = true
 license.workspace = true
+repository.workspace = true
+homepage.workspace = true
+documentation.workspace = true
 description = "Core types and traits for SimpleAgents"
 readme = "README.md"
 

{simple_agents_py-0.1.0/crates/simple-agents-types → simple_agents_py-0.1.2/crates/simple-agent-type}/README.md

@@ -1,10 +1,10 @@
-# simple-agents-types
+# simple-agent-type
 
 Core types and traits for the SimpleAgents LLM framework.
 
 ## Overview
 
-`simple-agents-types` is the foundational crate of SimpleAgents, providing all core types, traits, and error definitions. It has **zero runtime dependencies** - no HTTP client, no I/O, no async runtime - just pure types and traits.
+`simple-agent-type` is the foundational crate of SimpleAgents, providing all core types, traits, and error definitions. It has **zero runtime dependencies** - no HTTP client, no I/O, no async runtime - just pure types and traits.
 
 ## Features
 
@@ -26,7 +26,7 @@ SimpleAgents follows a trait-based architecture with three main traits:
 ## Quick Start
 
 ```rust
-use simple_agents_types::prelude::*;
+use simple_agent_type::prelude::*;
 
 // Create a request
 let request = CompletionRequest::builder()
@@ -46,7 +46,7 @@ assert_eq!(request.messages.len(), 1);
 ### Messages
 
 ```rust
-use simple_agents_types::message::{Message, Role};
+use simple_agent_type::message::{Message, Role};
 
 let user_msg = Message::user("What is 2+2?");
 let assistant_msg = Message::assistant("4");
@@ -56,8 +56,8 @@ let system_msg = Message::system("You are a helpful assistant.");
 ### Requests
 
 ```rust
-use simple_agents_types::request::CompletionRequest;
-use simple_agents_types::message::Message;
+use simple_agent_type::request::CompletionRequest;
+use simple_agent_type::message::Message;
 
 let request = CompletionRequest::builder()
     .model("gpt-4")
@@ -70,7 +70,7 @@ let request = CompletionRequest::builder()
 ### Responses
 
 ```rust
-use simple_agents_types::response::CompletionResponse;
+use simple_agent_type::response::CompletionResponse;
 
 // Get the first completion's content
 if let Some(content) = response.content() {
@@ -81,7 +81,7 @@ if let Some(content) = response.content() {
 ### Error Handling
 
 ```rust
-use simple_agents_types::error::{SimpleAgentsError, ProviderError};
+use simple_agent_type::error::{SimpleAgentsError, ProviderError};
 
 match result {
     Ok(response) => println!("{}", response.content().unwrap()),
@@ -95,7 +95,7 @@ match result {
 ### API Key Security
 
 ```rust
-use simple_agents_types::validation::ApiKey;
+use simple_agent_type::validation::ApiKey;
 
 let key = ApiKey::new("sk-...")?;
 
@@ -109,7 +109,7 @@ let raw_key = key.expose(); // Use for API calls only
 ### Coercion Tracking
 
 ```rust
-use simple_agents_types::coercion::{CoercionResult, CoercionFlag};
+use simple_agent_type::coercion::{CoercionResult, CoercionFlag};
 
 let result = CoercionResult::new(42)
     .with_flag(CoercionFlag::StrippedMarkdown)
@@ -138,7 +138,7 @@ if result.was_coerced() {
 ### Provider Trait
 
 ```rust
-use simple_agents_types::provider::Provider;
+use simple_agent_type::provider::Provider;
 use async_trait::async_trait;
 
 #[async_trait]
@@ -162,7 +162,7 @@ impl Provider for MyProvider {
 ### Cache Trait
 
 ```rust
-use simple_agents_types::cache::Cache;
+use simple_agent_type::cache::Cache;
 use async_trait::async_trait;
 
 #[async_trait]
@@ -177,7 +177,7 @@ impl Cache for MyCache {
 ### RoutingStrategy Trait
 
 ```rust
-use simple_agents_types::router::RoutingStrategy;
+use simple_agent_type::router::RoutingStrategy;
 use async_trait::async_trait;
 
 #[async_trait]
@@ -230,7 +230,7 @@ MIT OR Apache-2.0
 
 ## Next Steps
 
-After `simple-agents-types`, the next crates to implement are:
+After `simple-agent-type`, the next crates to implement are:
 
 1. `simple-agents-providers` - OpenAI, Anthropic, etc.
 2. `simple-agents-healing` - JSON parser with coercion