Metadata-Version: 2.4
Name: proxima-sdk
Version: 1.0.5
Summary: Proxima AIP SDK — build AI agents on the Proxima Intelligence platform
Project-URL: Homepage, https://proximaintel.com/aip
Project-URL: Documentation, https://docs.proximaintel.com/sdk
Project-URL: Repository, https://github.com/proximaintel/proxima-sdk
Author-email: Proxima Intelligence <hello@proximaintel.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,aip,enterprise,platform,proxima
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# Proxima SDK

The official Python SDK for building AI agents on the **Proxima AIP** platform.

## Install

```bash
pip install proxima-sdk
```

## Quick Start

```python
from proxima_sdk import PlatformContext

def my_tool(params: dict, ctx: PlatformContext) -> dict:
    # Access knowledge bases
    data = ctx.knowledge.query("What invoices are overdue?")
    
    # Log actions for governance
    ctx.governance.log_action("queried_invoices")
    
    return {"answer": data.answer, "citations": data.citations}
```

## Testing

```python
from proxima_sdk.testing import mock_context

ctx = mock_context(sources={"invoices": [{"id": "INV-001", "amount": 5000}]})
result = my_tool({"query": "overdue"}, ctx)
```

## Documentation

Full docs at [docs.proximaintel.com/sdk](https://docs.proximaintel.com/sdk)
