Metadata-Version: 2.4
Name: wizelit-sdk
Version: 0.1.26
Summary: Wizelit Agent Wrapper - Internal utility package
Author-email: Your Name <your.email@company.com>
Requires-Python: >=3.10
Requires-Dist: asyncpg>=0.26.0
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: redis>=4.5.0
Requires-Dist: sqlalchemy>=1.4
Requires-Dist: typing-extensions>=4.0.0
Provides-Extra: dev
Requires-Dist: black>=22.0.0; extra == 'dev'
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: streaming
Requires-Dist: redis>=4.5.0; extra == 'streaming'
Description-Content-Type: text/markdown

# wizelit-sdk

Internal utility package for Wizelit Agent operations.

## Installation

### Install from Git Repository

```bash
# Install latest version from main branch
uv pip install git+https://github.com/your-org/wizelit-sdk.git

# Install specific version
uv pip install git+https://github.com/your-org/wizelit-sdk.git@v0.1.0

# Install with SSH (Recommended for Private Repos)
uv pip install git+ssh://git@github.com/your-org/wizelit-sdk.git@v0.1.0
```

### Add to pyproject.toml

```toml
[project]
dependencies = [
    "wizelit-sdk @ git+ssh://git@github.com/your-org/wizelit-sdk.git@v0.1.0"
]
```

## Usage

```python
from wizelit_agent_wrapper import your_module

# Use the wrapper
result = your_module.function()
```

## Configuration

The SDK reads database configuration from the hosting application's environment. Provide these variables in the consuming project (e.g., via your app's .env or deployment secrets):

- POSTGRES_USER
- POSTGRES_PASSWORD
- POSTGRES_HOST
- POSTGRES_PORT
- POSTGRES_DB

You can also supply a full connection string via `DATABASE_URL` (overrides the individual fields). If using streaming/logging with Redis, set `REDIS_HOST`, `REDIS_PORT`, and optionally `REDIS_PASSWORD`.

## Development

### Setup Development Environment

```bash
# Clone repository
git clone https://github.com/your-org/wizelit-sdk.git
cd wizelit-sdk

# Set up environment
make setup

# Activate virtual environment
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install in development mode
make install-dev
```

### Available Make Commands

```bash
make setup          # Set up development environment
make install-dev    # Install in development mode
make test           # Run tests
make format         # Format code with black
make lint           # Lint code with ruff
make check          # Run tests and linting
make clean          # Clean build artifacts
make build          # Build package
make release        # Create new release (interactive)
make tag VERSION=x.x.x  # Create specific version tag
make push           # Push code and tags
make version        # Show current version
make versions       # List all available versions
```

## Contributing

1. Create a feature branch
2. Make your changes
3. Run tests and linting: `make check`
4. Commit your changes
5. Push and create a pull request

## Versioning

We use [Semantic Versioning](https://semver.org/):

- **MAJOR** version for incompatible API changes
- **MINOR** version for new functionality (backward compatible)
- **PATCH** version for bug fixes

See [CHANGELOG.md](CHANGELOG.md) for version history.
