Metadata-Version: 2.4
Name: copass-management
Version: 0.5.2
Summary: Spec-driven management tool registrar for Copass agents (read-only, Phase 1).
Project-URL: Homepage, https://github.com/olane-labs/copass
Project-URL: Repository, https://github.com/olane-labs/copass.git
Author: Olane Inc.
License: MIT
Keywords: agents,copass,management,mcp,olane
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: copass-core>=0.3.0
Requires-Dist: jsonschema>=4.21
Requires-Dist: pydantic>=2.7
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Description-Content-Type: text/markdown

# copass-management

Spec-driven management tool registrar for Copass agents (Python).

This package consumes the `copass/spec/management/v1/` JSON
Schema corpus and exposes a transport-agnostic registrar that wires
each tool through `copass-core`. An optional MCP adapter lives at
`copass_management.adapters.mcp` for Model Context Protocol consumers.

Phase 1 ships the **read-only subset** (14 tools). Write tools follow
in Phase 2.

## Usage

```python
from copass_core import ApiKeyAuth, CopassClient
from copass_management import (
    RegistrarOptions,
    register_management_tools,
)

client = CopassClient(auth=ApiKeyAuth(key="olk_..."))

def register(registration):
    print(registration.name, registration.description)

register_management_tools(
    register,
    client,
    RegistrarOptions(sandbox_id="sb_..."),
)
```

For MCP transports, use `register_to_mcp_server` from
`copass_management.adapters.mcp`. The MCP SDK is an optional
dependency installed separately.

## Spec source

The package vendors a copy of the JSON Schema corpus under
`copass_management/_spec/v1/`. In dev, set
`COPASS_MANAGEMENT_SPEC_DIR` to point at the source tree.
