Metadata-Version: 2.5
Name: katsoft-contracts
Version: 1.0.0
Summary: Standard-library-only shared contracts of the plugins-kit marketplace: the execution-event envelope, the interrupt contract and the model declaration parser
Project-URL: Source, https://github.com/kitaekatt/plugins-kit/tree/katsoft-contracts-v1.0.0
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# katsoft-contracts

Standard-library-only contracts shared by the plugins-kit marketplace:

- `katsoft_contracts.execution_event` -- the execution-event envelope (schema
  revisions v1 to v3), validation, emitters and JSONL sinks.
- `katsoft_contracts.interrupt_contract` -- the interrupt request and
  resolution contract. The schema validator is passed in by the caller.
- `katsoft_contracts.model_declaration` -- the structural parser for a model
  declaration.

The package has no dependencies and imports nothing outside the standard
library.

```python
from katsoft_contracts import model_declaration

model_declaration.parse(["opus", "sonnet"])  # ['opus', 'sonnet']
```

## Source

The canonical source lives in this directory. The marketplace's bootstrap
library keeps byte copies of the three modules, refreshed from here with
`scripts/sync_contracts_copy.py` in the plugins-kit repository.

Releases are tagged `katsoft-contracts-v<version>` in the repository named by
the `Source` project URL.
