Metadata-Version: 2.5
Name: maivn-tools
Version: 2.0.0
Summary: Optional tool integrations for mAIvn Platform v2.
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Requires-Python: >=3.12
Requires-Dist: maivn-contracts<0.2,>=0.1.0
Requires-Dist: maivn<3,>=2.0.0
Requires-Dist: openpyxl>=3.1
Requires-Dist: pillow>=10
Requires-Dist: pydantic>=2.13.5
Requires-Dist: python-docx>=1.0
Requires-Dist: python-pptx>=1.0
Requires-Dist: reportlab>=4.2
Provides-Extra: all
Requires-Dist: openpyxl>=3.1; extra == 'all'
Requires-Dist: psycopg[binary]>=3.1; extra == 'all'
Requires-Dist: pypdf>=6.18.1; extra == 'all'
Requires-Dist: python-docx>=1.0; extra == 'all'
Requires-Dist: python-pptx>=1.0; extra == 'all'
Requires-Dist: reportlab>=4.2; extra == 'all'
Provides-Extra: docx
Requires-Dist: python-docx>=1.0; extra == 'docx'
Provides-Extra: html
Provides-Extra: pdf
Requires-Dist: pypdf>=6.18.1; extra == 'pdf'
Requires-Dist: reportlab>=4.2; extra == 'pdf'
Provides-Extra: postgres
Requires-Dist: psycopg[binary]>=3.1; extra == 'postgres'
Provides-Extra: presentations
Requires-Dist: python-pptx>=1.0; extra == 'presentations'
Provides-Extra: workbooks
Requires-Dist: openpyxl>=3.1; extra == 'workbooks'
Description-Content-Type: text/markdown

# maivn-tools

`maivn-tools` provides connector toolsets, generic API adapters, file helpers,
and an HTTP runtime for the [mAIvn Python SDK](https://maivn.io).

> **Pre-release software.** Most provider connectors are covered by offline
> contract tests but have not yet been exercised end to end against live
> provider accounts. Test the exact operations and permissions you plan to use
> before relying on a connector with production data.

## Install

```bash
pip install maivn-tools
```

The package installs `maivn` as a direct dependency. Provider credentials stay
in the caller's process; use the authentication and secret-resolver APIs rather
than putting credentials in prompts, tool metadata, or source code.

## Start here

- [Quickstart](docs/quickstart.md)
- [Toolset authoring](docs/toolsets.md)
- [Authentication and secrets](docs/auth.md)
- [Permissions and dry runs](docs/permissions.md)
- [Connector catalog](docs/index.md#connectors-by-category)

The package exports more than 170 toolsets. Register only the tools and
permissions needed for a workflow, and exclude destructive tools when the
application does not need them.

```python
from pathlib import Path

from maivn import Agent
from maivn_tools import LocalFilesToolSet

workspace = Path('./documents')
workspace.mkdir(exist_ok=True)

agent = Agent(name='Document reviewer')
agent.add_toolset(LocalFilesToolSet(workspace), include_tags=['read'])
```

See each connector page for its constructor, provider scopes, pagination,
write behavior, and current validation limits.
