Metadata-Version: 2.4
Name: moss-voice-agent-manager
Version: 1.0.0b3
Summary: Python SDK for managing and deploying voice agents to Moss platform
Home-page: https://github.com/your-org/python-sdk
Author: Moss Team
Author-email: Moss Team <support@moss.com>
License: MIT
Project-URL: Homepage, https://github.com/InferEdge-Inc/moss
Project-URL: Repository, https://github.com/InferEdge-Inc/moss
Project-URL: Changelog, https://github.com/InferEdge-Inc/moss/blob/main/python/moss-voice-sdk/CHANGELOG.md
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: flake8>=4.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# Moss Voice Agent Manager

Python SDK for managing and deploying voice agents using the Moss platform.

## Installation

```bash
pip install moss-voice-agent-manager
```

Or install from source:

```bash
cd python-sdk
pip install -e .
```

## Quick Start

### 1. Get Your Credentials

You need three pieces of information:

1. **MOSS_PROJECT_ID** - Your project UUID
2. **MOSS_PROJECT_KEY** - Your project read key
3. **MOSS_VOICE_AGENT_ID** - Voice agent UUID to deploy to


### 2. Simple Deployment

```python
from moss_voice_agent_manager import MossVoiceClient

# Create client
client = MossVoiceClient(
    project_id="your-project-uuid",
    project_key="your-project-read-key"
)

# Deploy agent
response = client.deploy(
    voice_agent_id="voice-agent-uuid",
    prompt="You are a helpful AI assistant"
)

print(f"Deployed to: {response.deployment_url}")
```

### 3. Deploy with Custom Tools

```python
def get_weather(city: str) -> str:
    """Get weather for a city."""
    return f"Weather in {city} is sunny"

response = client.deploy(
    voice_agent_id="voice-agent-uuid",
    prompt="You are a weather assistant",
    function_tools=[get_weather]
)
```

## Environment Variables

Set these for easier testing:

```bash
export MOSS_PROJECT_ID="your-project-uuid"
export MOSS_PROJECT_KEY="your-project-read-key"
export MOSS_VOICE_AGENT_ID="voice-agent-uuid"
```

## API Reference

### MossVoiceClient

```python
client = MossVoiceClient(
    project_id: str,        # Your Moss project ID (required)
    project_key: str,       # Your Moss project key (required)
    timeout: int            # Request timeout in seconds (default: 300)
)
```

### deploy()

```python
response = client.deploy(
    voice_agent_id: str,        # Voice agent UUID (required)
    prompt: str,                # System prompt (required)
    initial_greeting: str,      # Optional greeting message
    function_tools: List,       # Optional list of Python functions
    tool_refs: List[str],       # Optional importable tool references
    project_name: str           # Optional project name
)
```

Returns `DeploymentResponse`:
- `ok`: bool - Success flag
- `project_name`: str - Project name
- `deployment_url`: str - URL to view in dashboard
- `cli_stdout`: str - Deployment logs
- `cli_stderr`: str - Error logs if any
- `error`: str - Error message if failed

## Requirements

- Python 3.9+
- No external dependencies (uses standard library)

## License

MIT

## Support

For issues and questions, visit: https://github.com/your-org/python-sdk
