Metadata-Version: 2.4
Name: scaniom
Version: 0.3.2
Summary: Scaniom L2 SDK for machine-speed AI behavior guard, observation and evidence through the Scaniom Node.
Requires-Python: >=3.10
License-Expression: LicenseRef-Proprietary
Description-Content-Type: text/markdown

# scaniom

Scaniom L2 Python SDK. It protects application and agent actions through the same Scaniom Node, policy, Gate and evidence runtime used by the other attachments.

```bash
pip install scaniom
```

```python
import os
from scaniom import Scaniom

scaniom = Scaniom(
    node_url=os.environ["SCANIOM_NODE_URL"],
    workload_id=os.environ["SCANIOM_WORKLOAD_ID"],
    runtime_token=os.environ.get("SCANIOM_RUNTIME_TOKEN"),
)

result = scaniom.guard_action(
    session="session-123",
    action="tool_call",
    target="customer-db",
    text="proposed action",
    execute=perform_action,
)
```

The execution contract is `PRE-GUARD -> ALLOW/BLOCK -> execute -> POST-OBSERVE -> evidence`. Provider credentials do not belong in the SDK. A runtime token is carried when supplied; R16 Slice D does not claim L2 bearer enforcement until the Node guard/observe boundary explicitly enables it.

The package has no third-party runtime dependencies and requires Python 3.10 or newer.
